包晋升¶

包晋升是推荐的 DevOps 实践，用于处理不同技术中包的质量、成熟度或阶段，当然也适用于 Conan 包。

包晋升的原则是定义多个服务器包仓库，并根据阶段在仓库之间上传和复制包。例如，我们可以有两个不同的服务器包仓库，分别称为“testing”（测试）和“release”（发布）

注意

最佳实践

强烈建议不要使用不同的 user/channel 来表示成熟度。这在多年前 Conan 1 的早期版本中曾被描述过，当时还没有多个仓库的可能性，但不应该再使用了。
包在整个流水线和阶段中应该是完全不可变的，包不能重命名或更改其 user/channel，并且从源代码重新构建以获得新的 user/channel 也是强烈不鼓励的 DevOps 实践。

在这些仓库之间会有一些质量门。在我们的例子中，一些包将被放入“testing”仓库，例如 zlib/1.3.1 和 openssl/3.2.2，供 QA 团队进行测试。

当 QA 团队测试并批准这些包后，它们可以被晋升到“release”仓库。基本上，晋升是从“testing”仓库到“release”仓库复制包，包括所有构件和元数据。

有不同的方法来实现和执行包晋升。Artifactory 有一些 API 可以用来移动单个文件或文件夹。Conan 扩展仓库包含 conan art:promote 命令，该命令可用于将 Conan “包列表”从一个服务器仓库晋升到另一个仓库。

如果我们有一个包含上述 zlib/1.3.1 和 openssl/3.2.2 包的包列表 pkglist.json，则该命令将如下所示

从 testing -> release 晋升¶

$ conan art:promote pkglist.json --from=testing --to=release --url=https://<url>/artifactory --user=<user> --password=<password>

请注意，conan art:promote 命令不适用于 ArtifactoryCE，需要 Artifactory 的 Pro 版本。在这些情况下，可以使用简单的下载+上传流程来实现晋升功能。

从 testing -> release 晋升¶

# Promotion using Conan download/upload commands
# (slow, can be improved with art:promote custom command)
$ conan download --list=promote.json -r=testing --format=json > downloaded.json
$ conan upload --list=downloaded.json -r=release -c

从“testing”仓库晋升到“release”仓库后，这些包将如下所示

注意

最佳实践

在现代包服务器（如 Artifactory）中，包构件是去重的，也就是说，当它们被复制到不同的位置（包括不同的仓库）时，不会占用额外的存储空间。去重是基于校验和的，因此系统也很智能，可以避免重新上传现有构件。这对于“晋升”机制非常重要：此机制仅复制一些元数据，因此速度非常快且存储效率高。流水线可以根据需要定义任意数量的仓库和晋升，而无需担心存储成本。
也可以在 JFrog 平台中使用 Release Bundles（发布包）进行晋升。Conan 扩展仓库还包含一个用于生成发布包的命令（可以使用 Artifactory API 进行晋升）。

另请参阅