Argo CD项目发布流程完全指南

凌朦慧Richard

于 2025-06-01 09:17:02 发布

阅读量221

点赞数 4

本文链接：https://blog.youkuaiyun.com/gitblog_00235/article/details/148362835

版权

Argo CD项目发布流程完全指南

argo-cd Argo CD 是一个声明式 Kubernetes 应用部署工具，可实现应用程序的自动化部署和版本控制。 * 提供 Kubernetes 应用的自动化部署和版本控制功能，支持多种部署策略，简化 Kubernetes 应用管理。 * 有什么特点：声明式部署、支持多种部署策略、简化 Kubernetes 应用管理。项目地址: https://gitcode.com/gh_mirrors/ar/argo-cd

前言

作为一款流行的GitOps持续交付工具，Argo CD采用严谨的自动化发布流程确保每个版本的可靠性和安全性。本文将深入解析Argo CD的发布机制，帮助开发者理解其背后的设计理念和技术实现。

发布流程概述

Argo CD采用两阶段自动化发布机制，整个过程约60分钟完成。这种设计既保证了发布效率，又通过多阶段验证确保了发布质量。

发布前准备工作

在触发自动化流程前，需完成以下关键准备工作：

版本分支准备：目标发布分支必须已存在，例如要发布v2.7.0版本，需确保release-2.7分支存在
变更日志更新：必须手动更新CHANGELOG.md文件，记录该版本的所有变更
发布说明配置：更新goreleaser.yaml中的"Release Notes Blog Post"部分

详细发布流程

第一阶段：版本与清单更新

确认目标分支已存在
执行Init ArgoCD Release工作流，该流程将：
- 更新release分支中的VERSION文件
- 使用新版本号更新所有清单文件中的镜像标签
- 创建包含这些变更的Pull Request
审核并合并该Pull Request

第二阶段：正式发布

检出目标发布分支：

git fetch upstream && git checkout release-2.7

执行发布脚本：
```
./hack/trigger-release.sh v2.7.2 upstream
```
注意标签格式要求：
- 正式版：v<主版本>.<次版本>.<补丁版本>
- 预发布版：v<主版本>.<次版本>.<补丁版本>-rc<RC编号>
自动化流程将执行以下操作：
- 构建、推送并签名容器镜像
- 生成容器镜像的来源证明
- 构建CLI二进制文件和发布说明
- 创建版本发布并附加所有必要资源
- 生成CLI二进制文件的来源证明
- 生成并签名软件物料清单(SBOM)
- 更新stable标签(如适用)
- 更新master分支的VERSION文件(针对GA版本)

发布验证

发布完成后，必须进行以下验证：

检查GitHub Action的执行状态和输出日志
确认版本发布页面是否已正确创建，且所有必要资源都已附加
验证Quay.io上的镜像是否已正确发布

异常处理

如果发布过程中出现问题，需要根据具体情况手动清理：

如果容器镜像已推送到Quay.io，需手动删除
如果版本已创建，需从发布页面手动删除

关键技术文件

| 文件路径 | 功能描述 | |---------|---------| | goreleaser.yaml | 配置CLI二进制文件构建、校验和及发布说明生成 | | .github/workflows/image-reuse.yaml | 容器镜像生成的可重用工作流 | | .github/workflows/init-release.yaml | 生成清单和VERSION文件的工作流 | | .github/workflows/release.yaml | 构建镜像、CLI二进制文件、来源证明等的主工作流 | | ./hack/trigger-release.sh | 检查所有前置条件并推送标签的脚本 |