插件弃用政策

Grafana 由庞大的工程师、SRE 和其他专业人士社区维护。Grafana 插件目录包含各种数据源、面板和应用程序插件 - 其中许多是由社区成员开源开发的。

随着时间的推移，这些开发者并非总能持续维护插件。因此，如果插件不符合我们关于安全性、质量和兼容性的标准，Grafana Labs 可能会通过弃用将其从列表中移除。插件被弃用的原因包括但不限于：

• 发现关键或高危漏洞。
• 发现插件包含恶意代码。
• 插件不再与任何当前支持的 Grafana 版本兼容。
• 插件没有显示维护迹象 - 没有更新，没有响应问题。
• 对于商业插件，与该合作伙伴的协议已失效或不再有效。

关于插件弃用的任何问题，请联系 integrations@grafana.com。

常见问题

插件被弃用意味着什么？

弃用的插件不再出现在 插件目录 或 Grafana > Administration > Plugins 中的搜索结果中。

插件可以从目录中访问和下载，但访问者必须通过直接链接才能访问该页面，并且会显示一个警告横幅，说明该插件已弃用（示例）。插件仍然可以通过 CLI 安装。

已安装的插件不受此弃用影响 - 它们将继续正常加载和运行。但是，将向用户显示警告消息，以指示已弃用状态并建议迁移。

弃用的插件会收到更新吗？

不能保证已弃用的插件会收到任何进一步的更新。

Grafana Labs 开发的插件将在插件的弃用声明中指定的有限时间内接收安全更新。

如果插件被弃用，插件开发者如何收到通知？

当插件面临弃用风险或已决定弃用插件时，integrations@grafana.com 将通过插件发布所在的 Grafana Cloud 组织关联的电子邮件地址联系作者。

在特殊情况下，例如存在关键漏洞或重大 bug，Grafana Labs 可能会在通知开发者之前弃用并从列表中移除插件。

如果插件被弃用，用户如何收到通知？

插件被弃用后，它不再出现在 grafana.com 上的目录搜索结果中或 Administration > Plugins 视图中。如果插件已经安装，则在查看插件时会显示警告图标和消息。

我使用的插件被弃用了。我该怎么办？

我们建议尽快从已弃用的插件迁移。

在插件详情页面 Administration > Plugins > Plugin_Name 查看插件的弃用消息，以确定采取任何行动的紧迫性以及是否有建议的迁移路径。

如果未提供迁移建议，请浏览目录查找潜在的类似解决方案，或者考虑 Fork 当前插件和/或创建新插件。

作为插件开发者，我难以继续维护我的插件。我该怎么办？

我们理解，优先级会发生变化，您可以花在贡献开源项目上的时间也会发生变化。

确保您的插件宣传用户如何参与进来。我们建议所有插件都这样做，因为它会鼓励额外的支持者和维护者。在您的 Readme 文件中，提供以下相关链接或信息：

用户如何参与 - 例如通过代码贡献、bug 报告或功能请求。开发者如何在本地运行插件以便轻松测试任何建议的更改。用户如何帮助资助维护，例如通过 GitHub 赞助。

另一种选择是通过在 Readme 文件顶部创建横幅，以及在我们的社区论坛中宣传，表明该项目正在寻找维护者甚至新的所有者（见下文）。

如果您无法维护插件并认为最好限制进一步采用，请请求将其弃用并从目录中删除（见下文）。

作为插件开发者，我可以将插件的所有权转移给新的开发者吗？

如果您不再希望维护插件并且已确定新所有者，则可以转移所有权。

请通过 integrations@grafana.com 联系 Grafana，以便我们为您介绍各种选项和流程。

作为插件开发者，我可以请求将我的插件弃用并从目录中删除吗？

使用与插件关联的 Grafana Cloud 账户提交支持请求，即 https://grafana.org.cn/orgs/<YOUR_ORG>/tickets/new，主题选择 Plugin Signing。在工单中提供您想要弃用的插件以及原因的详细信息。Grafana Labs 将审查请求并力争在一个工作日内回复。