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. Playbook を管理および実行するための ansible という名前のユーザーを作成します。

   [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. 管理対象ホストのホスト名をリストする ~/inventory ファイルを INI または YAML 形式で作成します。インベントリーファイルでホストのグループを定義することもできます。たとえば、以下は、3 つのホストと US という名前の 1 つのホストグループを含む INI 形式のインベントリーファイルです。

   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) man ページを参照してください。

検証

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. ansible.cfg 設定ファイルでコンテンツのデフォルトソースとして Red Hat Automation Hub を定義します。コンテンツについては、プライマリーソースとしての 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 モジュールは、システムインベントリーなどのリモートアウトオブバンド (OOB) コントローラーに関する情報を取得します。
2. redfish_command: redfish_command モジュールは、ログ管理やユーザー管理などの帯域外 (OOB) コントローラー操作と、システムの再起動、電源のオンとオフなどの電源操作を実行します。
3. redfish_config: redfish_config モジュールは、OOB 設定の変更や BIOS 設定の設定などの OOB コントローラー操作を実行します。

手順

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 を表し、通常は、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 キーは任意です。任意の文字列をラベルとしてプレイに関連付け、プレイの対象を特定します。プレイの hosts キーは、プレイを実行するホストを指定します。このキーの値または値は、マネージドホストの個別名または inventory ファイルで定義されているホストのグループとして指定できます。

      vars セクションは、設定する必要がある、選択したカーネルパラメーター名および値が含まれる変数のリストを表します。

      roles キーは、vars セクションで説明されているパラメーターおよび値を設定するシステムロールを指定します。

      注記

      必要に応じて、Playbook のカーネルパラメーターとその値を変更することができます。

4. 必要に応じて、プレイ内の構文が正しいことを確認します。

   #  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 セクションは、すべてのマネージドホストのプレイが正常に終了したこと (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 ファイルを作成し、これをエディターで開きます。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 コマンドは暗号化されたファイルを作成し、これをエディターで開きます。vault に保存したい機密データを入力します。以下に例を示します。

   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. アクティベーションキーと組織 ID を使用してシステムを登録するには、~/registration-sat.yml で次のテキストを使用します。

   ---
   - 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 コマンドは暗号化されたファイルを作成し、これをエディターで開きます。vault に保存したい機密データを入力します。以下に例を示します。

   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 コマンドは暗号化されたファイルを作成し、これをエディターで開きます。vault に保存したい機密データを入力します。以下に例を示します。

   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 コマンドは暗号化されたファイルを作成し、これをエディターで開きます。vault に保存したい機密データを入力します。以下に例を示します。

   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. ~/ethernet-static-IP.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/ethernet-static-IP.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/ethernet-dynamic-IP.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/ethernet-dynamic-IP.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/vlan-ethernet.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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 属性は、enp1s0 デバイス上で動作する VLAN を設定します。

2. Playbook を実行します。

   # ansible-playbook ~/vlan-ethernet.yml

   Copy to Clipboard Toggle word wrap

手順

1. ~/bridge-ethernet.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/bond-ethernet.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/IPoIB.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/pbr.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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

      コマンドの出力には、ルーターがプロバイダー B のネットワークである 192.0.2.1 経由でパケットを送信することが表示されます。

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

      コマンドの出力には、ルーターがプロバイダー A のネットワークである 198.51.100.2 経由でパケットを送信することが表示されます。

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. ~/enable-802.1x.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/ethernet-connection.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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. ~/add-static-routes.yml などの Playbook ファイルを次の内容で作成します。

   ---
   - 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