IBM Cloud Docs
配置 Nexus

配置 Nexus

配置 Nexus 资源库管理器,将构建工件存储在 Nexus 资源库(repo)中。

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

  2. 如果您有一个工具链并要将此工具集成添加到其中,请从IBM Cloud控制台单击菜单图标汉堡包图标>平台自动化>工具链。 在“工具链”页面,单击工具链打开其“概述”页面。 或者,在应用程序“概述”页面的“持续交付”卡上,单击查看工具链。 然后,单击概述

    a. 单击添加工具

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

  3. 输入此 Nexus 工具集成实例的名称。

  4. 输入在您单击工具链中 Nexus 卡时想要打开的 Nexus 存储库的 URL。

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

  6. 如果您选择了 npm 注册表,请遵循以下步骤:

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

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

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

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

  7. 如果您选择了 Maven 存储库,请遵循以下步骤:

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

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

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

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

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

  8. 单击创建集成

  9. 在工具链的“概述”页面的 第三方工具 卡上,单击要使用的 Nexus 存储库。 这将打开 Nexus Web 站点,您可在其中查看存储库的内容。

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

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

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

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

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

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

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

  3. 配置构建作业:

    npm build
    build

    a. 对于构建器类型,请选择 npm(Artifactory 或 Nexus)

    b. 如果已配置 Nexus 工具集成的多个实例,请输入要为其配置 npm 构建作业的 Nexus 工具集成的名称。

    c. 对于工具集成类型,请选择 Nexus

    d. 对于构建命令,请输入用于构建 npm 模块或将其发布到注册表的命令。 此示例显示构建模块或进行发布的命令。

    npm install
    # or
    npm publish --registry "${NPM_RELEASE_URL}"
    

    您可以在 Nexus 工具集成的配置设置中,查找用于连接到注册表的 URL 和用户凭证。

    e. 如果您的构建作业发布到 Nexus 注册表且您节点模块版本的格式为 x.y.z-SNAPSHOT.w,请选中递增快照模块版本复选框。 构建作业会在作业发布到 Nexus 注册表之前,自动更新模块版本。 构建作业会从 npm 注册表和本地 package.json 文件中选择最高的模块版本,并使用 semver 递增模块版本。 构建作业不会将更改交付到 SCM 存储库。

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

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

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

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

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

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

  3. 配置构建作业:

    Maven 构建工作
    Maven 构建
    *

    a. 对于构建器类型,请选择 Maven(Artifactory、Nexus 或 SonarQube)

    b. 如果已配置 Nexus 工具集成的多个实例,请输入要为其配置 Maven 构建作业的 Nexus 工具集成的名称。

    c. 对于工具集成类型,请选择 Nexus

    d. 对于构建命令,请输入用于构建 Maven 模块或将其发布到快照注册表的命令。 此示例显示构建模块或进行发布的命令。

    mvn -B clean package
    # or
    mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
    

    您可以在 Nexus 工具集成的配置设置中,查找用于连接到注册表的 URL 和用户凭证。

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

使用 API 配置 Nexus

Nexus 工具集成支持以下配置参数,当您 创建读取更新 工具集成时,可以将这些参数与 工具链 HTTP API 和 SDK 配合使用。

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

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