如何将 Automation Pipelines 与 Gerrit 集成
Automation Pipelines
与 Gerrit 集成Automation Pipelines
支持在 Gerrit 项目中进行代码审阅时触发管道。适用于 Gerrit 的触发器定义包含 Gerrit 项目以及必须对各种事件类型运行的管道。 - 确认您可以访问要连接到的 Gerrit 服务器。
- 验证您是Automation Pipelines中项目的成员。如果您不是成员，则让Automation Pipelines管理员将您添加为项目的成员。请参见如何在 Automation Pipelines 中添加项目。
适用于 Gerrit 的触发器会在将监控的 Gerrit 服务器中使用 Gerrit 侦听器。要在
Automation Pipelines
中定义 Gerrit 端点，需要选择项目，并输入 Gerrit 服务器的 URL。然后，在该服务器上创建 Gerrit 侦听器时指定该端点。 如果在启用了 FIPS 的
VMware Aria Automation
实例中使用 Gerrit 服务器作为 Automation Pipelines
端点，则必须验证 Gerrit 配置文件是否包含正确的消息身份验证密钥。如果 Gerrit 服务器配置文件不包含正确的消息身份验证密钥，则服务器将无法正确启动，并显示以下消息：PrivateKey/PassPhrase is incorrect
以下过程说明如何定义可在 Gerrit 侦听器定义中使用的 Gerrit 端点。如果需要编辑端点，过程结束时有一个可选步骤说明如何以及何时执行更新。
- 定义 Gerrit 端点。
- 单击，然后单击新建端点。
- 选择一个项目，并为端点类型选择Gerrit。然后输入名称和描述。
- 如果该端点是基础架构中的关键业务组件，请启用标记为受限制。
- 输入 Gerrit 服务器的 URL。要使用默认端口，您可以提供带有 URL 的端口号或将该值留空。
- 输入 Gerrit 服务器的用户名和密码。如果密码必须加密，请单击创建变量，然后选择类型：
- 机密。当具有任何角色的用户运行管道时，密码进行解析。
- 受限制。当具有管理员角色的用户运行管道时，密码进行解析。
对于值，输入必须安全的密码，例如 Jenkins 服务器的密码。 - 对于私钥，输入用于安全访问 Gerrit 服务器的 SSH 密钥。此密钥是位于.ssh目录中的 RSA 私钥。
- 如果密码短语与该私钥关联，请输入密码短语。要对密码短语进行加密，请单击创建变量，然后选择类型：
- 机密。当具有任何角色的用户运行管道时，密码进行解析。
- 受限制。当具有管理员角色的用户运行管道时，密码进行解析。
对于值，必须输入安全的密码短语，例如 SSH 服务器的密码短语。
- 单击验证，然后验证Automation Pipelines中的 Gerrit 端点是否连接到 Gerrit 服务器。如果未连接，请更正任何错误，然后再次单击验证。
- 单击创建。
- 验证VMware Aria Automation环境是否启用了 FIPS，或者让 Jenkins 作业使用 Jenkins URL 创建启用了 FIPS 的环境。
- 要从命令行运行命令，请通过 SSH 连接到VMware Aria Automation8.x 设备，然后以 root 用户身份登录。例如，在端口 22、5480 或 443 上连接到完全限定域名 URL，例如https://cava-1-234-567.yourcompanyFQDN.com。
- 要检查VMware Aria Automation上的 FIPS，请运行命令vracli security fips。
- 验证命令是否返回FIPS mode: strict。
- 如果 Gerrit 服务器是启用了 FIPS 的VMware Aria Automation实例中的端点，请确保 Gerrit 配置文件包含正确的消息身份验证 (MAC) 密钥。
- 打开 Gerrit 并创建 SSH 密钥对。
- 在'$site_path'/etc/gerrit.config中找到 Gerrit 服务器配置文件。
- 验证 Gerrit 服务器配置文件是否包含一个或多个消息身份验证代码 (MAC) 密钥，hmac-MD5除外。在 FIPS 模式下，hmac-MD5不是受支持的 MAC 算法。为确保 Gerrit 服务器正常启动，Gerrit 服务器配置文件必须排除此算法。如果 Gerrit 服务器未正确启动，则会显示以下消息：PrivateKey/PassPhrase is incorrect以加号 (+) 开头的受支持消息身份验证代码 (MAC) 密钥名称处于启用状态。以连字符 (-) 开头的 MAC 密钥名称将从默认 MAC 列表中移除。默认情况下，这些受支持的 MAC 可在Automation Pipelines中用于 Gerrit 服务器：
- hmac-md5-96
- hmac-sha1
- hmac-sha1-96
- hmac-sha2-256
- hmac-sha2-512
- 在更新 Gerrit 端点（例如更改 URL 或私钥）之前，请检查该端点是否已连接到 Gerrit 侦听器。
- 如果该端点未连接到 Gerrit 侦听器，请执行以下步骤以更新该端点：
- 单击，然后单击要更新的端点上的打开。
- 更新端点定义。
- 单击验证，验证Automation Pipelines中的 Gerrit 端点是否连接到 Gerrit 服务器。
- 单击保存。
- 如果该端点已连接到 Gerrit 侦听器，请执行以下步骤以更新端点：
- 将任何连接的 Gerrit 侦听器断开连接。请参见如何使用 Automation Pipelines 中的 Gerrit 触发器运行管道。
- 执行以下步骤以配置新端点。
- 验证并保存更新的端点定义。
- 再次连接 Gerrit 侦听器。
如果 Gerrit 侦听器未断开连接，可能是因为当前 Gerrit 端点值已更改，侦听器无法再与 Gerrit 服务器通信。如果出现此问题，请先在端点定义中进行更改，以便侦听器可以与 Gerrit 服务器通信。然后再断开 Gerrit 侦听器的连接并重新连接。
要了解更多信息，请参见其他节。请参见如何使用 Automation Pipelines 中的 Gerrit 触发器运行管道。