Angular 到 React:针对旧版本
Angular 插件通常拥有庞大的安装基础以及运行旧版本 Grafana 的用户。
本文档就如何针对旧版本(甚至是不受支持的版本)提供通用指南,从而允许用户根据需要迁移到较新版本的 Grafana。
最可靠的最低版本是 8.4.11
和 9.3.16
,具体取决于使用了多少 UI 组件。
当使用 create-plugin
实用程序时,无论是更新现有插件还是迁移,软件包列表通常都会包含最新版本的 Grafana。要为旧版本的 Grafana 提供插件,只需将 dependencies
和 devDependencies
设置为与旧版本匹配即可。
针对 v8.4
polystat 面板能够针对 v8.4.11,因为它使用的 UI 组件非常少。它还使用了最新的 plugin-e2e 包和最新的 plugin-tools 配置。
"dependencies": {
"@grafana/data": "8.4.11",
"@grafana/runtime": "8.4.11",
"@grafana/schema": "10.3.3",
"@grafana/ui": "8.4.11",
"react": "17.0.2",
"react-dom": "17.0.2",
"react-redux": "7.2.6",
...
}
更新 src/plugin.json
文件以对应相同的版本
"dependencies": {
"grafanaVersion": "8.4.x",
"grafanaDependency": ">=8.4.11"
}
针对 v9.3
由于旧版本中没有可用的数据转换,D3 Gauge 面板必须至少针对 v9.3.16。它还使用了最新的 plugin-tools 配置,包括 git 工作流程和 webpack 设置。
"dependencies": {
"@grafana/data": "9.3.16",
"@grafana/runtime": "9.3.16",
"@grafana/ui": "9.3.16",
"react": "17.0.2",
"react-dom": "17.0.2",
...
}
更新 src/plugin.json
文件以对应相同的版本
"dependencies": {
"grafanaVersion": "9.3.x",
"grafanaDependency": ">=9.3.16"
}
特别说明
务必使用最低版本和当前版本之间的所有版本测试插件,以确保不会发生崩溃。
其他资源
这些面板针对旧版本的 Grafana,并在最新版本中也能正常运行。