3. 版本管理基础：语义化版本规范(SemVer)、Git标签与Release管理、镜像Tag策略

在自动化K8s发布流水线中，版本管理是回滚策略的基石。没有清晰的版本标识，回滚将无从谈起。本章聚焦三个核心维度：语义化版本规范（SemVer）、Git标签与Release管理以及镜像Tag策略，为后续的自动化回滚机制建立统一的版本语言。

3.1 语义化版本规范（SemVer）

语义化版本规范（Semantic Versioning，简称SemVer）是目前业界最广泛采用的版本号格式。它通过主版本号.次版本号.修订号的三段式结构，向开发者传递明确的兼容性信息。

在K8s发布流水线中，SemVer直接映射到应用版本。当流水线检测到代码变更时，CI系统会根据提交信息自动判断应该递增MAJOR、MINOR还是PATCH，从而生成新的版本号。

3.2 Git标签与Release管理

Git标签（Tag）是版本管理的“锚点”，它将一个特定的提交（Commit）与一个可读的版本号绑定。Release则是基于标签的正式发布产物，包含变更日志、二进制文件等。

3.2.1 Git标签策略

推荐使用轻量标签（Lightweight Tag）和附注标签（Annotated Tag）结合的方式。附注标签包含作者、日期和签名信息，更适合正式发布。

# 创建附注标签（推荐用于正式发布）
git tag -a v2.5.1 -m "Release version 2.5.1: Fix critical auth bug"

# 创建轻量标签（用于快速标记）
git tag v2.5.1-rc.1

# 推送标签到远程仓库
git push origin v2.5.1
git push origin --tags

3.2.2 Release管理流程

Release管理将Git标签与制品（Artifacts）关联。在GitHub/GitLab中，Release页面是版本管理的可视化入口。

1. 代码冻结： 从主分支（如main或release）创建发布分支。
2. 版本号生成： 根据SemVer规则确定新版本号（如v2.5.1）。
3. 打标签： 在发布分支的最后一个提交上创建附注标签。
4. 生成Release： 在代码托管平台创建Release，关联标签，并自动生成变更日志。
5. 触发流水线： Release事件触发CI/CD流水线，构建镜像并部署。

3.3 镜像Tag策略

容器镜像Tag是连接代码版本与运行时环境的桥梁。一个糟糕的Tag策略（如滥用latest）会直接导致回滚失败。以下是生产环境推荐的镜像Tag策略。

3.3.1 不可变Tag原则

镜像Tag一旦被推送，永远不能被覆盖。每个Tag必须唯一对应一个镜像摘要（Digest）。这保证了回滚时能精确拉取到之前的镜像版本。

3.3.2 主流Tag策略对比

3.3.3 推荐组合策略

在实际流水线中，通常采用多Tag策略：一个镜像同时被打上多个Tag，兼顾可读性与可追溯性。

# 示例：构建并推送多Tag镜像
docker build -t registry.example.com/myapp:2.5.1 \
             -t registry.example.com/myapp:a1b2c3d4 \
             -t registry.example.com/myapp:main-20231001 .

docker push registry.example.com/myapp:2.5.1
docker push registry.example.com/myapp:a1b2c3d4
docker push registry.example.com/myapp:main-20231001

3.4 版本管理最佳实践清单

• 统一规范： 团队内强制使用SemVer，并在CI流水线中通过脚本自动校验版本号格式。
• 标签即发布： 只有打了附注标签的提交才能触发生产环境部署。
• 镜像摘要优先： 在K8s YAML中，除了Tag外，建议通过imagePullPolicy: IfNotPresent配合镜像摘要（Digest）进行双重锁定。
• 自动化版本递增： 使用工具（如semantic-release、standard-version）根据提交信息自动生成版本号和变更日志。
• 清理策略： 定期清理过期的镜像Tag（如保留最近30天的版本），避免镜像仓库膨胀。