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

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

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