build-container

grafana/build-container Docker Image

用于构建Grafana的容器

下载次数: 0状态:社区镜像维护者: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 源码目录并执行构建命令:

bash
docker 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 文件,定义构建环境:

yaml
version: '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                    # 启动容器后执行的构建命令

启动命令:

bash
docker-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

数据卷挂载

挂载路径(容器内)用途说明本地路径示例
/grafanaGrafana 源码目录,容器内构建命令将基于此目录执行/home/user/grafana-source
/grafana/bin构建产物输出目录,二进制文件(如 grafana-server)将生成于此/home/user/grafana-bin
/root/.npmnpm 缓存目录(可选),加速前端依赖安装~/.npm
/root/go/pkgGo 模块缓存目录(可选),加速 Go 依赖下载~/.go/pkg

构建命令示例

容器启动后,可通过以下命令执行构建操作:

  • 全量构建(默认,包含前端和后端):
    bash
    make build
    
  • 仅构建后端(跳过前端资源打包):
    bash
    make server
    
  • 构建并生成 Docker 镜像(基于当前源码):
    bash
    make docker-build
    
  • 运行单元测试:
    bash
    make test
    

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 build-container 镜像标签

docker pull docker.xuanyuan.run/grafana/build-container:<标签>

DockerHub 原生拉取命令

docker pull grafana/build-container:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告