CI/CD / 系统课时

发布到制品仓库

发布到制品仓库

本课把“构建成功”推进到“可被后续环境可靠获取”:为制品设计正式版与快照版命名,上传到仓库,验证发布结果,并用保留策略限制无效快照和历史版本持续占用存储。

学习目标

  • 区分正式版本与快照版本的发布规则,避免同一版本被反复覆盖。
  • 使用脚本把构建产物上传到制品仓库,并验证仓库中的实际对象。
  • 为快照、正式版和关键版本设计不同的保留策略。

先确定版本与仓库路径

制品仓库的核心价值不是“多一个下载地址”,而是给构建产物一个稳定、可审计的身份。正式版本应当不可变,例如 1.4.2;快照版本用于持续集成,可使用 1.4.3-SNAPSHOT 或带提交号的预发布标识。

推荐把仓库至少分成 release 与 snapshot 两类逻辑空间。release 只接受正式版本,并禁止覆盖已经存在的同版本对象;snapshot 允许频繁发布,但必须通过保留策略自动清理旧版本。这样可以同时满足“生产可追溯”和“开发迭代快”。

正式版与快照版从构建到仓库再到保留策略的发布链路

上传构建产物

下面以支持 HTTP PUT 的通用制品仓库为例。脚本要求 CI 提供仓库地址、凭据、版本号和已经构建好的文件;它根据版本名自动选择 release 或 snapshot 路径,并在上传后输出 HTTP 状态码。

bash
#!/usr/bin/env bash
set -euo pipefail

: "${REPO_BASE:?missing REPO_BASE}"
: "${REPO_USER:?missing REPO_USER}"
: "${REPO_PASSWORD:?missing REPO_PASSWORD}"
: "${VERSION:?missing VERSION}"
: "${ARTIFACT:?missing ARTIFACT}"

if [[ "$VERSION" == *-SNAPSHOT ]]; then
  REPOSITORY="snapshots"
else
  REPOSITORY="releases"
fi

FILE_NAME="$(basename "$ARTIFACT")"
TARGET="${REPO_BASE}/${REPOSITORY}/com/example/demo/${VERSION}/${FILE_NAME}"

HTTP_STATUS="$(
  curl --silent --show-error     --user "${REPO_USER}:${REPO_PASSWORD}"     --upload-file "$ARTIFACT"     --output /dev/null     --write-out "%{http_code}"     "$TARGET"
)"

printf 'repository=%s\nurl=%s\nhttp_status=%s\n'   "$REPOSITORY" "$TARGET" "$HTTP_STATUS"

case "$HTTP_STATUS" in
  200|201|204) ;;
  *) exit 1 ;;
esac

运行前把 REPO_BASE 设为仓库根地址,把 ARTIFACT 指向当前流水线刚生成的文件。正式版本建议由受保护的 tag 或人工批准触发,快照则可由分支构建持续发布。

预期输出

text
repository=<REPOSITORY>
url=<REPO_URL>
http_status=<HTTP_STATUS>

实际 URL 与状态码由仓库实现决定;成功上传通常应得到 200、201 或 204 之一。脚本已把其他状态码视为失败,因此流水线不会在上传失败时继续部署。

发布后立即验证

“上传命令成功执行”不等于“仓库里的对象可用”。最小验证应重新访问目标对象并检查服务端返回状态;更严格的流程还应继续核对哈希、签名和构建元数据。

bash
#!/usr/bin/env bash
set -euo pipefail

: "${REPO_USER:?missing REPO_USER}"
: "${REPO_PASSWORD:?missing REPO_PASSWORD}"
: "${TARGET:?missing TARGET}"

HTTP_STATUS="$(curl --silent --show-error --user "${REPO_USER}:${REPO_PASSWORD}" --head --output /dev/null --write-out "%{http_code}" "$TARGET")"
printf 'http_status=%s\n' "$HTTP_STATUS"
[[ "$HTTP_STATUS" == "200" ]]

预期输出

text
http_status=200

如果返回 401 或 403,优先检查 CI 使用的发布账号权限;如果是 404,检查仓库名、坐标、版本号和文件名是否与上传路径一致。不要用“再次上传同一正式版本”作为排错手段,否则会破坏不可变版本原则。

设计保留策略

快照与正式版应采用不同策略。快照适合按“保留最近 N 个版本”和“超过 N 天删除”组合清理;正式版通常保留更久,并对生产正在使用、审计要求保留或作为回滚基线的版本加保护标签。

删除策略还要考虑引用关系。若部署清单、镜像清单或发布记录仍引用某个版本,就不应仅因为年龄达到阈值而删除。更稳妥的顺序是先判断是否仍被环境引用,再执行数量或时间规则,最后由仓库的垃圾回收机制释放底层存储。

当流水线能稳定做到“版本确定、单次上传、立即验证、按引用关系保留”,制品仓库才真正成为部署阶段可信的唯一来源,而不是临时文件中转站。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

发布到制品仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通