使用 RHEL 7.9 中的 RHEL 系统角色自动化系统管理

流程

1. 安装 rhel-system-roles 软件包：

   [root@control-node]# yum install rhel-system-roles

   Copy to Clipboard Toggle word wrap

   此命令将 ansible-core 软件包安装为依赖项。

2. 创建名为 ansible 的用户，以管理并运行 playbook：

   [root@control-node]# useradd ansible

   Copy to Clipboard Toggle word wrap

3. 切换到新创建的 ansible 用户：

   [root@control-node]# su - ansible

   Copy to Clipboard Toggle word wrap

   以这个用户身份执行其余步骤。

4. 创建一个 SSH 公钥和私钥：

   [ansible@control-node]$ ssh-keygen
   Generating public/private rsa key pair.
   Enter file in which to save the key (/home/ansible/.ssh/id_rsa): <password>
   ...

   Copy to Clipboard Toggle word wrap

   为密钥文件使用推荐的默认位置。

5. 可选： 要防止 Ansible 每次建立连接时提示您输入 SSH 密钥密码，请配置 SSH 代理。

6. 使用以下内容创建 ~/.ansible.cfg 文件：

   [defaults]
   inventory = /home/ansible/inventory
   remote_user = ansible
   
   [privilege_escalation]
   become = True
   become_method = sudo
   become_user = root
   become_ask_pass = True

   Copy to Clipboard Toggle word wrap
   注意

   ~/.ansible.cfg 文件中的设置具有更高的优先级，并覆盖全局 /etc/ansible/ansible.cfg 文件中的设置。

   使用这些设置，Ansible 执行以下操作：

   • 管理指定清单文件中的主机。
   • 当帐户建立到受管节点的 SSH 连接时，请使用 remote_user 参数中设置的帐户。
   • 使用 sudo 工具，以 root 用户身份在受管节点上执行任务。
   • 每次应用 playbook 时，都会提示输入远程用户的 root 密码。出于安全考虑，建议使用它。

7. 创建一个列出受管主机主机名的 INI 或 YAML 格式的 ~/inventory 文件。您还可以在清单文件中定义主机组。例如，以下是 INI 格式的清单文件，它有三个主机，以及一个名为 US 的主机组：

   managed-node-01.example.com
   
   [US]
   managed-node-02.example.com ansible_host=192.0.2.100
   managed-node-03.example.com

   Copy to Clipboard Toggle word wrap

   请注意，控制节点必须能够解析主机名。如果 DNS 服务器无法解析某些主机名，请在主机条目旁边添加 ansible_host 参数来指定其 IP 地址。

流程

1. 创建一个名为 ansible 的用户：

   [root@managed-node-01]# useradd ansible

   Copy to Clipboard Toggle word wrap

   控制节点稍后使用这个用户建立与这个主机的 SSH 连接。

2. 为 ansible 用户设置密码：

   [root@managed-node-01]# passwd ansible
   Changing password for user ansible.
   New password: <password>
   Retype new password: <password>
   passwd: all authentication tokens updated successfully.

   Copy to Clipboard Toggle word wrap

   当 Ansible 使用 sudo 以 root 用户身份执行任务时，您必须输入此密码。

3. 在受管主机上安装 ansible 用户的 SSH 公钥：

   1. 以 ansible 用户身份登录控制节点，并将 SSH 公钥复制到受管节点：

      [ansible@control-node]$ ssh-copy-id managed-node-01.example.com
      /usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "/home/ansible/.ssh/id_rsa.pub"
      The authenticity of host 'managed-node-01.example.com (192.0.2.100)' can't be established.
      ECDSA key fingerprint is SHA256:9bZ33GJNODK3zbNhybokN/6Mq7hu3vpBXDrCxe7NAvo.

      Copy to Clipboard Toggle word wrap

   2. 提示时，输入 yes 进行连接：

      Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
      /usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
      /usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys

      Copy to Clipboard Toggle word wrap

   3. 提示时，输入密码：

      ansible@managed-node-01.example.com's password: <password>
      
      Number of key(s) added: 1
      
      Now try logging into the machine, with:   "ssh '<managed-node-01.example.com>'"
      and check to make sure that only the key(s) you wanted were added.

      Copy to Clipboard Toggle word wrap

   4. 通过在控制节点上远程执行命令来验证 SSH 连接：

      [ansible@control-node]$ ssh <managed-node-01.example.com> whoami
      ansible

      Copy to Clipboard Toggle word wrap

4. 为 ansible 用户创建一个 sudo 配置：

   1. 使用 visudo 命令创建并编辑 /etc/sudoers.d/ansible 文件：

      [root@managed-node-01]# visudo /etc/sudoers.d/ansible

      Copy to Clipboard Toggle word wrap

      在正常编辑器中使用 visudo 的好处是，该实用程序提供基本的健全检查和检查是否有解析错误，然后再安装该文件。

   2. 在 /etc/sudoers.d/ansible 文件中配置满足您要求的 sudoers 策略，例如：

      • 要为 ansible 用户授予权限，以便在输入 ansible 用户密码后以此主机上的任何用户和组身份运行所有命令，请使用：

        ansible ALL=(ALL) ALL

        Copy to Clipboard Toggle word wrap

      • 要向 ansible 用户授予权限，以便在不输入 ansible 用户密码的情况下以该主机上任何用户和组的身份运行所有命令，请使用：

        ansible ALL=(ALL) NOPASSWD: ALL

        Copy to Clipboard Toggle word wrap

   或者，配置匹配您安全要求的更精细的策略。有关 sudoers 策略的详情，请查看 sudoers(5) 手册页。

验证

1. 验证您可以是否可以在所有受管节点上执行控制节点的命令：

   [ansible@control-node]$ ansible all -m ping
   BECOME password: <password>
   managed-node-01.example.com | SUCCESS => {
       	"ansible_facts": {
       	    "discovered_interpreter_python": "/usr/bin/python3"
       	},
       	"changed": false,
       	"ping": "pong"
   }
   ...

   Copy to Clipboard Toggle word wrap

   硬编码的所有组都会动态包含清单文件中列出的所有主机。

2. 使用 Ansible command 模块在受管主机上运行 whoami 工具来验证特权升级是否正常工作：

   [ansible@control-node]$ ansible managed-node-01.example.com -m command -a whoami
   BECOME password: <password>
   managed-node-01.example.com | CHANGED | rc=0 >>
   root

   Copy to Clipboard Toggle word wrap

   如果命令返回 root，则您在受管节点上配置的 sudo 正确。

1. 运行以下命令:

   $ ansible-playbook -c local -i localhost, --check --become /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/tests/kernel_settings/tests_default.yml

   Copy to Clipboard Toggle word wrap

流程

1. 定义 Red Hat Automation Hub 作为 ansible.cfg 配置文件中内容的默认源。请参阅 将 Red Hat Automation Hub 配置为内容的主源。

2. 从 Automation Hub 安装 redhat.rhel_system_roles 集合：

   # ansible-galaxy collection install redhat.rhel_system_roles

   Copy to Clipboard Toggle word wrap

   安装完成后，角色作为 redhat.rhel_system_roles.<role_name> 提供。另外，您可以在 /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/roles/<role_name>/README.md 找到每个角色的文档。

1. 运行以下命令:

   $ ansible-playbook -c local -i localhost, --check --become /usr/share/ansible/collections/ansible_collections/redhat/rhel_system_roles/tests/kernel_settings/tests_default.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建定义所需角色的 playbook:

   1. 创建新 YAML 文件，并在文本编辑器中打开，例如：

      # vi logging-playbook.yml

      Copy to Clipboard Toggle word wrap

   2. 将以下内容插入 YAML 文件中：

      ---
      - name: Deploying basics input and implicit files output
        hosts: all
        roles:
          - redhat.rhel_system_roles.logging
        vars:
          logging_inputs:
            - name: system_input
              type: basics
          logging_outputs:
            - name: files_output
              type: files
          logging_flows:
            - name: flow1
              inputs: [system_input]
              outputs: [files_output]

      Copy to Clipboard Toggle word wrap

2. 在特定清单上执行 playbook:

   # ansible-playbook -i inventory-file logging-playbook.yml

   Copy to Clipboard Toggle word wrap

   其中：

   • inventory-file 是清单文件的名称。
   • logging-playbook.yml 是您使用的 playbook。

验证步骤

1. 测试配置文件 /etc/rsyslog.conf 和 /etc/rsyslog.d 的语法：

   # rsyslogd -N 1
   rsyslogd: version 8.1911.0-6.el8, config validation run (level 1), master config /etc/rsyslog.conf
   rsyslogd: End of config validation run. Bye.

   Copy to Clipboard Toggle word wrap

2. 验证系统是否向日志发送信息：

   1. 发送测试信息：

      # logger test

      Copy to Clipboard Toggle word wrap

   2. 查看 /var/log/messages 日志，例如：

      # cat /var/log/messages
      Aug  5 13:48:31 hostname root[6778]: test

      Copy to Clipboard Toggle word wrap

      hostname 是客户端系统的主机名。日志显示输入 logger 命令的用户的用户名，在本例中是 root。

流程

1. 创建包含以下内容的 playbook.yml 文件：

   ---
   - name: Sets which boot device will be used on next boot
     hosts: localhost
       tasks:
       - redhat.rhel_mgmt.ipmi_boot:
          name: bmc.host.example.com
            user: admin_user
            password: basics
            bootdev: hd

   Copy to Clipboard Toggle word wrap

2. 针对 localhost 执行 playbook：

   # ansible-playbook playbook.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook.yml 文件：

   ---
   - name: Turn the host on
     hosts: localhost
       tasks:
       - redhat.rhel_mgmt.ipmi_power:
          name: bmc.host.example.com
            user: admin_user
            password: basics
            state: on

   Copy to Clipboard Toggle word wrap

2. 执行 playbook：

   # ansible-playbook playbook.yml

   Copy to Clipboard Toggle word wrap

1. redfish_info ：redfish_info 模块检索有关远程 Out-Of-Band (OOB)控制器的信息，如系统清单。
2. redfish_command ：redfish_command 模块执行 Out-Of-Band (OOB)控制器操作，如日志管理和用户管理，以及电源操作，如系统重启、开机和关机。
3. redfish_config: redfish_config 模块执行 OOB 控制器操作，如更改 OOB 配置或设置 BIOS 配置。

流程

1. 创建包含以下内容的 playbook.yml 文件：

   ---
   - name: Get CPU inventory
     hosts: localhost
     tasks:
       - redhat.rhel_mgmt.redfish_info:
           baseuri: "{{ baseuri }}"
           username: "{{ username }}"
           password: "{{ password }}"
           category: Systems
           command: GetCpuInventory
         register: result

   Copy to Clipboard Toggle word wrap

2. 针对 localhost 执行 playbook：

   # ansible-playbook playbook.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook.yml 文件：

   ---
   - name: Power on system
     hosts: localhost
     tasks:
       - redhat.rhel_mgmt.redfish_command:
           baseuri: "{{ baseuri }}"
           username: "{{ username }}"
           password: "{{ password }}"
           category: Systems
           command: PowerOn

   Copy to Clipboard Toggle word wrap

2. 针对 localhost 执行 playbook：

   # ansible-playbook playbook.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook.yml 文件：

   ---
   - name: "Set BootMode to UEFI"
     hosts: localhost
     tasks:
       - redhat.rhel_mgmt.redfish_config:
           baseuri: "{{ baseuri }}"
           username: "{{ username }}"
           password: "{{ password }}"
           category: Systems
           command: SetBiosAttributes
           bios_attributes:
             BootMode: Uefi

   Copy to Clipboard Toggle word wrap

2. 针对 localhost 执行 playbook：

   # ansible-playbook playbook.yml

   Copy to Clipboard Toggle word wrap

流程

1. 另外，还可查看 清单（inventory）文件 ：

   #  cat /home/jdoe/<ansible_project_name>/inventory
   [testingservers]
   pdoe@192.168.122.98
   fdoe@192.168.122.226
   
   [db-servers]
   db1.example.com
   db2.example.com
   
   [webservers]
   web1.example.com
   web2.example.com
   192.0.2.42

   Copy to Clipboard Toggle word wrap

   该文件定义 [testingservers] 组和其他组。它允许您对特定的系统集合更有效地运行 Ansible。

2. 创建配置文件来为 Ansible 操作设置默认值和特权升级。

   1. 创建新 YAML 文件，并在文本编辑器中打开，例如：

      #  vi /home/jdoe/<ansible_project_name>/ansible.cfg

      Copy to Clipboard Toggle word wrap

   2. 将以下内容插入到文件中：

      [defaults]
      inventory = ./inventory
      
      [privilege_escalation]
      become = true
      become_method = sudo
      become_user = root
      become_ask_pass = true

      Copy to Clipboard Toggle word wrap

      [defaults] 部分指定受管主机清单文件的路径。[privilege_escalation] 部分定义用户特权转移到指定受管主机上的 root。这对成功配置内核参数是必需的。运行 Ansible playbook 时，会提示您输入用户密码。用户在连接到受管主机后，通过 sudo 自动切换为 root。

3. 创建使用 kernel_settings 角色的 Ansible playbook。

   1. 创建新 YAML 文件，并在文本编辑器中打开，例如：

      #  vi /home/jdoe/<ansible_project_name>/kernel-roles.yml

      Copy to Clipboard Toggle word wrap

      此文件代表一个 playbook，通常包含了一组有特定顺序的任务（也称为 play ）列表。这些任何会根据 inventory 文件中选择的特定管理主机进行。

   2. 将以下内容插入到文件中：

      ---
      -
        hosts: testingservers
        name: "Configure kernel settings"
        roles:
          - rhel-system-roles.kernel_settings
        vars:
          kernel_settings_sysctl:
            - name: fs.file-max
              value: 400000
            - name: kernel.threads-max
              value: 65536
          kernel_settings_sysfs:
            - name: /sys/class/net/lo/mtu
              value: 65000
          kernel_settings_transparent_hugepages: madvise

      Copy to Clipboard Toggle word wrap

      name 键是可选的。它将一个任意字符串作为标签与该 play 关联，并确定该 play 的用途。Play 中的 hosts 键指定对其运行 play 的主机。此键的值或值可以作为被管理的主机的单独名称提供，也可以作为 inventory 文件中定义的一组主机提供。

      vars 部分代表包含所选内核参数名称和值的变量列表。

      roles 键指定系统角色将配置 vars 部分中提到的参数和值。

      注意

      您可以修改 playbook 中的内核参数及其值以符合您的需要。

4. （可选）验证 play 中的语法是否正确。

   #  ansible-playbook --syntax-check kernel-roles.yml
   
   playbook: kernel-roles.yml

   Copy to Clipboard Toggle word wrap

   本例演示了对 playbook 的成功验证。

5. 执行 playbook。

   #  ansible-playbook kernel-roles.yml
   
   ...
   
   BECOME password:
   
   PLAY [Configure kernel settings] **********************************************************************************
   
   
   
   PLAY RECAP ********************************************************************************************************
   fdoe@192.168.122.226       : ok=10   changed=4    unreachable=0    failed=0    skipped=6    rescued=0    ignored=0
   pdoe@192.168.122.98        : ok=10   changed=4    unreachable=0    failed=0    skipped=6    rescued=0    ignored=0

   Copy to Clipboard Toggle word wrap

   在 Ansible 运行 playbook 之前，会提示您输入密码，因此在受管主机上的用户能够切换到 root，这对于配置内核参数是必需的。

   recap 部分显示 play 成功完成所有受管主机 (failed=0)，并且已应用了 4 个内核参数 (changed=4)。

6. 重启您的受管主机并检查受影响的内核参数,以验证是否应用了更改并在重启后保留。

流程

1. 创建一个 vault 来保存敏感信息：

   $ ansible-vault create secrets.yml
   New Vault password: password
   Confirm New Vault password: password

   Copy to Clipboard Toggle word wrap

2. ansible-vault create 命令会创建一个加密的 vault 文件，并在编辑器中打开它。输入您要保存在密码库中的敏感数据，例如：

   activationKey: activation_key
   username: username
   password: password

   Copy to Clipboard Toggle word wrap

3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

   之后，您可以使用 ansible-vault edit secrets.yml 命令编辑 vault 中的数据。

4. 可选：显示 vault 内容：

   $ ansible-vault view secrets.yml

   Copy to Clipboard Toggle word wrap

5. 创建一个 playbook 文件，如 ~/registration.yml，并根据您要执行的操作使用以下选项之一：

   1. 要使用激活码和机构 ID （推荐）注册，请使用以下 playbook：

      ---
      - name: Registering system using activation key and organization ID
        hosts: managed-node-01.example.com
        vars_files:
          - secrets.yml
        vars:
          rhc_auth:
            activation_keys:
              keys:
                -  "{{ activationKey }}"
           rhc_organization: organizationID
        roles:
          - role: rhel-system-roles.rhc

      Copy to Clipboard Toggle word wrap

   2. 要使用用户名和密码注册，请使用以下 playbook：

      ---
      - name: Registering system with username and password
        hosts:  managed-node-01.example.com
        vars_files:
          - secrets.yml
        vars:
          rhc_auth:
            login:
              username: "{{ username }}"
              password: "{{ password }}"
        roles:
          - role: rhel-system-roles.rhc

      Copy to Clipboard Toggle word wrap

6. 运行 playbook：

   # ansible-playbook ~/registration.yml --ask-vault-pass

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 vault 来保存敏感信息：

   $ ansible-vault create secrets.yml
   New Vault password: password
   Confirm New Vault password: password

   Copy to Clipboard Toggle word wrap

2. ansible-vault create 命令创建一个加密的文件，并在编辑器中打开它。输入您要保存在密码库中的敏感数据，例如：

   activationKey: activation_key

   Copy to Clipboard Toggle word wrap

3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

   之后，您可以使用 ansible-vault edit secrets.yml 命令编辑 vault 中的数据。

4. 可选：显示 vault 内容：

   $ ansible-vault view secrets.yml

   Copy to Clipboard Toggle word wrap
5. 创建一个 playbook 文件，如 ~/registration-sat.yml。

6. 使用 ~/registration-sat.yml 中的以下文本，使用激活码和机构 ID 注册系统：

   ---
   - name: Register to the custom registration server and CDN
     hosts: managed-node-01.example.com
     vars_files:
       - secrets.yml
     vars:
       rhc_auth:
         login:
           activation_keys:
             keys:
               - "{{ activationKey }}"
           rhc_organization: organizationID
       rhc_server:
         hostname: example.com
           port: 443
           prefix: /rhsm
       rhc_baseurl: http://example.com/pulp/content
      roles:
        - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

7. 运行 playbook：

   # ansible-playbook ~/registration-sat.yml --ask-vault-pass

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 playbook 文件，如 ~/dis-insights.yml，并在其中添加以下内容：

   ---
   - name: Disable Insights connection
     hosts: managed-node-01.example.com
     vars:
       rhc_insights:
         state: absent
     roles:
       - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/dis-insights.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 playbook 文件，如 ~/configure-repos.yml ：

   1. 要启用存储库：

      ---
      - name: Enable repository
        hosts: managed-node-01.example.com
        vars:
          rhc_repositories:
            - {name: "RepositoryName", state: enabled}
         roles:
           - role: rhel-system-roles.rhc

      Copy to Clipboard Toggle word wrap

   2. 要禁用存储库：

      ---
      - name: Disable repository
        hosts: managed-node-01.example.com
        vars:
          rhc_repositories:
            - {name: "RepositoryName", state: disabled}
         roles:
           - role: rhel-system-roles.rhc

      Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/configure-repos.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 playbook 文件，如 ~/release.yml ：

   ---
   - name: Set Release
     hosts: managed-node-01.example.com
     vars:
       rhc_release: "8.6"
     roles:
       - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/release.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 vault 来保存敏感信息：

   $ ansible-vault create secrets.yml
   New Vault password: password
   Confirm New Vault password: password

   Copy to Clipboard Toggle word wrap

2. ansible-vault create 命令创建一个加密的文件，并在编辑器中打开它。输入您要保存在密码库中的敏感数据，例如：

   username: username
   password: password
   proxy_username: proxyusernme
   proxy_password: proxypassword

   Copy to Clipboard Toggle word wrap

3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

   之后，您可以使用 ansible-vault edit secrets.yml 命令编辑 vault 中的数据。

4. 可选：显示 vault 内容：

   $ ansible-vault view secrets.yml

   Copy to Clipboard Toggle word wrap

5. 创建一个 playbook 文件，如 ~/configure-proxy.yml ：

   1. 要使用代理注册到 RHEL 客户门户网站：

      ---
      - name: Register using proxy
        hosts: managed-node-01.example.com
        vars_files:
          - secrets.yml
        vars:
          rhc_auth:
            login:
              username: "{{ username }}"
              password: "{{ password }}"
          rhc_proxy:
            hostname: proxy.example.com
            port: 3128
            username: "{{ proxy_username }}"
            password: "{{ proxy_password }}"
        roles:
          - role: rhel-system-roles.rhc

      Copy to Clipboard Toggle word wrap

   2. 要从 Red Hat Subscription Manager 服务的配置中删除代理服务器：

      ---
      - name: To stop using proxy server for registration
        hosts: managed-node-01.example.com
        vars_files:
          - secrets.yml
        vars:
          rhc_auth:
            login:
              username: "{{ username }}"
              password: "{{ password }}"
           rhc_proxy: {"state":"absent"}
        roles:
          - role: rhel-system-roles.rhc

      Copy to Clipboard Toggle word wrap

6. 运行 playbook：

   # ansible-playbook ~/configure-proxy.yml --ask-vault-pass

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 vault 来保存敏感信息：

   $ ansible-vault create secrets.yml
   New Vault password: password
   Confirm New Vault password: password

   Copy to Clipboard Toggle word wrap

2. ansible-vault create 命令创建一个加密的文件，并在编辑器中打开它。输入您要保存在密码库中的敏感数据，例如：

   username: username
   password: password

   Copy to Clipboard Toggle word wrap

3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

   之后，您可以使用 ansible-vault edit secrets.yml 命令编辑 vault 中的数据。

4. 可选：显示 vault 内容：

   $ ansible-vault view secrets.yml

   Copy to Clipboard Toggle word wrap

5. 创建一个 playbook 文件，如 ~/auto-update.yml，并将以下内容添加到其中：

   ---
    - name: Disable Red Hat Insights autoupdates
      hosts: managed-node-01.example.com
      vars_files:
        - secrets.yml
      vars:
       rhc_auth:
         login:
           username: "{{ username }}"
           password: "{{ password }}"
       rhc_insights:
          autoupdate: false
          state: present
       roles:
         - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

6. 运行 playbook：

   # ansible-playbook ~/auto-update.yml --ask-vault-pass

   Copy to Clipboard Toggle word wrap

流程

1. 要启用补救，请创建一个 playbook 文件，如 ~/remediation.yml ：

   ---
   - name: Disable remediation
     hosts: managed-node-01.example.com
     vars:
       rhc_insights:
         remediation: absent
         state: present
     roles:
       - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/remediation.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 vault 来保存敏感信息：

   $ ansible-vault create secrets.yml
   New Vault password: password
   Confirm New Vault password: password

   Copy to Clipboard Toggle word wrap

2. ansible-vault create 命令创建一个加密的文件，并在编辑器中打开它。输入您要保存在密码库中的敏感数据，例如：

   username: username
   password: password

   Copy to Clipboard Toggle word wrap

3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

   之后，您可以使用 ansible-vault edit secrets.yml 命令编辑 vault 中的数据。

4. 可选：显示 vault 内容：

   $ ansible-vault view secrets.yml

   Copy to Clipboard Toggle word wrap

5. 创建一个 playbook 文件，如 ~/tags.yml，并将以下内容添加到其中：

   ---
   - name: Creating tags
     hosts: managed-node-01.example.com
     vars_files:
       - secrets.yml
     vars:
       rhc_auth:
         login:
           username: "{{ username }}"
           password: "{{ password }}"
       rhc_insights:
         tags:
           group: group-name-value
             location: location-name-value
             description:
               - RHEL8
               - SAP
              sample_key:value
           state: present
     roles:
       - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

6. 运行 playbook：

   # ansible-playbook ~/remediation.yml --ask-vault-pass

   Copy to Clipboard Toggle word wrap

流程

1. 要取消注册，请创建一个 playbook 文件，如 ~/unregister.yml ，并在其中添加以下内容：

   ---
   - name: Unregister the system
     hosts: managed-node-01.example.com
     vars:
       rhc_state: absent
     roles:
       - role: rhel-system-roles.rhc

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/unregister.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/ethernet-static-IP.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with static IP
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: enp7s0
             interface_name: enp7s0
             type: ethernet
             autoconnect: yes
             ip:
               address:
                 - 192.0.2.1/24
                 - 2001:db8:1::1/64
               gateway4: 192.0.2.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 192.0.2.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/ethernet-static-IP.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/ethernet-static-IP.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with static IP
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: example
             match:
               path:
                 - pci-0000:00:0[1-3].0
                 - &!pci-0000:00:02.0
             type: ethernet
             autoconnect: yes
             ip:
               address:
                 - 192.0.2.1/24
                 - 2001:db8:1::1/64
               gateway4: 192.0.2.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 192.0.2.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             state: up

   Copy to Clipboard Toggle word wrap

   本例中的 match 参数定义了 Ansible 将剧本应用到与 PCI ID 0000:00:0[1-3].0 匹配的设备，但没有 0000:00:02.0 设备。有关可以使用的特殊修饰符和通配符的详情，请查看 /usr/share/ansible/roles/rhel-system-roles.network/README.md 文件中的 match 参数描述。

2. 运行 playbook：

   # ansible-playbook ~/ethernet-static-IP.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/ethernet-dynamic-IP.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with dynamic IP
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: enp7s0
             interface_name: enp7s0
             type: ethernet
             autoconnect: yes
             ip:
               dhcp4: yes
               auto6: yes
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/ethernet-dynamic-IP.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/ethernet-dynamic-IP.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with dynamic IP
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: example
             match:
               path:
                 - pci-0000:00:0[1-3].0
                 - &!pci-0000:00:02.0
             type: ethernet
             autoconnect: yes
             ip:
               dhcp4: yes
               auto6: yes
             state: up

   Copy to Clipboard Toggle word wrap

   本例中的 match 参数定义了 Ansible 将剧本应用到与 PCI ID 0000:00:0[1-3].0 匹配的设备，但没有 0000:00:02.0 设备。有关可以使用的特殊修饰符和通配符的详情，请查看 /usr/share/ansible/roles/rhel-system-roles.network/README.md 文件中的 match 参数描述。

2. 运行 playbook：

   # ansible-playbook ~/ethernet-dynamic-IP.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/vlan-ethernet.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure a VLAN that uses an Ethernet connection
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           # Add an Ethernet profile for the underlying device of the VLAN
           - name: enp1s0
             type: ethernet
             interface_name: enp1s0
             autoconnect: yes
             state: up
             ip:
               dhcp4: no
               auto6: no
   
           # Define the VLAN profile
           - name: enp1s0.10
             type: vlan
             ip:
               address:
                 - "192.0.2.1/24"
                 - "2001:db8:1::1/64"
               gateway4: 192.0.2.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 192.0.2.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             vlan_id: 10
             parent: enp1s0
             state: up

   Copy to Clipboard Toggle word wrap

   VLAN 配置文件中的 parent 属性将 VLAN 配置为在 enp1s0 设备之上运行。

2. 运行 playbook：

   # ansible-playbook ~/vlan-ethernet.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/bridge-ethernet.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure a network bridge that uses two Ethernet ports
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           # Define the bridge profile
           - name: bridge0
             type: bridge
             interface_name: bridge0
             ip:
               address:
                 - "192.0.2.1/24"
                 - "2001:db8:1::1/64"
               gateway4: 192.0.2.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 192.0.2.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             state: up
   
           # Add an Ethernet profile to the bridge
           - name: bridge0-port1
             interface_name: enp7s0
             type: ethernet
             controller: bridge0
             port_type: bridge
             state: up
   
           # Add a second Ethernet profile to the bridge
           - name: bridge0-port2
             interface_name: enp8s0
             type: ethernet
             controller: bridge0
             port_type: bridge
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/bridge-ethernet.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/bond-ethernet.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure a network bond that uses two Ethernet ports
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           # Define the bond profile
           - name: bond0
             type: bond
             interface_name: bond0
             ip:
               address:
                 - "192.0.2.1/24"
                 - "2001:db8:1::1/64"
               gateway4: 192.0.2.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 192.0.2.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             bond:
               mode: active-backup
             state: up
   
           # Add an Ethernet profile to the bond
           - name: bond0-port1
             interface_name: enp7s0
             type: ethernet
             controller: bond0
             state: up
   
           # Add a second Ethernet profile to the bond
           - name: bond0-port2
             interface_name: enp8s0
             type: ethernet
             controller: bond0
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/bond-ethernet.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 playbook 文件，如包含以下内容的 ~/IPoIB.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure IPoIB
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
   
           # InfiniBand connection mlx4_ib0
           - name: mlx4_ib0
             interface_name: mlx4_ib0
             type: infiniband
   
           # IPoIB device mlx4_ib0.8002 on top of mlx4_ib0
           - name: mlx4_ib0.8002
             type: infiniband
             autoconnect: yes
             infiniband:
               p_key: 0x8002
               transport_mode: datagram
             parent: mlx4_ib0
             ip:
               address:
                 - 192.0.2.1/24
                 - 2001:db8:1::1/64
             state: up

   Copy to Clipboard Toggle word wrap

   如果您像本例所示设置了 p_key 参数，请不要在 IPoIB 设备上设置 interface_name 参数。

2. 运行 playbook：

   # ansible-playbook ~/IPoIB.yml

   Copy to Clipboard Toggle word wrap

验证

1. 在 managed-node-01.example.com 主机上显示 mlx4_ib0.8002 设备的 IP 设置：

   # ip address show mlx4_ib0.8002
   ...
   inet 192.0.2.1/24 brd 192.0.2.255 scope global noprefixroute ib0.8002
      valid_lft forever preferred_lft forever
   inet6 2001:db8:1::1/64 scope link tentative noprefixroute
      valid_lft forever preferred_lft forever

   Copy to Clipboard Toggle word wrap

2. 显示 mlx4_ib0.8002 设备的分区密钥(P_Key)：

   # cat /sys/class/net/mlx4_ib0.8002/pkey
   0x8002

   Copy to Clipboard Toggle word wrap

3. 显示 mlx4_ib0.8002 设备的模式：

   # cat /sys/class/net/mlx4_ib0.8002/mode
   datagram

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/pbr.yml ：

   ---
   - name: Configuring policy-based routing
     hosts: managed-node-01.example.com
     tasks:
     - name: Routing traffic from a specific subnet to a different default gateway
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: Provider-A
             interface_name: enp7s0
             type: ethernet
             autoconnect: True
             ip:
               address:
                 - 198.51.100.1/30
               gateway4: 198.51.100.2
               dns:
                 - 198.51.100.200
             state: up
             zone: external
   
           - name: Provider-B
             interface_name: enp1s0
             type: ethernet
             autoconnect: True
             ip:
               address:
                 - 192.0.2.1/30
               route:
                 - network: 0.0.0.0
                   prefix: 0
                   gateway: 192.0.2.2
                   table: 5000
             state: up
             zone: external
   
           - name: Internal-Workstations
             interface_name: enp8s0
             type: ethernet
             autoconnect: True
             ip:
               address:
                 - 10.0.0.1/24
               route:
                 - network: 10.0.0.0
                   prefix: 24
                   table: 5000
               routing_rule:
                 - priority: 5
                   from: 10.0.0.0/24
                   table: 5000
             state: up
             zone: trusted
   
           - name: Servers
             interface_name: enp9s0
             type: ethernet
             autoconnect: True
             ip:
               address:
                 - 203.0.113.1/24
             state: up
             zone: trusted

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/pbr.yml

   Copy to Clipboard Toggle word wrap

验证

1. 在内部工作站子网的 RHEL 主机上：

   1. 安装 traceroute 软件包：

      # yum install traceroute

      Copy to Clipboard Toggle word wrap

   2. 使用 traceroute 工具显示到互联网上主机的路由：

      # traceroute redhat.com
      traceroute to redhat.com (209.132.183.105), 30 hops max, 60 byte packets
       1  10.0.0.1 (10.0.0.1)     0.337 ms  0.260 ms  0.223 ms
       2  192.0.2.1 (192.0.2.1)   0.884 ms  1.066 ms  1.248 ms
       ...

      Copy to Clipboard Toggle word wrap

      命令的输出显示路由器通过 192.0.2.1 ，即提供商 B 的网络来发送数据包。

2. 在服务器子网的 RHEL 主机上：

   1. 安装 traceroute 软件包：

      # yum install traceroute

      Copy to Clipboard Toggle word wrap

   2. 使用 traceroute 工具显示到互联网上主机的路由：

      # traceroute redhat.com
      traceroute to redhat.com (209.132.183.105), 30 hops max, 60 byte packets
       1  203.0.113.1 (203.0.113.1)    2.179 ms  2.073 ms  1.944 ms
       2  198.51.100.2 (198.51.100.2)  1.868 ms  1.798 ms  1.549 ms
       ...

      Copy to Clipboard Toggle word wrap

      命令的输出显示路由器通过 198.51.100.2 ，即供应商 A 的网络来发送数据包。

3. 在使用 RHEL 系统角色配置的 RHEL 路由器上：

   1. 显示规则列表：

      # ip rule list
      0:      from all lookup local
      5:    from 10.0.0.0/24 lookup 5000
      32766:  from all lookup main
      32767:  from all lookup default

      Copy to Clipboard Toggle word wrap

      默认情况下，RHEL 包含表 local、main 和 default 的规则。

   2. 显示表 5000 中的路由：

      # ip route list table 5000
      0.0.0.0/0 via 192.0.2.2 dev enp1s0 proto static metric 100
      10.0.0.0/24 dev enp8s0 proto static scope link src 192.0.2.1 metric 102

      Copy to Clipboard Toggle word wrap

   3. 显示接口和防火墙区：

      # firewall-cmd --get-active-zones
      external
        interfaces: enp1s0 enp7s0
      trusted
        interfaces: enp8s0 enp9s0

      Copy to Clipboard Toggle word wrap

   4. 验证 external 区是否启用了伪装：

      # firewall-cmd --info-zone=external
      external (active)
        target: default
        icmp-block-inversion: no
        interfaces: enp1s0 enp7s0
        sources:
        services: ssh
        ports:
        protocols:
        masquerade: yes
        ...

      Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/enable-802.1x.yml ：

   ---
   - name: Configure an Ethernet connection with 802.1X authentication
     hosts: managed-node-01.example.com
     tasks:
       - name: Copy client key for 802.1X authentication
         copy:
           src: "/srv/data/client.key"
           dest: "/etc/pki/tls/private/client.key"
           mode: 0600
   
       - name: Copy client certificate for 802.1X authentication
         copy:
           src: "/srv/data/client.crt"
           dest: "/etc/pki/tls/certs/client.crt"
   
       - name: Copy CA certificate for 802.1X authentication
         copy:
           src: "/srv/data/ca.crt"
           dest: "/etc/pki/ca-trust/source/anchors/ca.crt"
   
       - include_role:
           name: rhel-system-roles.network
   
         vars:
           network_connections:
             - name: enp1s0
               type: ethernet
               autoconnect: yes
               ip:
                 address:
                   - 192.0.2.1/24
                   - 2001:db8:1::1/64
                 gateway4: 192.0.2.254
                 gateway6: 2001:db8:1::fffe
                 dns:
                   - 192.0.2.200
                   - 2001:db8:1::ffbb
                 dns_search:
                   - example.com
               ieee802_1x:
                 identity: user_name
                 eap: tls
                 private_key: "/etc/pki/tls/private/client.key"
                 private_key_password: "password"
                 client_cert: "/etc/pki/tls/certs/client.crt"
                 ca_cert: "/etc/pki/ca-trust/source/anchors/ca.crt"
                 domain_suffix_match: example.com
               state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/enable-802.1x.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/ethernet-connection.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with static IP and default gateway
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: enp1s0
             type: ethernet
             autoconnect: yes
             ip:
               address:
                 - 198.51.100.20/24
                 - 2001:db8:1::1/64
               gateway4: 198.51.100.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 198.51.100.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/ethernet-connection.yml

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含以下内容的 playbook 文件，如 ~/add-static-routes.yml ：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with static IP and additional routes
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: enp7s0
             type: ethernet
             autoconnect: yes
             ip:
               address:
                 - 192.0.2.1/24
                 - 2001:db8:1::1/64
               gateway4: 192.0.2.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 192.0.2.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
               route:
                 - network: 198.51.100.0
                   prefix: 24
                   gateway: 192.0.2.10
                 - network: 2001:db8:2::
                   prefix: 64
                   gateway: 2001:db8:1::10
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/add-static-routes.yml

   Copy to Clipboard Toggle word wrap

验证

1. 在受管节点上：

   1. 显示 IPv4 路由：

      # ip -4 route
      ...
      198.51.100.0/24 via 192.0.2.10 dev enp7s0

      Copy to Clipboard Toggle word wrap

   2. 显示 IPv6 路由：

      # ip -6 route
      ...
      2001:db8:2::/64 via 2001:db8:1::10 dev enp7s0 metric 1024 pref medium

      Copy to Clipboard Toggle word wrap

流程

1. 创建一个 playbook 文件，如 ~/configure-ethernet-device-with-ethtool-features.yml，其内容如下：

   ---
   - name: Configure the network
     hosts: managed-node-01.example.com
     tasks:
     - name: Configure an Ethernet connection with ethtool features
       include_role:
         name: rhel-system-roles.network
   
       vars:
         network_connections:
           - name: enp1s0
             type: ethernet
             autoconnect: yes
             ip:
               address:
                 - 198.51.100.20/24
                 - 2001:db8:1::1/64
               gateway4: 198.51.100.254
               gateway6: 2001:db8:1::fffe
               dns:
                 - 198.51.100.200
                 - 2001:db8:1::ffbb
               dns_search:
                 - example.com
             ethtool:
               features:
                 gro: "no"
                 gso: "yes"
                 tx_sctp_segmentation: "no"
             state: up

   Copy to Clipboard Toggle word wrap

2. 运行 playbook：

   # ansible-playbook ~/configure-ethernet-device-with-ethtool-features.yml

   Copy to Clipboard Toggle word wrap