Rancher/goreleaser 镜像文档

概述

rancher/goreleaser 是 Rancher 团队基于官方 goreleaser 工具定制的 Docker 镜像，专为 Go 项目的自动化构建、打包和发布流程设计。该镜像集成了 Rancher 生态系统的最佳实践，优化了与 Rancher CI/CD 工具链的兼容性，可简化 Go 应用在开发、测试和生产环境中的版本管理、多平台构建及分发流程。

核心功能与特性

1. 增强的构建能力

• 基于官方 goreleaser 最新稳定版本，支持 Go 1.16+ 项目构建
• 内置多平台交叉编译支持（如 Linux、Windows、Darwin 等）
• 集成 Rancher 特有的构建缓存策略，提升 CI/CD 流程效率

2. 生态系统集成

• 无缝对接 Rancher Pipeline、Rancher Fleet 等工具
• 支持 Rancher 私有镜像仓库的自动推送
• 内置符合 Rancher 安全标准的构建环境

3. 自动化发布流程

• 自动生成语义化版本号（遵循 SemVer）
• 支持 GitHub/GitLab Releases 自动发布
• 生成标准化发布说明（Changelog）
• 支持多格式打包（二进制文件、Docker 镜像、deb/rpm 包等）

使用场景

• Rancher 环境中的 Go 项目：需与 Rancher CI/CD 流程深度集成的应用构建
• 开源 Go 项目：需要自动化发布到 GitHub/GitLab 的开源项目
• 企业内部 Go 应用：需规范化版本管理和多环境分发的企业级应用
• 多平台 Go 应用：需要同时构建多个操作系统/架构版本的应用

使用方法

基本用法（Docker Run）

# 基本构建（使用项目根目录的 .goreleaser.yml 配置）
docker run --rm -v $(pwd):/workspace -w /workspace rancher/goreleaser release --snapshot

# 带环境变量的发布（例如指定 GitHub Token）
docker run --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  -e GITHUB_TOKEN=your_github_token \
  rancher/goreleaser release

配置文件示例（.goreleaser.yml）

在项目根目录创建 .goreleaser.yml 配置文件，示例：

project_name: my-go-app
env:
  - GO111MODULE=on
before:
  hooks:
    - go mod tidy
builds:
  - env:
      - CGO_ENABLED=0
    goos: [linux, darwin]
    goarch: [amd64, arm64]
    binary: my-app
dockers:
  - image_templates:
      - "rancher/my-go-app:{{ .Version }}"
      - "rancher/my-go-app:latest"
    dockerfile: Dockerfile
    build_flag_templates:
      - "--label=org.opencontainers.image.version={{ .Version }}"
release:
  github:
    owner: rancher
    repo: my-go-app
  draft: false
  prerelease: false
changelog:
  sort: asc
  filters:
    exclude:
      - "^docs:"
      - "^test:"

Docker Compose 集成

创建 docker-compose.yml：

version: '3.8'
services:
  goreleaser:
    image: rancher/goreleaser
    volumes:
      - .:/workspace
    working_dir: /workspace
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - DOCKER_REGISTRY=${DOCKER_REGISTRY}
    command: release --rm-dist

运行：

# 加载环境变量并执行
export GITHUB_TOKEN=your_token
export DOCKER_REGISTRY=rancher.io
docker-compose up

关键环境变量

配置文件说明

.goreleaser.yml 是核心配置文件，主要配置项：

• builds：定义构建参数（Go 版本、目标平台、二进制名称等）
• dockers：Docker 镜像构建配置（镜像名、Dockerfile 路径等）
• release：发布目标配置（GitHub/GitLab 仓库信息）
• changelog：发布说明生成规则
• before.hooks：构建前执行的命令（如 go mod tidy）

注意事项

• 确保项目根目录存在有效的 .goreleaser.yml 配置文件
• 敏感信息（如 API Token）建议通过环境变量注入，避免硬编码
• 首次使用前建议通过 --snapshot 参数测试构建流程（不会实际发布）
• 多平台构建可能需要开启 Docker Buildx 支持

参考链接

• 官方 goreleaser 文档
• Rancher CI/CD 文档
• Rancher 镜像仓库