5.2. Satellite Ansible コレクションのモジュールを使用した Playbook の作成

手順

1. 機密性の高い変数を暗号化されたファイルに保存します。

   1. Ansible Vault を作成します。たとえば、My_Vault.yml という名前の vault を作成するには、以下を実行します。

      $ ansible-vault create My_Vault.yml

      Copy to Clipboard Toggle word wrap

   2. ansible-vault create コマンドでエディターが開いたら、必要なパラメーターを key: value 形式で入力します。

      Satellite のユーザー名とパスワードで認証する場合:

      My_Username: My_Admin_User_Account
      My_Password: My_Admin_Password
      My_Server_URL: https://satellite.example.com

      Copy to Clipboard Toggle word wrap

      Satellite ユーザー名と Personal Access Token (PAT) を使用して認証する場合:

      My_Username: My_Admin_User_Account
      My_Password: My_PAT
      My_Server_URL: https://satellite.example.com

      Copy to Clipboard Toggle word wrap

   3. HTTP プロキシーを使用して Satellite API にアクセスする場合は、そのプロキシーも vault に保存します。

      My_HTTP_Proxy: "http://proxy.example.com:8080"

      Copy to Clipboard Toggle word wrap
   4. 変更を保存してエディターを閉じます。Ansible は vault 内のデータを暗号化します。

2. vault ファイルを参照する Playbook ファイルを作成します。

   注記

   次の YAML スニペットには、Playbook で使用される redhat.satellite.satellite グループのすべてのモジュールにボールト変数をパラメーターとして渡す module_defaults キーワードが含まれています。モジュールのデフォルトグループを使用すると、各モジュールにパラメーターを個別に渡すのではなく、モジュールのグループに共通のパラメーターを定義できるため、パラメーター管理が簡素化されます。

   1. Satellite API への認証方法を説明します。

      Satellite のユーザー名とパスワード、または PAT で認証する場合は、username、password、および server_url パラメーターを My_Vault.yml の内容にマッピングします。

      - name: My Playbook
        hosts: localhost
        vars_files:
          - My_Vault.yml
        module_defaults:
          group/redhat.satellite.satellite:
            username: "{{ My_Username }}"
            password: "{{ My_Password }}"
            server_url: "{{ My_Server_URL }}"
        tasks:

      Copy to Clipboard Toggle word wrap

   2. HTTP プロキシーを使用して Satellite API にアクセスする必要がある場合は、https_proxy 環境変数を設定します。

      - name: My Playbook
        hosts: localhost
        vars_files:
          - My_Vault.yml
        environment:
          https_proxy: "{{ My_HTTP_Proxy }}"
        module_defaults:
          group/redhat.satellite.satellite:
            username: "{{ My_Username }}"
            password: "{{ My_Password }}"
            server_url: "{{ My_Server_URL }}"
        tasks:

      Copy to Clipboard Toggle word wrap
   3. tasks: セクションで、Playbook が実行するタスクを定義します。

3. Playbook の構文を検証します。

   $ ansible-playbook --syntax-check --ask-vault-pass My_Playbook.yml

   Copy to Clipboard Toggle word wrap

   このコマンドは構文の検証のみを行うことに注意してください。設定が有効ではあるが、間違っている場合には、保護されません。

4. Playbook を実行します。

   $ ansible-playbook --ask-vault-pass My_Playbook.yml

   Copy to Clipboard Toggle word wrap