grafana/build-container Docker Image
用于构建Grafana的容器
Grafana 构建容器镜像文档
镜像概述和主要用途
该容器镜像专为构建 Grafana 应用程序设计,提供了预配置的构建环境,包含 Grafana 编译所需的依赖工具链、开发环境及构建脚本,旨在简化 Grafana 源码的本地构建、自定义版本编译及 CI/CD 流程集成。
核心功能和特性
- 预配置构建环境:集成 Grafana 构建所需的全套依赖(如 Go 编译器、Node.js、npm、make、Git 等),无需手动安装工具链。
- 版本兼容性:支持主流 Grafana 源码版本,适配不同分支(如 main、v9.x、v10.x 等)的构建需求。
- 多场景适配:可直接用于本地开发或集成至 CI/CD 流水线,支持命令行构建和自动化构建。
- 数据卷灵活挂载:支持挂载本地源码目录、构建产物目录,实现源码实时同步和产物持久化。
使用场景和适用范围
- Grafana 开发者本地构建:简化本地开发环境配置,快速编译源码生成可执行文件。
- 自定义版本编译:基于修改后的 Grafana 源码(如添加插件、调整功能)构建自定义版本。
- CI/CD 流程集成:在 Jenkins、GitHub Actions 等平台中作为构建步骤,自动化生成 Grafana 二进制文件。
- 贡献者开发环境统一:为 Grafana 开源项目贡献者提供一致的构建环境,减少“环境不一致导致构建失败”问题。
使用方法和配置说明
docker run 命令示例
通过 docker run 直接启动容器,挂载本地 Grafana 源码目录并执行构建命令:
bashdocker run -it --rm \ -v /path/to/local/grafana-source:/grafana \ # 挂载本地 Grafana 源码目录至容器内 /grafana -v /path/to/build-output:/grafana/bin \ # 挂载构建产物目录(可选,持久化输出) -e GRAFANA_BRANCH="main" \ # 指定构建的源码分支(可选) grafana/build-container:latest \ # 镜像名称(示例) make build # 执行构建命令
docker-compose 配置示例
创建 docker-compose.yml 文件,定义构建环境:
yamlversion: '3.8' services: grafana-builder: image: docker.xuanyuan.run/grafana/build-container:latest volumes: - ./grafana-source:/grafana # 本地源码目录挂载 - ./grafana-bin:/grafana/bin # 构建产物持久化 - ~/.ssh:/root/.ssh # 挂载 SSH 密钥(如需拉取私有依赖,可选) environment: - GRAFANA_BRANCH=main # 源码分支 - GO_VERSION=1.21 # 覆盖 Go 版本(可选,默认内置兼容版本) - NODE_VERSION=18 # 覆盖 Node.js 版本(可选,默认内置兼容版本) command: make build # 启动容器后执行的构建命令
启动命令:
bashdocker-compose up
环境变量说明
| 环境变量 | 描述 | 默认值 |
|---|---|---|
GRAFANA_BRANCH | 指定构建的 Grafana 源码分支(需确保本地源码目录已切换至对应分支) | main |
GO_VERSION | 覆盖容器内的 Go 编译器版本(需镜像支持,部分镜像可能固定版本) | 镜像内置版本(如 1.21) |
NODE_VERSION | 覆盖容器内的 Node.js 版本(用于前端资源构建) | 镜像内置版本(如 18) |
BUILD_TARGET | 指定构建目标(如 linux-amd64、darwin-arm64),支持多平台构建 | linux-amd64 |
SKIP_FRONTEND | 是否跳过前端资源构建(true/false),仅编译后端时使用 | false |
数据卷挂载
| 挂载路径(容器内) | 用途说明 | 本地路径示例 |
|---|---|---|
/grafana | Grafana 源码目录,容器内构建命令将基于此目录执行 | /home/user/grafana-source |
/grafana/bin | 构建产物输出目录,二进制文件(如 grafana-server)将生成于此 | /home/user/grafana-bin |
/root/.npm | npm 缓存目录(可选),加速前端依赖安装 | ~/.npm |
/root/go/pkg | Go 模块缓存目录(可选),加速 Go 依赖下载 | ~/.go/pkg |
构建命令示例
容器启动后,可通过以下命令执行构建操作:
- 全量构建(默认,包含前端和后端):
bash
make build - 仅构建后端(跳过前端资源打包):
bash
make server - 构建并生成 Docker 镜像(基于当前源码):
bash
make docker-build - 运行单元测试:
bash
make test
grafana 命名空间的其他可用镜像:
grafana/grafana
Grafana 监控和可视化平台,支持多种数据源和仪表板
grafana/loki
Grafana Loki 日志聚合系统,适合日志收集和查询
grafana/alloy
Grafana Alloy 遥测收集器,适合指标、日志和追踪数据收集
grafana/grafana-enterprise
Grafana Enterprise 企业版可视化平台,适合监控和数据分析
grafana/promtail
Promtail 日志收集器,Grafana 官方维护,适合 Loki 日志聚合
grafana/grafana-image-renderer
Grafana 图表图片渲染器,适合告警通知与报表导出
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 build-container 镜像标签
docker pull docker.xuanyuan.run/grafana/build-container:<标签>
DockerHub 原生拉取命令
docker pull grafana/build-container:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务