配置 Nexus
配置 Nexus 资源库管理器,将构建工件存储在 Nexus 资源库(repo)中。
-
如果您在创建工具链时配置此工具集成,请在“可配置的集成”部分中,单击 Nexus。
-
如果您有一个工具链并要将此工具集成添加到其中,请从IBM Cloud控制台单击菜单图标
>平台自动化>工具链。 在“工具链”页面,单击工具链打开其“概述”页面。 或者,在应用程序“概述”页面的“持续交付”卡上,单击查看工具链。 然后,单击概述。
a. 单击添加工具。
b. 在“工具集成”部分中,单击 Nexus。
-
输入此 Nexus 工具集成实例的名称。
-
输入在您单击工具链中 Nexus 卡时想要打开的 Nexus 存储库的 URL。
-
选择您要连接到的存储库类型。
-
如果您选择了 npm 注册表,请遵循以下步骤:
a. 输入与注册表相关联的电子邮件地址。
b. 输入与注册表相关联的认证令牌。
c. 输入 Nexus 发布存储库的 URL,这是您在 Nexus 服务器上的专用注册表。
d. 输入用于组合多个公共和专用 npm 注册表的镜像或公共注册表的 URL。 例如,此 URL 可能是可访问专用注册表和 npm 全局注册表高速缓存的 Nexus 服务器上虚拟注册表的 URL。
-
如果您选择了 Maven 存储库,请遵循以下步骤:
a. 输入与存储库相关联的用户标识。
b. 输入与存储库相关联的密码。
c. 输入 Nexus 发布存储库的 URL,这是您在 Nexus 服务器上的专用发布存储库。
d. 输入 Nexus 快照存储库的 URL,这是您在 Nexus 服务器上的专用快照存储库。
e. 输入用于组合多个公共和专用 Maven 存储库的镜像或公共存储库的 URL。 例如,此 URL 可能是可访问专用存储库和 Maven 中央存储库高速缓存的 Nexus 服务器上虚拟存储库的 URL。
-
单击创建集成。
-
在工具链的“概述”页面的 第三方工具 卡上,单击要使用的 Nexus 存储库。 这将打开 Nexus Web 站点,您可在其中查看存储库的内容。
-
可选:如果您在 IBM Cloud Public 中使用工具链,并且想要使用 Nexus 与 npm 来构建应用程序,请配置管道以添加 npm 构建作业。 有关配置构建作业的指示信息,请参阅在管道中配置 Nexus npm 构建作业一节。
-
可选:如果您在 IBM Cloud Public 中使用工具链,并且想要使用 Nexus 与 Maven 来构建应用程序,请配置管道以添加 Maven 构建作业。 有关配置构建作业的指示信息,请参阅在管道中配置 Nexus Maven 构建作业一节。
在管道中配置 Nexus npm 构建作业
在管道中配置 npm 构建作业之前,您需要可使用构建 SCM 存储库作为输入的工作管道,并且您必须为工具链配置 Nexus。 有关配置 Nexus 的指示信息,请参阅 Nexus 一节。
配置 Delivery Pipeline 以添加 npm 构建作业:
-
创建阶段并设置适当 SCM 存储库的输入。
-
在阶段上,添加构建作业。
-
配置构建作业:
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 存储库。 -
单击保存。 管道无论何时运行,此构建作业都会使用 Nexus 工具集成中的配置信息来连接到您的 npm 注册表。
在管道中配置 Nexus Maven 构建作业
在管道中配置 Maven 构建作业之前,您需要可使用构建 SCM 存储库作为输入的工作管道,并且您必须为工具链配置 Nexus。 有关配置 Nexus 的指示信息,请参阅 Nexus 一节。
配置 Delivery Pipeline 以添加 Maven 构建作业:
-
创建阶段并设置适当 SCM 存储库的输入。
-
在阶段上,添加构建作业。
-
配置构建作业:
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 和用户凭证。
-
单击保存。 管道无论何时运行,此构建作业都会使用 Nexus 工具集成中的配置信息来连接到您的 Maven 存储库。
使用 API 配置 Nexus
Nexus 工具集成支持以下配置参数,当您 创建,读取和 更新 工具集成时,可以将这些参数与 工具链 HTTP API 和 SDK 配合使用。
必须在请求主体中使用 nexus
值指定 tool_type_id
属性。
参数 | 用途 | 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 存储库进行认证的用户标识或电子邮件地址。 |