跳到主要内容

CLI 命令

您可以在下面找到 @grafana/create-plugin 中可用的命令。

create-plugin

使用 create-plugin 命令来搭建您的插件。

npx @grafana/create-plugin@latest

当运行 create-plugin 命令时,会出现以下提示

选择插件类型

? Select a plugin type …
❯ App (add custom pages, UI extensions and bundle other plugins)
Data source (query data from a custom source)
Panel (add a visualization for data or a widget)
App with Scenes (create dynamic dashboards in app pages)

要了解有关各种插件类型的更多信息,请参阅 Grafana 插件类型和用法

有关 Scenes 如何允许您在应用程序插件中创建类似仪表板体验的更多信息,请参阅 Scenes 文档。

添加后端以支持服务器端功能吗? (y/N)

如果您正在创建应用程序或数据源插件,系统将询问您是否还需要添加后端组件。

后端插件提供强大的功能,例如

  • 为数据源启用 Grafana 告警
  • 连接到浏览器通常无法连接的非 HTTP 服务。例如,SQL 数据库服务器。
  • 在用户之间保持状态。例如,数据源的查询缓存。
  • 使用 Grafana 中不支持的自定义身份验证方法和/或授权检查。
  • 使用自定义数据源请求代理。

要了解更多信息,请参阅 后端插件

输入插件的名称

给您的插件命名,以便于识别其用途。

输入您的组织名称(通常是您的 Grafana Cloud 组织)

输入您的组织名称。这必须是您的 Grafana Cloud 组织。使用组织名称,您可以签名,并可选择发布插件到 Grafana 插件目录

绕过提示

您可以使用 create-plugin CLI 参数绕过所有前面的提示。要使用 CLI 参数搭建插件,请像这样将它们传递给 create-plugin 命令

npx @grafana/create-plugin \
--plugin-type="app" \
--plugin-name="myPlugin" \
--org-name="myorg" \
--backend

您可以使用 CLI 参数搭建插件,以更快地开始使用。使用参数还允许您在非交互式环境(如 CI)中运行该工具,或使用其他工具搭建插件。

有关提示绕过选项的完整列表,请参阅下表

提示等效参数名称
插件类型--plugin-typeappdatasourcepanelscenesapp 之一
后端--backend / --no-backend布尔值
名称--plugin-name字符串
组织--org-name字符串

更新

要更新现有插件以使用最新版本的 create-plugin 工具,请从插件的根目录运行以下命令

npx @grafana/create-plugin@latest update

此命令更新以下内容

  • /.config - 用于构建插件的配置文件
  • NPM 依赖项 - 依赖项(主要用于支持最新的 Grafana 版本和构建更新)
  • NPM 脚本 - 构建相关脚本中的任何更新

update --force

默认情况下,如果存储库中有任何未提交的更改,update 命令将停止。如果要强制更新,可以使用 --force 标志

npx @grafana/create-plugin@latest update --force