配置 Artifactory

DevOps Insights 该服务将于2026年8月31日停止运营并终止。Continuous Delivery 将于2027年2月12日在以下区域停止运营:au-sydca-monca-torus-east。 Code Risk Analyzer 也将于该日期在所有地区停止提供服务。 如果某个区域未实际使用这些功能,该区域内的相关功能可能会提前停用,并停止接受新实例。 了解更多

配置 Artifactory 仓库管理器,将其构建产物存储在您的 Artifactory 仓库(repo)中。

  1. 如果您在创建工具链时配置此工具集成,请在“可配置的集成”部分中,单击 Artifactory

  2. 若您已拥有工具链并需向其中添加此工具集成,请在控制 IBM Cloud 台中点击菜单图标 (汉堡图标 )> 平台自动化 > 工具链。 在“工具链”页面上,单击某个工具链以打开其“概述”页面。

    a. 单击 “添加工具”

    b. 在“工具集成”部分中,单击 Artifactory

  3. 输入在您单击 Artifactory 卡时想要打开的 Artifactory 存储库的 URL。

  4. 选择您要连接到的存储库类型。

  5. 如果您使用 Artifactory npm 注册表,请遵循以下步骤:

    a. 输入与注册表相关联的电子邮件地址。

    b. 输入与注册表相关联的认证令牌。

    c. 输入 Artifactory 发布存储库的 URL,这是您在 Artifactory 服务器上的专用注册表。

    d. 输入用于组合多个公共和专用 npm 注册表的镜像或公共注册表的 URL。 例如,此 URL 可能是可访问专用注册表和 npm 全局 注册表高速缓存的 Artifactory 服务器上虚拟注册表的 URL。

  6. 如果您使用 Artifactory Maven 存储库,请遵循以下步骤:

    a. 输入与存储库相关联的用户标识。

    b. 输入与存储库相关联的密码。

    c. 输入 Artifactory 发布存储库的 URL,这是您在 Artifactory 服务器上的专用发布存储库。

    d. 输入 Artifactory 快照存储库的 URL,这是您在 Artifactory 服务器上的专用快照存储库。

    e. 输入用于组合多个公共和专用 Maven 存储库的镜像或公共存储库的 URL。 例如,此 URL 可能是可访问专用存储库和 Maven 中央存储库高速缓存的 Artifactory 服务器上虚拟存储库的 URL。

  7. 单击创建集成

  8. 第三方工具 卡上,单击要使用的 Artifactory 存储库的 Artifactory 工具集成。 这将打开 Artifactory Web 站点,您可在其中查看存储库的内容。

  9. 可选:如果您在 IBM Cloud Public 上使用工具链,并且想要使用 Artifactory 与 npm 来构建应用程序,请配置管道以添加 npm 构建作业。 有关配置构建作业的指示信息,请参阅在管道中配置 Artifactory npm 构建作业一节。

  10. 可选:如果您在 IBM Cloud Public 上使用工具链,并且想要使用 Artifactory 与 Maven 来构建应用程序,请配置管道以添加 Maven 构建作业。 有关配置构建作业的指示信息,请参阅在管道中配置 Artifactory Maven 构建作业一节。

在管道中配置 Artifactory npm 构建作业

在管道中配置 npm 构建作业之前,您必须具有可使用构建 SCM 存储库作为输入的工作管道。 还必须为工具链配置 Artifactory。 有关配置 Artifactory 的指示信息,请参阅 Artifactory 一节。

配置 Delivery Pipeline 以添加 npm 构建作业:

  1. 创建阶段并设置适当 SCM 存储库的输入。

  2. 在阶段上,添加构建作业。

  3. 配置构建作业:

    npm build
    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 存储库。

  4. 单击保存。 管道无论何时运行,此构建作业都会使用 Artifactory 工具集成中的配置信息来连接到您的 npm 注册表。

在管道中配置 Artifactory Maven 构建作业

在管道中配置 Maven 构建作业之前,您需要可使用构建 SCM 存储库作为输入的工作管道,并且您必须为工具链配置 Artifactory。 有关配置 Artifactory 的指示信息,请参阅 Artifactory 一节。

配置 Delivery Pipeline 以添加 Maven 构建作业:

  1. 创建阶段并设置适当 SCM 存储库的输入。

  2. 在阶段上,添加构建作业。

  3. 配置构建作业:

    Maven 构建工作
    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 和用户凭证。

  4. 单击保存。 管道无论何时运行,此构建作业都会使用 Artifactory 工具集成中的配置信息来连接到您的 Maven 存储库。

使用 API 配置 Artifactory

工具 Artifactory 集成支持以下配置参数,您可在 创建读取更新工具集成时 通过工具链 HTTP API 和 SDK 使用这些参数。

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

Artifactory工具集成参数
参数 用途 类型 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 存储库的用户标识或电子邮件地址。