如何将 Automation Pipelines 与 Gerrit 集成

Automation Pipelines 支持在 Gerrit 项目中进行代码审阅时触发管道。适用于 Gerrit 的触发器定义包含 Gerrit 项目以及必须对各种事件类型运行的管道。

适用于 Gerrit 的触发器会在将监控的 Gerrit 服务器中使用 Gerrit 侦听器。要在 Automation Pipelines 中定义 Gerrit 端点，需要选择项目，并输入 Gerrit 服务器的 URL。然后，在该服务器上创建 Gerrit 侦听器时指定该端点。

以下过程说明如何定义可在 Gerrit 侦听器定义中使用的 Gerrit 端点。如果需要编辑端点，过程结束时有一个可选步骤说明如何以及何时执行更新。

前提条件

如果使用内部部署 Gerrit 服务器，请确认您能够访问 Automation Assembler，以便添加云代理。有关示例，请参见设置 Automation Pipelines 以对发布流程进行建模。
验证您是 Automation Pipelines 中项目的成员。如果您不是成员，则让 Automation Pipelines 管理员将您添加为项目的成员。请参见如何在 Automation Pipelines 中添加项目。

过程

定义 Gerrit 端点。
1. 单击配置 > 端点，然后单击新建端点。
2. 选择一个项目，并为端点类型选择 Gerrit。然后输入名称和描述。
3. 如果该端点是基础架构中的关键业务组件，请启用标记为受限制。
4. 输入 Gerrit 服务器的 URL。
  要使用默认端口，您可以提供带有 URL 的端口号或将该值留空。
5. 输入 Gerrit 服务器的用户名和密码。
  如果密码必须加密，请单击创建变量，然后选择类型：
  - 机密。当具有任何角色的用户运行管道时，密码进行解析。
  - 受限制。当具有管理员角色的用户运行管道时，密码进行解析。
  对于值，输入必须安全的密码，例如 Jenkins 服务器的密码。
6. 对于私钥，输入用于安全访问 Gerrit 服务器的 SSH 密钥。
  此密钥是位于 .ssh 目录中的 RSA 私钥。
7. （可选） 如果密码短语与该私钥关联，请输入密码短语。
  要对密码短语进行加密，请单击创建变量，然后选择类型：
  - 机密。当具有任何角色的用户运行管道时，密码进行解析。
  - 受限制。当具有管理员角色的用户运行管道时，密码进行解析。
  对于值，必须输入安全的密码短语，例如 SSH 服务器的密码短语。
单击验证，然后验证 Automation Pipelines 中的 Gerrit 端点是否连接到 Gerrit 服务器。
如果未连接，请更正任何错误，然后再次单击验证。
单击创建。
（可选） 在更新 Gerrit 端点（例如更改 URL 或私钥）之前，请检查该端点是否已连接到 Gerrit 侦听器。
- 如果该端点未连接到 Gerrit 侦听器，请执行以下步骤以更新该端点：
  1. 单击配置 > 端点，然后单击要更新的端点上的打开。
  2. 更新端点定义。
  3. （可选） 如果要更改云代理，请重新启动一次旧云代理以移除任何旧连接，然后再启动新的云代理并建立新连接。
  4. 单击验证，验证 Automation Pipelines 中的 Gerrit 端点是否连接到 Gerrit 服务器。
  5. 单击保存。
- 如果该端点已连接到 Gerrit 侦听器，请执行以下步骤以更新端点：
  1. 将任何连接的 Gerrit 侦听器断开连接。请参见如何使用 Automation Pipelines 中的 Gerrit 触发器运行管道。
  2. 执行以下步骤以配置新端点。
  3. （可选） 如果要更改云代理，请重新启动一次旧云代理以移除任何旧连接，然后再启动新的云代理并建立新连接。
  4. 验证并保存更新的端点定义。
  5. 再次连接 Gerrit 侦听器。
  注：如果 Gerrit 侦听器未断开连接，可能是因为当前 Gerrit 端点值已更改，侦听器无法再与 Gerrit 服务器通信。如果出现此问题，请先在端点定义中进行更改，以便侦听器可以与 Gerrit 服务器通信。然后再断开 Gerrit 侦听器的连接并重新连接。

下一步做什么

要了解更多信息，请参见其他节。请参见如何使用 Automation Pipelines 中的 Gerrit 触发器运行管道。