grafana/plugin-builds

Grafana插件测试镜像文档

镜像概述

本镜像为Grafana插件开发者提供专用测试环境，基于官方Grafana构建版本优化，专注于简化插件开发流程，支持插件的本地测试、兼容性验证和功能调试，适合插件开发全生命周期的测试需求。

核心功能与特性

• 插件热重载：支持本地插件代码修改后自动重载，无需重启容器即可实时查看效果
• 开发优化：内置插件开发工具链，简化插件打包、签名验证流程
• 版本兼容：提供多Grafana版本标签，支持测试插件在不同Grafana版本上的兼容性
• 调试增强：默认开启详细调试日志，支持插件性能分析和错误追踪
• 配置灵活：通过环境变量快速配置Grafana参数，无需修改配置文件

使用场景

• 插件开发者本地测试插件功能与UI交互
• 验证插件在不同Grafana版本下的兼容性
• 调试插件加载、渲染、数据处理等核心逻辑
• 自动化测试流程中作为插件功能验证的运行环境
• 插件性能基准测试与资源占用评估

使用方法

基本运行命令

bash
docker run -d -p 3000:3000 --name grafana-plugin-test grafana/plugin-test

挂载本地插件目录

将本地开发的插件目录挂载到容器内Grafana插件目录，实现热重载：

bash
docker run -d -p 3000:3000 \
  -v /path/to/your/plugin:/var/lib/grafana/plugins/your-plugin \
  -e GF_PLUGINS_ALLOW_LOADING_UNSIGNED=your-plugin \
  grafana/plugin-test

环境变量配置

常用环境变量说明：

• GF_PLUGINS_ALLOW_LOADING_UNSIGNED: 允许加载的未签名插件ID（必填，多个用逗号分隔）
• GF_LOG_LEVEL: 日志级别，可选值：debug, info, warn, error（默认：debug）
• GF_SERVER_HTTP_PORT: HTTP服务端口（默认：3000）
• GF_PLUGIN_DEV_MODE: 启用插件开发模式（默认：true）
• GF_AUTH_ANONYMOUS_ENABLED: 启用***访问（默认：true，便于测试）

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  grafana-test:
    image: grafana/plugin-test
    ports:
      - "3000:3000"
    volumes:
      - ./your-plugin:/var/lib/grafana/plugins/your-plugin
    environment:
      - GF_PLUGINS_ALLOW_LOADING_UNSIGNED=your-plugin
      - GF_LOG_LEVEL=debug
      - GF_AUTH_ANONYMOUS_ENABLED=true
    restart: unless-stopped

启动服务：docker-compose up -d

配置参数详解

注意事项

• 本镜像仅用于开发测试环境，不建议用于生产部署
• 插件目录挂载时需确保本地目录权限正确（容器内用户ID通常为472）
• 不同Grafana版本的插件API可能存在差异，建议使用与目标环境一致的镜像标签
• 调试时可通过docker logs <container-id>查看详细日志输出