使用Jfrog CLI与Artifactory实现单构建多环境Docker镜像管理问题

你遇到的核心问题是对Artifactory构建记录的设计逻辑理解偏差，以及操作流程中构建发布时机和制品关联的错误。

Artifactory构建的核心逻辑 #

Artifactory的构建记录（Build Info）是用来追踪一次完整CI/CD流水线产出的所有制品，同一个构建名+编号对应唯一的构建记录，所有环境标签的镜像（dev/staging/prod/latest）都应该关联到这个唯一记录中，而非每个阶段单独发布构建。

错误操作的根源 #

1. 每个阶段执行jfrog rt bp（构建发布）：每次发布都会生成独立的构建记录（即使名称/编号相同，Artifactory也会视为不同版本或覆盖旧记录，导致你看到3个独立构建）。
2. 移除bp后未关联后续镜像：staging/prod阶段的镜像推送未显式绑定到同一个构建名+编号，导致这些镜像仅存储在仓库中，未被关联到构建记录。

修正后的操作流程 #

全程使用同一个构建名myproj和构建编号1234，确保所有镜像都关联到该构建，仅在所有镜像推送完成后统一发布构建。

Dev阶段

# 构建dev镜像
docker build -t my-repo/myproj:dev-1234 .

# 推送镜像并关联到指定构建
jfrog rt docker push my-repo/myproj:dev-1234 --build-name=myproj --build-number=1234

# 初始化空构建记录（可选，推送时会自动创建，显式执行更稳妥）
jfrog rt bce myproj 1234

Staging阶段

# 拉取dev镜像
jfrog rt docker pull my-repo/myproj:dev-1234

# 打staging标签
docker tag my-repo/myproj:dev-1234 my-repo/myproj:staging-1234

# 推送staging镜像，必须绑定同一个构建名+编号
jfrog rt docker push my-repo/myproj:staging-1234 --build-name=myproj --build-number=1234

Prod阶段

# 拉取staging镜像
jfrog rt docker pull my-repo/myproj:staging-1234

# 打prod标签并推送，绑定同一构建
docker tag my-repo/myproj:staging-1234 my-repo/myproj:prod-1234
jfrog rt docker push my-repo/myproj:prod-1234 --build-name=myproj --build-number=1234

# 打latest标签并推送，绑定同一构建
docker tag my-repo/myproj:prod-1234 my-repo/myproj:latest
jfrog rt docker push my-repo/myproj:latest --build-name=myproj --build-number=1234

# 所有镜像推送完成后，统一发布构建
jfrog rt bp myproj 1234

# 晋升构建到prod状态
jfrog rt build-promote myproj 1234 --status=prod

关键注意事项 #

• 所有jfrog rt docker push必须显式指定--build-name和--build-number，否则推送的镜像不会关联到目标构建。
• jfrog rt bp仅需执行一次，在所有制品推送完成后执行，避免重复发布导致的多构建问题。
• jfrog rt bce和jfrog rt bag（若无需添加额外文件）可省略，因为docker push时指定构建参数会自动创建并更新构建记录。

内容的提问来源于stack exchange，提问作者Kevin H.