Cloud Native Cookbook
Volcano

构建与发布流程

概述

本文档介绍 Volcano 的完整构建流程，包括本地构建、Docker 镜像构建、跨平台编译以及发布流程。

构建系统架构

graph TB subgraph build["构建系统"] MK["Makefile
主入口"] DEF["Makefile.def
变量定义"] HACK["hack/ 脚本"] end subgraph targets["构建目标"] BIN["二进制
_output/bin/"] IMG["Docker 镜像
buildx 多平台"] CRD["CRD YAML
controller-gen"] HELM["Helm Chart"] end MK --> BIN MK --> IMG MK --> CRD MK --> HELM DEF --> MK HACK --> MK

本地构建

构建所有二进制

# 构建所有组件到 _output/bin/
make all

# 输出目录结构：
# _output/bin/
# ├── vc-scheduler
# ├── vc-controller-manager
# ├── vc-webhook-manager
# ├── vc-agent
# ├── network-qos
# └── vcctl

构建单个组件

make vc-scheduler              # 调度器
make vc-controller-manager     # 控制器
make vc-webhook-manager        # Webhook
make vc-agent                  # Agent + network-qos
make vcctl                     # CLI 工具（当前 OS）
make command-lines             # CLI 工具集：vcancel, vresume 等

构建参数

# 指定目标 OS 和架构
GOOS=linux GOARCH=amd64 make vc-scheduler

# 启用 CGO 插件支持
SUPPORT_PLUGINS=yes make vc-scheduler

# 指定版本号
TAG=v1.10.0 make all

# Debug 构建（关闭优化）
GOLDFLAGS="" make vc-scheduler

构建变量

主要变量定义在 Makefile.def：

变量说明默认值
BIN_DIR输出目录_output/bin
GOOS目标操作系统当前系统
GOARCH目标架构当前架构
TAG版本标签Git SHA
SUPPORT_PLUGINSCGO 插件支持否

Docker 镜像构建

构建所有镜像

# 构建全部镜像
make images

# 镜像列表：
# volcanosh/vc-scheduler:<tag>
# volcanosh/vc-controller-manager:<tag>
# volcanosh/vc-webhook-manager:<tag>
# volcanosh/vc-agent:<tag>

多平台构建

# 使用 buildx 构建多平台镜像
docker buildx create --use --name volcano-builder
make images DOCKER_PLATFORMS="linux/amd64,linux/arm64"

自定义镜像仓库

# 推送到自定义仓库
REGISTRY=my-registry.example.com make images
docker push my-registry.example.com/volcanosh/vc-scheduler:<tag>

代码生成

API 类型变更后

修改 staging/src/volcano.sh/apis/ 下的类型定义后：

# 1. 重新生成 deepcopy、client、informer、lister
make generate-code

# 2. 重新生成 CRD YAML
make manifests

# 3. 重新生成部署 YAML
make generate-yaml

# 4. 验证生成的代码是否最新
make verify

代码生成流程

flowchart LR A["修改 types.go"] --> B["make generate-code"] B --> C["deepcopy-gen"] B --> D["client-gen"] B --> E["informer-gen"] B --> F["lister-gen"] G["修改 CRD 标注"] --> H["make manifests"] H --> I["controller-gen
生成 CRD YAML"]

生成的文件

命令生成文件
generate-codezz_generated.deepcopy.go、client/clientset/、client/informers/、client/listers/
manifestsconfig/crd/volcano/bases/*.yaml、config/crd/jobflow/bases/*.yaml
generate-yamlinstaller/ 下的部署 YAML

质量检查

格式化和 Lint

# 代码格式化
hack/update-gofmt.sh

# 格式检查
hack/verify-gofmt.sh

# Lint 检查（golangci-lint）
make lint

# 验证生成的代码
make verify

CI 检查流程

flowchart LR A["代码提交"] --> B["格式检查
verify-gofmt"] B --> C["代码生成验证
verify-gencode"] C --> D["Lint 检查
golangci-lint"] D --> E["单元测试
unit-test"] E --> F["E2E 测试
e2e"] F --> G["镜像构建
images"]

Helm Chart 管理

更新 Chart

# 生成 Helm Chart
hack/generate-charts.sh

# Chart 位置
# installer/helm/chart/volcano/

Chart 结构

installer/helm/chart/volcano/
├── Chart.yaml                    # Chart 元信息
├── values.yaml                   # 默认配置
├── templates/                    # 模板文件
│   ├── scheduler.yaml
│   ├── controllers.yaml
│   ├── admission.yaml
│   └── ...
├── config/                       # 配置文件
│   ├── volcano-scheduler.conf
│   └── volcano-admission.conf
└── crd/bases/                    # CRD 定义

发布流程

版本号规范

Volcano 遵循语义化版本（Semantic Versioning）：

v<major>.<minor>.<patch>
  • major：不兼容的 API 变更
  • minor：向后兼容的功能新增
  • patch：向后兼容的问题修复

发布步骤

flowchart TB A["创建 Release Branch
release-x.y"] --> B["更新版本号"] B --> C["运行完整测试"] C --> D["构建 Release 镜像"] D --> E["推送镜像到 Docker Hub"] E --> F["生成 Release YAML"] F --> G["创建 GitHub Release"] G --> H["发布 Helm Chart"]

构建 Release

# 设置版本号
export TAG=v1.10.0

# 构建 Release 镜像
TAG=$TAG make images

# 推送镜像
docker push volcanosh/vc-scheduler:$TAG
docker push volcanosh/vc-controller-manager:$TAG
docker push volcanosh/vc-webhook-manager:$TAG

# 生成 Release YAML
TAG=$TAG make generate-yaml

发布清单

产物说明
Docker 镜像volcanosh/*:<version> 推送到 Docker Hub
YAML Manifestvolcano-<version>.yaml 单文件部署
Helm Chart发布到 Helm 仓库
GitHub Release含 Release Notes 和二进制

开发者工具

Hack 脚本

脚本说明
hack/update-gencode.sh重新生成代码
hack/verify-gencode.sh验证生成代码
hack/update-gofmt.sh格式化代码
hack/verify-gofmt.sh检查格式
hack/run-e2e-kind.sh运行 KinD E2E
hack/generate-yaml.sh生成部署 YAML
hack/generate-charts.sh生成 Helm Chart
hack/publish.sh发布脚本

常见问题

问题原因解决方案
构建失败: module not foundGo 模块未下载go mod download
CGO 编译错误缺少 C 编译器安装 gcc / musl-gcc
镜像构建失败Docker buildx 未配置docker buildx create --use
CRD 生成失败controller-gen 未安装go install sigs.k8s.io/controller-tools/cmd/controller-gen
verify 失败生成代码不是最新make generate-code && make manifests

参考文件

文件说明
Makefile主构建文件
Makefile.def构建变量
hack/构建和验证脚本
installer/helm/chart/volcano/Helm Chart
2026年2月12日
GitHub
测试指南