配置 Artifactory

配置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 工具集成支持以下配置参数，当您创建，读取和更新工具集成时，可以将这些参数与 Toolchain HTTP API 和 SDK 配合使用。

必须在请求主体中使用 artifactory 值指定 tool_type_id 属性。

Artifactory工具集成参数
参数	用途	Type	Terraform 自变量	描述
dashboard_url	可选，可更新	字符串	dashboard_url	此工具集成的 Artifactory 服务器仪表板的 URL。在图形 UI 中，当您单击 Artifactory 工具集成卡时，浏览器将转至此仪表板。
mirror_url	可选，可更新	字符串	mirror_url	Artifactory 虚拟存储库的 URL，您可以在其中查看专用存储库和公共存储库的高速缓存。
名称	必需，可更新	字符串	名称	此工具集成的名称。
release_url	可选，可更新	字符串	release_url	Artifactory 发行版存储库的 URL。
存储库名称	可选，可更新	字符串	存储库名称	Docker 映像所在的 Artifactory 存储库的名称。
repository_url	可选，可更新	字符串	repository_url	Docker 映像所在的 Artifactory 存储库的 URL。
快照 URL	可选，可更新	字符串	快照 URL	Artifactory 快照存储库的 URL。
标记	可选，可更新	密码	标记	Artifactory 存储库的访问令牌。您可以将工具链私钥引用用于此参数。有关工具链私钥引用的更多信息，请参阅保护 Continuous Delivery中的敏感数据。
类型	必需，可更新	字符串	类型	Artifactory 工具集成的存储库类型。
user_id	可选，可更新	字符串	user_id	Artifactory 存储库的用户标识或电子邮件地址。