配置 Artifactory
DevOps Insights 该服务将于2026年8月31日停止运营并终止。Continuous Delivery 将于2027年2月12日在以下区域停止运营:au-syd、ca-mon、ca-tor、us-east。 Code Risk Analyzer 也将于该日期在所有地区停止提供服务。 如果某个区域未实际使用这些功能,该区域内的相关功能可能会提前停用,并停止接受新实例。 了解更多
配置 Artifactory 仓库管理器,将其构建产物存储在您的 Artifactory 仓库(repo)中。
-
如果您在创建工具链时配置此工具集成,请在“可配置的集成”部分中,单击 Artifactory。
-
若您已拥有工具链并需向其中添加此工具集成,请在控制 IBM Cloud 台中点击菜单图标 (
)> 平台自动化 > 工具链。 在“工具链”页面上,单击某个工具链以打开其“概述”页面。
a. 单击 “添加工具”。
b. 在“工具集成”部分中,单击 Artifactory。
-
输入在您单击 Artifactory 卡时想要打开的 Artifactory 存储库的 URL。
-
选择您要连接到的存储库类型。
-
如果您使用 Artifactory npm 注册表,请遵循以下步骤:
a. 输入与注册表相关联的电子邮件地址。
b. 输入与注册表相关联的认证令牌。
c. 输入 Artifactory 发布存储库的 URL,这是您在 Artifactory 服务器上的专用注册表。
d. 输入用于组合多个公共和专用 npm 注册表的镜像或公共注册表的 URL。 例如,此 URL 可能是可访问专用注册表和 npm 全局 注册表高速缓存的 Artifactory 服务器上虚拟注册表的 URL。
-
如果您使用 Artifactory Maven 存储库,请遵循以下步骤:
a. 输入与存储库相关联的用户标识。
b. 输入与存储库相关联的密码。
c. 输入 Artifactory 发布存储库的 URL,这是您在 Artifactory 服务器上的专用发布存储库。
d. 输入 Artifactory 快照存储库的 URL,这是您在 Artifactory 服务器上的专用快照存储库。
e. 输入用于组合多个公共和专用 Maven 存储库的镜像或公共存储库的 URL。 例如,此 URL 可能是可访问专用存储库和 Maven 中央存储库高速缓存的 Artifactory 服务器上虚拟存储库的 URL。
-
单击创建集成。
-
在 第三方工具 卡上,单击要使用的 Artifactory 存储库的 Artifactory 工具集成。 这将打开 Artifactory Web 站点,您可在其中查看存储库的内容。
-
可选:如果您在 IBM Cloud Public 上使用工具链,并且想要使用 Artifactory 与 npm 来构建应用程序,请配置管道以添加 npm 构建作业。 有关配置构建作业的指示信息,请参阅在管道中配置 Artifactory npm 构建作业一节。
-
可选:如果您在 IBM Cloud Public 上使用工具链,并且想要使用 Artifactory 与 Maven 来构建应用程序,请配置管道以添加 Maven 构建作业。 有关配置构建作业的指示信息,请参阅在管道中配置 Artifactory Maven 构建作业一节。
在管道中配置 Artifactory npm 构建作业
在管道中配置 npm 构建作业之前,您必须具有可使用构建 SCM 存储库作为输入的工作管道。 还必须为工具链配置 Artifactory。 有关配置 Artifactory 的指示信息,请参阅 Artifactory 一节。
配置 Delivery Pipeline 以添加 npm 构建作业:
-
创建阶段并设置适当 SCM 存储库的输入。
-
在阶段上,添加构建作业。
-
配置构建作业:
build a. 对于构建器类型,请选择 NPM 构建。
b. 如果已配置 Artifactory 工具集成的多个实例,请输入要为其配置 npm 构建作业的 Artifactory 工具集成的名称。
c. 对于工具集成类型,请选择 Artifactory。
d. 对于构建命令,请输入用于构建 npm 模块或将其发布到注册表的命令。 此示例显示构建模块或进行发布的命令。
npm install # or npm publish --registry "${NPM_RELEASE_URL}"您可以在 Artifactory 工具集成的配置设置中,查找用于连接到注册表的 URL 和用户凭证。
e. 如果您的构建作业发布到 Artifactory 注册表且您节点模块版本的格式为
x.y.z-SNAPSHOT.w,请选中递增快照模块版本复选框。 构建作业会在作业发布到 Artifactory 注册表之前,自动更新模块版本。 作业会从 npm 注册表和本地package.json文件中选择最高的模块版本,并使用 semver 递增模块版本。 构建作业不会将更改交付到 SCM 存储库。 -
单击保存。 管道无论何时运行,此构建作业都会使用 Artifactory 工具集成中的配置信息来连接到您的 npm 注册表。
在管道中配置 Artifactory Maven 构建作业
在管道中配置 Maven 构建作业之前,您需要可使用构建 SCM 存储库作为输入的工作管道,并且您必须为工具链配置 Artifactory。 有关配置 Artifactory 的指示信息,请参阅 Artifactory 一节。
配置 Delivery Pipeline 以添加 Maven 构建作业:
-
创建阶段并设置适当 SCM 存储库的输入。
-
在阶段上,添加构建作业。
-
配置构建作业:
*
Maven 构建 a. 对于构建器类型,请选择 Maven 构建。
b. 如果已配置 Artifactory 工具集成的多个实例,请输入要为其配置 Maven 构建作业的 Artifactory 工具集成的名称。
c. 对于工具集成类型,请选择 Artifactory。
d. 对于构建命令,请输入用于构建 Maven 模块或将其发布到快照注册表的命令。 此示例显示构建模块或将其发布到快照注册表的命令。
mvn -B clean package # or mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy您可以在 Artifactory 工具集成的配置设置中,查找用于连接到注册表的 URL 和用户凭证。
-
单击保存。 管道无论何时运行,此构建作业都会使用 Artifactory 工具集成中的配置信息来连接到您的 Maven 存储库。
使用 API 配置 Artifactory
工具 Artifactory 集成支持以下配置参数,您可在 创建、读取和 更新工具集成时 通过工具链 HTTP API 和 SDK 使用这些参数。
必须在请求主体中使用 artifactory 值指定 tool_type_id 属性。
| 参数 | 用途 | 类型 | Terraform 自变量 | 描述 |
|---|---|---|---|---|
| dashboard_url | 可选,可更新 | 字符串 | dashboard_url | 此 ArtifactoryURL 工具集成的服务器仪表板的。 在图形化用户界面中,当您点击工具集成 Artifactory 卡片时,浏览器将跳转至此仪表盘。 |
| 镜像网址 | 可选,可更新 | 字符串 | 镜像网址 | 您的 Artifactory 虚拟仓库 URL,您可以在其中查看私有仓库以及公共仓库的缓存。 |
| 名称 | 必需,可更新 | 字符串 | 名称 | 此工具集成的名称。 |
| 发布网址 | 可选,可更新 | 字符串 | 发布网址 | 您的 Artifactory 发布仓库的 URL。 |
| 存储库名称 | 可选,可更新 | 字符串 | 存储库名称 | Docker 映像所在的 Artifactory 存储库的名称。 |
| 存储库网址 | 可选,可更新 | 字符串 | 存储库网址 | 您存储 Docker 图像 Artifactory 的仓库 URL 路径。 |
| 快照 URL | 可选,可更新 | 字符串 | 快照 URL | 你的 Artifactory 快照存储库的 URL。 |
| 标记 | 可选,可更新 | 密码 | 标记 | Artifactory 存储库的访问令牌。 您可以将工具链私钥引用用于此参数。 有关工具链私钥引用的更多信息,请参阅 保护 Continuous Delivery中的敏感数据。 |
| 类型 | 必需,可更新 | 字符串 | 类型 | Artifactory 工具集成的存储库类型。 |
| user_id | 可选,可更新 | 字符串 | user_id | Artifactory 存储库的用户标识或电子邮件地址。 |