Red Hat Ansible Automation Platform 自动化网格用于基于 Operator 的安装

1. 您需要一个 Red Hat Enterprise Linux 操作系统。网格中的每个节点都需要静态 IP 地址，或者自动化控制器可访问的 DNS 主机名。
2. 在继续操作前，请确保您具有 RHEL 虚拟机的最低要求。如需更多信息，请参阅 Red Hat Ansible Automation Platform 系统要求。

3. 在需要通信的远程网络中部署 RHEL 实例。有关创建虚拟机的详情，请参考 Red Hat Enterprise Linux 文档中的 创建虚拟机。请记住，以足够的方式扩展虚拟机的容量，以便您的提议的任务可以在它们上运行。

   • RHEL ISO 可以从 access.redhat.com 获取。
   • 可以使用来自 console.redhat.com 的镜像构建器构建 RHEL 云镜像。

流程

1. SSH 到每个 RHEL 实例并执行以下步骤。根据您的网络访问和控制，可能需要 SSH 代理或其他访问模型。

   使用以下命令：

   ssh [username]@[host_ip_address]

   例如，对于在 Amazon Web Services 上运行的 Ansible Automation Platform 实例。

   ssh ec2-user@10.0.0.6

2. 创建或复制可用于从跃点节点连接到执行节点的 SSH 密钥。这可以是仅用于自动化网格配置的临时密钥，也可以是长期的密钥。后续步骤中使用 SSH 用户和密钥。

3. 使用 baseos 和 appstream 软件仓库启用 RHEL 订阅。Ansible Automation Platform RPM 存储库只能通过 subscription-manager 提供，不适用于 Red Hat Update Infrastructure (RHUI)。如果您试图使用其它 Linux 占用空间，包括带有 RHUI 的 RHEL，这会导致错误。

   sudo subscription-manager register --auto-attach

   如果为您的帐户启用了简单内容访问，请使用：

   sudo subscription-manager register

   有关简单内容访问的更多信息，请参阅开始使用简单内容访问。

4. 启用 Ansible Automation Platform 订阅和正确的 Red Hat Ansible Automation Platform 频道：

   # subscription-manager repos --enable ansible-automation-platform-2.4-for-rhel-8-x86_64-rpms for RHEL 8
   
   # subscription-manager repos --enable ansible-automation-platform-2.4-for-rhel-9-x86_64-rpms for RHEL 9

5. 确定软件包为最新版本：

   sudo dnf upgrade -y

6. 安装 ansible-core 软件包：

   sudo dnf install -y ansible-core

流程

1. 在导航面板中，选择 Administration → Instances。

2. 在 Instances 列表页面中，单击 Add。Create new Instance 窗口将打开。

   

   实例需要以下属性：

   • 主机名 ：（必需）为您的实例输入完全限定域名（公共 DNS）或 IP 地址。此字段等同于基于安装程序部署 的主机名。

     注意

     如果实例使用无法从控制集群解析的私有 DNS，DNS 查找路由会失败，并且生成的 SSL 证书无效。改为使用 IP 地址。

   • 可选： 描述 ：输入实例的描述。
   • Instance State ：此字段已自动填充，表示它正在安装，且无法修改。
   • 侦听器 端口 ：此端口用于 receptor 侦听进入的连接。您可以将端口设置为适合您的配置的端口。此字段等同于 API 中的 listener_port。默认值为 27199，但您可以设置自己的端口值。

   • 实例类型 ：只能创建 execution 和 hop 节点。基于 Operator 的部署不支持控制或混合节点。

     选项：

     • 启用实例 ：选中此框，使它可用于在执行节点上运行。
     • 选中 Managed by Policy 复选框，以启用策略来确定如何分配实例。

     • 从控制节点框中选中 Peers，以启用控制节点自动到此实例的对等点。对于连接到自动化控制器的节点，请选中 Peers from Control nodes 复选框，以在该节点和自动化控制器之间创建直接通信链接。对于所有其他节点：

       • 如果您没有添加跃点节点，请确保 检查来自 Control 的 Peers。
       • 如果要添加跃点节点，请确保没有 检查来自 Control 的 Peers。
       • 对于与跃点节点通信的执行节点，请不要选中此框。

     • 要将执行节点与跃点节点对等，点 Peers 字段旁边的 图标。

       此时会显示 Select Peers 窗口。

       将执行节点与跃点节点对等。

3. 点击 Save。

   

4. 要查看更新拓扑的图形表示，请参阅 Topology viewer。

   注意

   从任何可通过 SSH 访问新创建的实例的计算机执行以下步骤。

5. 点 Install Bundle 旁边的 图标下载包含这个新实例的 tar 文件，以及将创建的节点安装到自动化网格中所需的文件。

   

   安装捆绑包包含 TLS 证书和密钥、证书颁发机构和正确的 Receptor 配置文件。

   receptor-ca.crt
   work-public-key.pem
   receptor.key
   install_receptor.yml
   inventory.yml
   group_vars/all.yml
   requirements.yml

6. 从您下载的位置中提取下载的 tar.gz Install Bundle。为确保这些文件位于远程机器上的正确位置，安装捆绑包包含 install_receptor.yml playbook。playbook 需要 Receptor 集合。运行以下命令以下载集合：

   ansible-galaxy collection install -r requirements.yml

7. 在运行 ansible-playbook 命令前，请编辑 inventory.yml 文件中的以下字段：

   all:
     hosts:
       remote-execution:
         ansible_host: 10.0.0.6
         ansible_user: <username> # user provided
     ansible_ssh_private_key_file: ~/.ssh/<id_rsa>

   • 确保 ansible_host 设置为节点的 IP 地址或 DNS。
   • 将 ansible_user 设置为运行安装的用户名。
   • 将 ansible_ssh_private_key_file 设置为包含用于连接实例的私钥的文件名。
   • inventory.yml 文件的内容充当模板，其中包含在网格拓扑中安装和配置 receptor 节点期间应用的角色的变量。您可以修改一些其他字段，或者在高级场景中完全替换该文件。如需更多信息，请参阅 角色变量。

8. 对于使用私有 DNS 的节点，请将以下行添加到 inventory.yml 中：

    ansible_ssh_common_args: <your ssh ProxyCommand setting>

   这指示 install-receptor.yml playbook 使用 proxy 命令通过本地 DNS 节点连接到私有节点。

9. 配置属性后，单击 Save。所创建的实例的 Details 页面将打开。
10. 保存文件以继续。

11. 运行安装捆绑包的系统来设置远程节点并运行 ansible-playbook 需要安装 ansible.receptor 集合：

    ansible-galaxy collection install ansible.receptor

    or

    ansible-galaxy install -r requirements.yml

    • 从 requirements.yml 文件安装 receptor 集合依赖项会持续检索指定的 receptor 版本。另外，它会检索将来可能需要的任何其他集合依赖项。
    • 在运行 playbook 的所有节点上安装 receptor 集合，否则会出现错误。

12. 如果定义了 receptor_listener_port，机器还需要一个可用的开放端口来建立入站 TCP 连接，例如 27199。运行以下命令，为 receptor 通讯打开端口 27199 ：

    sudo firewall-cmd --permanent --zone=public --add-port=27199/tcp

    注意

    可能是有些服务器没有侦听 receptor 端口（默认值为 27199）

    假设您有一个带有节点 A、B、C、D 的 Control plane

    RPM 安装程序使用最低特权方法在 control plane 节点之间创建高度连接的对等点，并仅在需要它的那些节点上打开 tcp 侦听器。所有 receptor 连接都是双向的，因此在创建连接后，receptor 可以在两个方向通信。

    以下是三个控制器节点的对等设置示例：

    Controller 节点 A -→ Controller 节点 B

    Controller 节点 A -→ Controller 节点 C

    Controller 节点 B -→ Controller 节点 C

    您可以通过设置强制监听程序

    receptor_listener=True

    但是，连接 Controller B -→ A 可能会被拒绝，因为连接已存在。

    这意味着没有连接到 Controller A，因为 Controller A 会创建与其他节点的连接，以下命令不会在 Controller A 上返回任何内容：

    [root@controller1 ~]# ss -ntlp | grep 27199 [root@controller1 ~]#

13. 在您要更新自动化网格的机器上运行以下 playbook：

    ansible-playbook -i inventory.yml install_receptor.yml

    此 playbook 运行后，您的自动化网格会被配置。

    

流程

1. 在导航面板中，选择 Administration → Instance Groups。
2. 从 Add instance group 列表中选择 Add。

3. 在以下字段中输入相关信息：

   • 名称 ：名称必须是唯一的，且不能命名为 "controller"。
   • 策略实例最小值 ：在新实例上线时，自动分配给此组的最少实例数量。

   • 策略实例百分比 ：使用滑块来选择在新实例上线时自动分配给此组的最小实例百分比。

     注意

     创建新实例组时不需要策略实例字段。如果没有指定值，则 Policy 实例最小值 和 Policy 实例百分比 默认为 0。

   • 最大并发作业 ：指定可为任何给定作业运行的最大 fork 数量。

   • 最大 fork ：指定可为任何给定作业运行的最大并发作业数。

     注意

     Max concurrent jobs 和 Max forks 的默认值 0 表示没有限制。如需更多信息，请参阅 自动化控制器管理指南中的 实例组容量限制。

4. 点击 Save。

流程

1. 选择 Instance Groups 窗口的 Instances 选项卡。
2. 点关联。

3. 点击列表中一个或多个可用实例旁边的复选框，以选择要与实例组关联的实例：

   

4. 在以下示例中，添加到实例组中的实例以及其容量的信息：

   

流程

1. Templates 列表视图显示当前可用的作业模板。在此屏幕中，您可以启动 ，编辑 ，并复制 工作流作业模板。
2. 选择您想要的作业并点击 图标。
3. 选择您要运行作业的实例组。 请注意，系统管理员必须授予您或团队权限才能在作业模板中使用实例组。如果您选择了多个作业模板，则选择它们的顺序会设置执行优先级。
4. 点击 Next。
5. 点 Launch。

流程

1. 使用以下命令创建 secret：

   oc create secret generic ee-pull-secret \
        --from-literal=username=<username> \
        --from-literal=password=<password> \
        --from-literal=url=registry.redhat.io
   
   oc edit automationcontrollers <instance name>

2. 使用以下命令将 ee_pull_credentials_secret 和 ee-pull-secret 添加到规格中：

   spec.ee_pull_credentials_secret=ee-pull-secret

3. 要从自动化控制器 UI 管理实例，必须具有 System Administrator 或 System Auditor 权限。

流程

1. 检查当前的 receptor 版本：

   receptor --version

2. 更新 receptor：

   sudo dnf update ansible-runner receptor -y

   注意

   要升级所有软件包（不仅仅是 receptor），请使用 dnf update，然后重启。

3. 验证安装。更新完成后，再次检查 receptor 版本以验证更新：

   receptor --version

4. 重启 receptor 服务：

   sudo systemctl restart receptor

5. 确保 receptor 正常工作，并正确连接到系统中的控制器或其他节点。