grafana/drone-grafana-docker

Drone Grafana镜像构建发布插件

镜像概述

该镜像为Drone CI/CD平台专用插件，旨在自动化完成Grafana镜像的构建与发布流程。通过集成到Drone流水线中，可实现从Grafana版本指定、配置定制到镜像构建、测试及推送至容器仓库的全流程自动化，简化Grafana定制化部署和版本管理。

核心功能与特性

• 自动化构建流程：支持基于指定Grafana版本自动拉取源码/基础镜像，完成定制化构建
• 配置定制支持：允许注入自定义grafana.ini配置文件、插件或数据源配置
• 多仓库适配：支持推送镜像至Docker Hub、私有仓库及云厂商容器仓库（如AWS ECR、阿里云ACR等）
• 灵活版本管理：支持自定义镜像标签策略，满足开发、测试、生产等多环境镜像区分需求
• Drone原生集成：通过简单配置即可嵌入现有Drone流水线，无需额外复杂脚本

使用场景

• 企业定制化Grafana部署：需添加企业内部插件、安全配置或主题时，自动化构建符合企业标准的Grafana镜像
• 多环境镜像管理：为不同环境（开发/测试/生产）构建差异化配置的Grafana镜像，并自动推送至对应仓库
• Grafana版本升级：当官方版本更新时，通过修改版本参数触发自动构建，快速完成镜像升级
• 监控系统CI/CD整合：在包含Grafana的监控平台部署流程中，作为前置步骤自动提供最新镜像

使用方法与配置说明

前提条件

• 已部署Drone CI/CD平台，且Runner具备Docker构建环境访问权限（如Docker-in-Docker配置或挂载Docker套接字）
• 目标容器仓库的访问凭证（用户名/密码或访问令牌）已通过Drone Secrets管理

Drone流水线配置示例

在Drone配置文件（.drone.yml）中添加如下步骤：

yaml
steps:
  - name: build-grafana-image
    image: <插件镜像地址>  # 替换为实际插件镜像地址
    settings:
      grafana_version: 10.2.0  # 指定Grafana版本
      docker_registry: registry.example.com  # 目标容器仓库地址
      docker_username:
        from_secret: docker_user  # 从Drone Secrets获取仓库用户名
      docker_password:
        from_secret: docker_pass  # 从Drone Secrets获取仓库密码
      image_name: monitoring/grafana  # 镜像名称（含仓库路径）
      tags:
        - ${DRONE_COMMIT_SHA:0:8}  # 使用提交SHA前8位作为标签
        - ${DRONE_BRANCH}  # 使用分支名作为标签
      config_files:
        - ./custom-grafana.ini:/etc/grafana/grafana.ini  # 自定义配置文件映射
      build_args:
        http_proxy: http://proxy.example.com:8080  # 可选构建代理配置

核心配置参数说明

注意事项

1. 确保Drone Runner配置允许执行Docker构建操作（推荐使用privileged: true模式或挂载/var/run/docker.sock）
2. 敏感信息（如仓库凭证）必须通过Drone Secrets管理，禁止明文配置
3. 自定义配置文件需注意权限设置，避免因权限问题导致Grafana启动失败
4. 构建前建议验证Grafana版本号有效性，可通过官方仓库确认版本存在性
5. 大规模构建场景建议配置镜像缓存，减少重复下载依赖时间