Red Hat Satellite での Ansible 統合を使用した設定の管理

手順

1. ロールを使用する場所から、Satellite Server およびすべての Capsule Server の Ansible パス 内のディレクトリーにロールを追加します。カスタムまたはサードパーティーの Ansible ロールを使用する場合には、外部のバージョン管理システムが Satellite Server と Capsule Server の間でロールを同期するように設定してください。

2. ホストで Ansible ロールの実行に使用するすべての Capsule Server で、Ansible プラグインを有効にします。

   # satellite-installer --scenario capsule \
   --enable-foreman-proxy-plugin-ansible

3. SSH 鍵を配布して、Capsule が SSH でホストに接続できるようにします。詳細は、ホストの管理 の リモート実行のための SSH 鍵の配布 を参照してください。Satellite は、リモート実行ジョブの実行と同様に、Ansible ロールを実行します。
4. Ansible ロールを Satellite にインポートします。
5. 2章Ansible ロールを使用したクライアント上の反復タスクの自動化 に進みます。

手順

1. Satellite Web UI で、Configure > Roles に移動します。
2. Import をクリックして、インポート元の Capsule を選択します。
3. インポートするロールを選択します。
4. Submit をクリックします。

手順

1. Satellite Web UI で、設定 > 変数 に移動します。
2. Satellite でオーバーライドし、管理する Ansible 変数を選択します。
3. Default Behavior エリアで、Override チェックボックスを選択します。
4. Parameter Type フィールドで、string や boolean などの検証用の値のタイプを選択します。配列 タイプと ハッシュ タイプには、変数の一致を処理するための追加のオプションがあります。詳細は、以下の Prioritize Attribute Order エリア を参照してください。
5. デフォルト値 フィールドで、変数と一致するものがない場合に使用するデフォルト値を入力します。
6. オプション: 変数の値を Satellite Web UI でプレーンテキストとして表示したくない場合は、値の非表示 のチェックボックスを選択し、変数のコンテンツをアスタリスクとして表示します。これは、パスワードやシークレットトークンなどの機密性の高い値に役立ちます。

7. オプション: オプションの入力バリデーター エリアをデプロイメントし、変数の具体的な値を検証するために使用される条件を指定します。

   • ユーザーにこの変数への入力を強制する場合は、Required を選択します。

   • Validator Type フィールドで、値を検証する方法を選択します。

     • list - 値は、許可された値の列挙に対して検証されます。
     • regex - 値は正規表現パターンに対して検証されます。

8. オプション: Prioritize Attribute Order 領域では、オーバーライドをホストと一致させる優先順位をホスト属性別に指定します。上から順に優先されます。最初に一致したものが優先されます。

   AND 演算としてコンマを使用して、複数の属性を 1 つのマッチャーキーにまとめることができます。たとえば、hostgroup, environment のマッチャーキーは、hostgroup = "web servers" および environment = production などのマッチャーを想定します。

   パラメータータイプ array または hash を使用する場合は、さらに以下を設定できます。

   • オーバーライドのマージ - 配列全体またはハッシュを置き換える代わりに、配列/ハッシュのメンバーをマージします。ハッシュに同じキーが含まれている場合、値はホストの値で上書きされます。
   • デフォルトのマージ - デフォルト値を配列またはハッシュに追加します。
   • 重複の回避 - 配列またはハッシュの値が一意であることを確認します。
9. オプション: マッチャーの指定 エリアをデプロイメントし、変数がオーバーライドするホストを選択するための基準を指定します。
10. オーバーライド設定を保存するには、送信 をクリックします。

ホストへの変数の追加

1. Satellite Web UI で、Hosts > All Hosts に移動し、使用するホストを選択します。
2. Ansible タブをクリックし、Variables 領域で、鉛筆アイコンをクリックして変数の値を編集します。
3. チェックアイコンをクリックして変更された変数の値を受け入れるか、クロスアイコンをクリックして変更をキャンセルします。

ホストグループへの変数の追加

1. Satellite Web UI で、Configure > Host Groups に移動し、使用するホストグループを選択します。
2. パラメーター タブをクリックして、ホストのグループパラメーター のエリアで、パラメーターの追加 をクリックします。
3. 名前 フィールドに Ansible 変数名を追加します。
4. タイプ リストから検証する変数タイプを選択します。
5. 値 フィールドに変数の値を入力します。

変数をグローバルパラメーターとして追加する

1. Satellite Web UI で 設定 > グローバルパラメーター に移動して、パラメーターの作成 をクリックします。
2. 名前 フィールドに Ansible 変数名を追加します。
3. タイプ リストから検証する変数タイプを選択します。
4. 値 フィールドに変数の値を入力します。
5. オプション: Ansible 変数をプレーンテキストで表示したくない場合は、値の非表示 のチェックボックスを選択し、Satellite Web UI で変数のコンテンツをアスタリスクとして表示します。

手順

1. 次のリポジトリーが有効になっていることを確認します。

   • Red Hat Enterprise Linux 8 で、Appstream リポジトリーが有効になっていることを確認します。

     # subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms

     アーキテクチャー用に指定された Appstream リポジトリーを有効にする必要があります。詳細は、RHEL 8 リポジトリー を参照してください。

   • Red Hat Enterprise Linux 7 では、Extras リポジトリーが有効になっていることを確認します。

     # subscription-manager repos --enable=rhel-7-server-extras-rpms

2. rhel-system-roles パッケージをインストールします。

   # satellite-maintain packages install rhel-system-roles

   rhel-system-roles パッケージは /usr/share/ansible/roles/ にダウンロードされます。インポート前にファイルを表示して修正を加えることができます。

3. Satellite Web UI で、設定 > ロール に移動して、インポートするロールが含まれている Capsule をクリックします。
4. Ansible ロールリストからインポートするロールのチェックボックスを選択してから、更新 をクリックします。

手順

1. Satellite Web UI で、Content > Products に移動します。
2. 必要な製品名を選択します。
3. 製品 ウィンドウで、リポジトリーを作成する製品の名前を選択します。
4. リポジトリー タブをクリックして、新規リポジトリー をクリックします。

5. Name フィールドに、リポジトリーの名前を入力します。

   ラベル フィールドには、名前に基づいて自動的に入力されます。

6. タイプ リストから、ansible コレクション を選択します。

7. アップストリーム URL フィールドに、アップストリームコレクションリポジトリーの URL を入力します。

   URL には、任意の Ansible Galaxy エンドポイントを指定できます。例: https://console.redhat.com/api/automation-hub/

8. オプション: Requirements.yml フィールドで、エンドポイントから同期するコレクションのリストとそのバージョンを指定できます。

   コレクションのリストを指定しない場合は、エンドポイントのすべてが同期されます。

   ---
   collections:
   - name: my_namespace.my_collection
     version: 1.2.3

   詳細は、Galaxy ユーザーガイド の Installing roles and collections from the same requirements.yml file を参照してください。

9. 認証します。

   1. Private Automation Hub から Satellite を同期するには、Auth Token フィールドにトークンを入力します。

      詳細は、Connect to Hub ガイドの Connect Private Automation Hub を参照してください。

   2. console.redhat.com から Satellite を同期するには、Auth Token フィールドにトークンを入力し、Auth URL フィールドに SSO URL を入力します。

      詳細は、Automation Hub の概要 を参照してください。

   3. Satellite から Satellite を同期するには、両方の認証フィールドを空白のままにします。
10. Save をクリックします。
11. Ansible Collections リポジトリーに移動します。
12. アクションの選択 メニューから 同期開始 を選択します。

手順

1. /etc/ansible/ansible.cfg をカスタマイズした場合は、設定を /etc/ansible/ansible.cfg から /usr/share/foreman-proxy/.ansible.cfg にコピーします。

2. ansible-vault コマンドを使用して機密ファイルを暗号化します。

   # ansible-vault encrypt /etc/ansible/roles/Role_Name/vars/main.yml

   ansible-vault は、ファイルのアクセス許可を 600 に変更することに注意してください。

3. 暗号化されたファイルのグループと権限を変更して、foreman-proxy ユーザーが確実に読み取れるようにします。

   # chgrp foreman-proxy /etc/ansible/roles/Role_Name/vars/main.yml
   # chmod 0640 /etc/ansible/roles/Role_Name/vars/main.yml

4. /usr/share/foreman-proxy/.ansible_vault_password ファイルを作成し、そのファイルに Vault パスワードを入力します。

5. .ansible_vault_password ファイルのユーザーと権限を変更して、foreman-proxy ユーザーのみがファイルを読み取れるようにします。

   # chown foreman-proxy:foreman-proxy /usr/share/foreman-proxy/.ansible_vault_password
   # chmod 0400 /usr/share/foreman-proxy/.ansible_vault_password

6. Vault パスワードファイルのパスを /usr/share/foreman-proxy/.ansible.cfg の defaults セクションに追加します。

   [defaults]
   vault_password_file = /usr/share/foreman-proxy/.ansible_vault_password

   Vault パスワードファイルへのパスは絶対パスである必要があります。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. ホストを選択し、編集 をクリックします。
3. Ansible Roles タブで、Available Ansible Roles のリストから追加するロールを選択します。
4. + アイコンをクリックして、ロールをホストに追加します。複数のロールを追加できます。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. ホストを選択し、編集 をクリックします。
3. Ansible Roles タブを選択します。
4. Assigned Ansible Roles エリアで、- アイコンをクリックして、ホストからロールを削除します。さらにロールを削除するには、これを繰り返します。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. ホストを選択します。
3. Ansible Roles タブを選択します。
4. Assigned Ansible Roles エリアで、ロールを適切な位置にドラッグアンドドロップすることで、ロールの順序を変更できます。
5. Submit をクリックして、Ansible ロールの順序を保存します。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 実行する Ansible ロールが含まれるホストのチェックボックスを選択します。
3. Select Action リストから、Run all Ansible roles を選択します。

手順

1. Satellite Web UI で、Configure > Host Groups に移動します。
2. Ansible ロールを割り当てるホストグループ名をクリックします。
3. Ansible Roles タブで、Available Ansible Roles のリストから追加するロールを選択します。
4. + アイコンをクリックして、ロールをホストグループに追加します。複数のロールを追加できます。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Configure > Host Groups に移動します。
2. ホストグループの Actions コラムのリストから、Run all Ansible roles を選択します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に 移動 します。
2. チェックモードを有効にするホストの 編集 をクリックします。
3. パラメーター タブで、ホストに ansible_roles_check_mode という名前のパラメーターがあり、boolean 型が true に設定されていることを確認します。
4. Submit をクリックします。

1. Satellite は、Remote execution のチェックボックスが選択されているホストのインターフェイスを検出します。
2. Satellite はこれらのインターフェイスのサブネットを検出します。
3. Satellite は、これらのサブネットに割り当てられたリモート実行 Capsule を検出します。
4. この Capsule のセットから、Satellite は実行中のジョブの数が最も少ない Capsule を選択します。こうすることで、Satellite はリモート実行 Capsule 間でのジョブの負荷を確実に分散させます。

手順

1. ホストに katello-pull-transport-migrate パッケージをインストールします。

   • Red Hat Enterprise Linux 8 ホストおよび Red Hat Enterprise Linux 9 ホストの場合:

     # dnf install katello-pull-transport-migrate

   • Red Hat Enterprise Linux 7 ホストの場合:

     # yum install katello-pull-transport-migrate

   このパッケージは、依存関係として foreman_ygg_worker および yggdrasil をインストールし、ホストでプルモードを有効にします。ホストの subscription-manager 設定およびコンシューマー証明書は、ホストで yggdrasil クライアントを設定するために使用され、プルモードのクライアントワーカーを起動します。

2. オプション: プルクライアントが実行中であり、適切に設定されていることを確認するには、yggdrasild サービスのステータスを確認します。

   # systemctl status yggdrasild

3. オプション: パッケージのインストール後に、ホストから katello-agent を削除できます。

   警告

   お使いのホストが Red Hat Virtualization のバージョン 4.4 以下にインストールされている場合は、削除された依存関係によりホストが破損するので、katello-agent パッケージを削除しないでください。

手順

1. Satellite Web UI で、ホスト > ジョブテンプレート に移動します。
2. 新規ジョブテンプレート をクリックします。
3. テンプレート タブをクリックして、名前 フィールドにジョブテンプレートの一意名を入力します。
4. デフォルト を選択して、テンプレートをすべての組織およびロケーションで利用できるようにします。
5. テンプレートエディターで直接テンプレートを作成するか、インポート をクリックしてテキストファイルからテンプレートをアップロードします。
6. オプション: 監査コメント フィールドで、変更に関する情報を追加します。
7. Job タブをクリックし、Job category フィールドに独自のカテゴリーを入力するか、ホストの管理 の デフォルトのジョブテンプレートカテゴリー にリストされているデフォルトカテゴリーから選択します。
8. オプション: 説明形式 フィールドで説明テンプレートを入力します。(例: Install package %{package_name})。また、テンプレートでは %{template_name} および %{job_category} も使用できます。
9. プロバイダータイプ リストから、Shell スクリプトに SSH を、Ansible タスクまたは Playbook に Ansible を選択します。
10. オプション: Timeout to kill フィールドで、ジョブが完了しない場合に、ジョブを中断するタイムアウトの値を入力します。
11. オプション: 入力を追加 をクリックし、入力パラメーターを定義します。ジョブの実行時にパラメーターを要求し、テンプレートに定義する必要はありません。各種サンプルについては、ヘルプ タブを参照してください。
12. オプション: 外部入力セット をクリックして、このジョブの他のテンプレートを追加します。
13. オプション: 実効ユーザー エリアで、コマンドでデフォルトの remote_execution_effective_user 設定を使用できない場合に、ユーザーを設定します。
14. オプション: このテンプレートをスニペットとして他のテンプレートに追加する場合は、タイプ タブをクリックして、スニペット を選択します。
15. オプション: Ansible プロバイダーを使用する場合は、Ansible タブをクリックします。Enable Ansible Callback を選択すると、ジョブの終了後に、ホストが設定レポートの作成に使用されるファクトを Satellite に送信できるようになります。
16. ロケーション タブをクリックして、テンプレートを使用するロケーションを追加します。
17. 組織 タブをクリックして、テンプレートを使用する組織を追加します。
18. Submit をクリックして変更を保存します。

手順

1. 次の API 要求を使用して、利用可能な Ansible Playbook を取得します。

   # curl -X GET -H 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/fetch?proxy_id=My_capsule_ID

2. インポートする Ansible Playbook を選択し、その名前を書き留めます。

3. その名前を使用して Ansible Playbook をインポートします。

   # curl -X PUT -H 'Content-Type: application/json' -d '{ "playbook_names": ["My_Playbook_Name"] }' https://satellite.example.com/ansible/api/v2/ansible_playbooks/sync?proxy_id=My_capsule_ID

   インポートが完了すると、Satellite Web UI で通知が表示されます。

手順

1. Satellite Web UI で、Administer > Settings に移動します。
2. Remote Execution をクリックします。
3. 任意の Capsule へのフォールバック を設定します。

手順

1. Satellite Web UI で、Administer > Settings に移動します。
2. Remote Execution をクリックします。
3. グローバル Capsule の有効化 を設定します。

手順

1. Satellite Server または Capsule Server で、新しいディレクトリーを作成します。

   # mkdir /My_Remote_Working_Directory

2. デフォルトの /tmp ディレクトリーから SELinux コンテキストをコピーします。

   # chcon --reference=/tmp /My_Remote_Working_Directory

3. 新しいディレクトリーを使用するように Satellite Server または Capsule Server を設定します。

   # satellite-installer \
   --foreman-proxy-plugin-ansible-working-dir /My_Remote_Working_Directory

手順

1. Administer > Settings に移動します。
2. Remote Execution タブを選択します。
3. Effective User Method 設定の値をクリックします。
4. 新しい値を選択します。
5. Submit をクリックします。

1. 「リモート実行用の SSH 鍵の手動での配布」
2. 「Satellite API を使用したリモート実行用の SSH 鍵の取得」
3. 「プロビジョニング中に SSH キーを配布するためのキックスタートテンプレートの設定」
4. 新しい Satellite ホストの場合、グローバル登録テンプレートを使用して、登録中に SSH 鍵を Satellite ホストにデプロイすることができます。詳細は、ホストの管理 の グローバル登録テンプレートを使用した Red Hat Satellite へのホストの登録 を参照してください。

手順

1. ターゲットホストで ~/.ssh ディレクトリーを作成し、SSH 鍵を保存します。

   # mkdir ~/.ssh

2. Capsule から SSH 鍵をダウンロードします。

   # curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keys

3. ~/.ssh ディレクトリーのパーミッションを設定します。

   # chmod 700 ~/.ssh

4. authorized_keys ファイルのパーミッションを設定します。

   # chmod 600 ~/.ssh/authorized_keys

手順

1. foreman-proxy ユーザーの ID を特定します。

   # id -u foreman-proxy

2. 新しいファイルのパーミッションが 600 になるように、umask の値を変更します。

   # umask 077

3. キータブ用のディレクトリーを作成します。

   # mkdir -p "/var/kerberos/krb5/user/My_User_ID"

4. キータブを作成するか、既存のキータブをディレクトリーにコピーします。

   # cp My_Client.keytab /var/kerberos/krb5/user/My_User_ID/client.keytab

5. ディレクトリーの所有者を foreman-proxy ユーザーに変更します。

   # chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/My_User_ID"

6. キータブファイルが読み取り専用であることを確認します。

   # chmod -wx "/var/kerberos/krb5/user/My_User_ID/client.keytab"

7. SELinux コンテキストを復元します。

   # restorecon -RvF /var/kerberos/krb5

手順

1. リモート実行に Kerberos 認証をインストールおよび有効にするには、以下のコマンドを入力します。

   # satellite-installer --scenario satellite \
   --foreman-proxy-plugin-remote-execution-script-ssh-kerberos-auth true

2. リモート実行のデフォルトユーザーを編集するには、Satellite Web UI で Administer > Settings に移動して、Remote Execution タブをクリックします。SSH User 行で 2 番目のコラムを編集し、Kerberos アカウントのユーザー名を追加します。
3. remote_execution_effective_user に移動し、2 番目のコラムを編集して、Kerberos アカウントのユーザー名を追加します。

手順

1. テンプレートのクローンを作成するには、アクション コラムで、クローン を選択します。
2. クローンに一意名を指定して、送信 をクリックして変更を保存します。

手順

1. Satellite Web UI で、Monitor > Jobs に移動し、Run job をクリックします。
2. 使用する Job category と Job template を選択し、Next をクリックします。

3. ジョブを実行するホストを選択します。ホストを選択しなかった場合、現在のコンテキストで表示されているすべてのホストでジョブが実行されます。

   注記

   ホストグループとそのすべてのサブグループを選択する場合、ホストを選択するだけでは十分ではありません。なぜなら、ジョブはそのグループ内のホスト上でのみ直接実行され、サブグループ内のホスト上では実行されないからです。代わりに、ホストグループとそのすべてのサブグループを選択するか、次の検索クエリーを使用する必要があります。

   hostgroup_fullname ~ "My_Host_Group*"

   My_Host_Group は、最上位のホストグループの名前に置き換えます。

4. 必要に応じて、ジョブテンプレートの入力を行います。テンプレートによって入力項目が異なり、入力項目がないテンプレートもあります。必要な入力項目をすべて入力したら、Next をクリックします。
5. オプション: ジョブの詳細設定を行うには、Advanced fields に入力します。詳細設定の詳細は、「ジョブウィザードの詳細設定」 を参照してください。
6. Next をクリックします。

7. ジョブの時間をスケジュールします。

   • ジョブをすぐに実行するには、事前に選択されている Immediate execution をそのままにしておきます。
   • ジョブを将来実行するには、Future execution を選択します。
   • ジョブを定期的に実行するには、Recurring execution を選択します。

8. オプション: 将来または定期的な実行を選択した場合は、Query type を選択します。それ以外の場合は、Next をクリックします。

   • Static query を選択すると、指定したリストのホストでジョブが実行されます。
   • Dynamic query を選択すると、ジョブを実行する直前にホストのリストが評価されます。何らかのフィルターに基づいてホストのリストを入力した場合、そのフィルターを最初に使用したときとは異なる結果が得られることがあります。

   クエリーの種類を選択したら、Next をクリックします。

9. オプション: 将来または定期的な実行を選択した場合は、追加の詳細を入力します。

   • Future execution の場合は、Starts at に開始日時を入力します。また、Starts before の日時を選択することもできます。その時刻までにジョブを開始できない場合、ジョブはキャンセルされます。
   • Recurring execution の場合は、開始日時、頻度、および定期的なジョブを終了する条件を選択します。定期的なジョブは、終了しない、特定の時間に終了させる、または指定した回数繰り返した後に終了させることができます。また、ジョブを追跡するための特別なラベルである Purpose を追加することもできます。特定の目的を持つアクティブなジョブは、一度に 1 つしか存在できません。

   必要な情報を入力したら、Next をクリックします。

10. ジョブの詳細を確認します。ジョブウィザードの任意の部分に戻り、情報を編集することもできます。
11. Submit をクリックしてジョブの実行をスケジュールします。

CLI 手順

1. Satellite で以下のコマンドを入力します。

   # hammer settings set \
   --name=remote_execution_global_proxy \
   --value=false

2. 使用するジョブテンプレートの ID を検出します。

   # hammer job-template list

3. テンプレートの詳細を表示して、テンプレートに必要なパラメーターを確認します。

   # hammer job-template info --id My_Template_ID

4. カスタムパラメーターでリモートジョブを実行します。

   # hammer job-invocation create \
   --inputs My_Key_1="My_Value_1",My_Key_2="My_Value_2",... \
   --job-template "My_Template_Name" \
   --search-query "My_Search_Query"

   My_Search_Query は、ホストを定義するフィルター式 (例: "name ~ My_Pattern ") に置き換えます。hammer を使用したリモートコマンド実行に関する詳細については、hammer job-template --help および hammer job-invocation --help を入力します。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動し、リモートジョブを実行するターゲットホストを選択します。
2. Ansible タブで、ジョブ を選択します。
3. Schedule recurring job をクリックします。
4. Create New Recurring Ansible Run ウィンドウで、最初の実行の繰り返し頻度、開始時刻、日付を定義します。
5. Submit をクリックします。
6. オプション: ホストの概要で、または Ansible > Jobs に移動して、スケジュールされた Ansible ジョブを表示します。

手順

1. Satellite Web UI で、Configure > Host groups に移動します。
2. Actions 列で、Ansible ロールの実行をスケジュールするホストグループの Configure Ansible Job を選択します。
3. Schedule recurring job をクリックします。
4. Create New Recurring Ansible Run ウィンドウで、最初の実行の繰り返し頻度、開始時刻、日付を定義します。
5. Submit をクリックします。

手順

1. Satellite Web UI で、Monitor > Jobs に移動します。このページは、Execute now が設定されているジョブをトリガーすると自動的に表示されます。スケジュールされたジョブを監視するには、監視 > ジョブ に移動して、検査するジョブ実行を選択します。
2. ジョブページで、ホスト タブをクリックします。これにより、ジョブが実行しているホストのリストが表示されます。
3. ホスト コラムで、検査するホストの名前をクリックします。これにより、ジョブの実行をリアルタイムで監視できる コマンドの詳細 ページが表示されます。
4. いつでも ジョブに戻る をクリックして、ジョブの詳細 ページに戻ることができます。

CLI 手順

1. ジョブの ID を検出します。

   # hammer job-invocation list

2. ジョブの出力を監視します。

   # hammer job-invocation output \
   --host My_Host_Name \
   --id My_Job_ID

3. オプション: ジョブをキャンセルするには、次のコマンドを入力します。

   # hammer job-invocation cancel \
   --id My_Job_ID

手順

1. Ansible Automation Controller Web UI で、Satellite の認証情報を作成します。認証情報の作成の詳細は、Automation Controller ユーザーガイド の 新しい認証情報の追加 および Red Hat Satellite 認証情報 を参照してください。

   表5.1 Satellite の認証情報

   認証情報の種類	Red Hat Satellite 6
   Satellite URL:	https://satellite.example.com
   ユーザー名	統合ロールを持つ Satellite ユーザーのユーザー名
   パスワード	Satellite ユーザーのパスワード

2. Ansible Automation Controller ユーザーを新しい認証情報に追加します。認証情報へのユーザーの追加の詳細については、Automation Controller ユーザーガイド の 認証情報の開始 を参照してください。
3. 新しいインベントリーを追加します。詳細は、Automation Controller ユーザーガイド の 新しいインベントリーの追加 を参照してください。

4. 新規インベントリーで、Satellite Server をインベントリーソースとして追加し、以下のインベントリーソースオプションを指定します。詳細は、Automation Controller ユーザーガイド の ソースの追加 を参照してください。

   表5.2 インベントリーソースオプション

   ソース	Red Hat Satellite 6
   認証情報	Satellite Server 用に作成した認証情報
   上書き	選択
   変数の上書き	選択
   起動時の更新	選択
   キャッシュのタイムアウト	90

5. 追加したソースを同期するようにしてください。

1. ansible_provisioning_callback
2. ansible_tower_callback_script
3. ansible_tower_callback_service

1. 新規ホスト向けに、マシンの認証情報を作成します。Satellite で作成したホストに割り当てる予定の認証情報に、同じパスワードを入力するようにしてください。詳細は、Automation Controller ユーザーガイド の 新しい認証情報の追加 を参照してください。
2. プロジェクトを作成します。詳細は、Ansible Automation Controller ユーザーガイド の プロジェクト を参照してください。
3. ジョブテンプレートをプロジェクトに追加します。詳細は、Automation Controller ユーザーガイド の ジョブテンプレート を参照してください。
4. ジョブテンプレートで、プロビジョニングコールバックを有効にし、ホストの設定キーを生成して、ジョブテンプレートの template_ID をメモする必要があります。ジョブテンプレートの詳細は、Automation Controller ユーザーガイド の ジョブテンプレート を参照してください。

手順

1. Satellite Web UI で、設定 > ホストグループ に移動します。
2. ホストグループを作成するか、既存のホストグループを編集します。
3. ホストグループウィンドウで パラメーター タブをクリックします。
4. パラメーターの追加 をクリックします。

5. 新規パラメーターごとに、以下の情報を入力します。

   表5.3 ホストパラメーター

   名前	値	説明
   ansible_tower_provisioning	true	プロビジョニングコールバックを有効にします。
   ansible_tower_fqdn	controller.example.com	Ansible Automation Controller の完全修飾ドメイン名 (FQDN)。https は Satellite によって追加されるため、追加しないでください。
   ansible_job_template_id	template_ID	テンプレートの URL で確認できるプロビジョニングテンプレートの ID (/templates/job_template/5)。
   ansible_host_config_key	config_KEY	ジョブテンプレートが Ansible Automation Controller で生成するホスト設定キー。

6. Submit をクリックします。
7. ホストグループを使用してホストを作成します。

8. 新規ホストで、以下のコマンドを入力して、ansible-callback サービスを開始します。

   # systemctl start ansible-callback

9. 新規ホストで、以下のコマンドを入力して、ansible-callback サービスのステータスを出力します。

   # systemctl status ansible-callback

   プロビジョニングコールバックが正しく設定されていると、以下の出力が返ります。

   SAT_host systemd[1]: Started Provisioning callback to Ansible Automation Controller...

手順

1. Satellite Web UI で、ホスト > ジョブテンプレート に移動します。
2. 新規ジョブテンプレート をクリックします。

3. 名前 フィールドに Run Command - restorecon と入力します。デフォルト を選択して、テンプレートをすべての組織で利用できるようにします。以下のテキストをテンプレートエディターに追加します。

   restorecon -RvF <%= input("directory") %>

   <%= input("directory") %> の文字列は、ジョブの呼び出し時にユーザー定義のディレクトリーに置き換えられます。

4. ジョブ タブで、ジョブカテゴリー を Commands に設定します。
5. 入力を追加 をクリックして、ジョブのカスタマイズを可能にします。名前 フィールドに directory と入力します。入力する名前は、テンプレートエディターで指定した値と一致している必要があります。
6. 必須 をクリックし、ユーザーがパラメーターを指定しなければコマンドが実行しないようにします。
7. 入力タイプ リストから ユーザー入力 を選択します。ジョブの呼び出し中に表示する説明を入力します (例: Target directory for restorecon)。
8. Submit をクリックします。詳細は、ホストの管理 の 複数のホストで restorecon テンプレートを実行する を参照してください。

手順

1. Satellite Web UI で、Monitor > Jobs に移動し、Run job をクリックします。
2. Job category として Commands を選択し、Job template として Run Command - restorecon を選択して、Next をクリックします。
3. ジョブを実行するホストを選択します。ホストを選択しなかった場合、現在のコンテキストで表示されているすべてのホストでジョブが実行されます。
4. directory フィールドに、/home などのディレクトリーを指定し、Next をクリックします。
5. オプション: ジョブの詳細設定を行うには、Advanced fields に入力します。詳細設定の詳細は、「ジョブウィザードの詳細設定」 を参照してください。詳細設定の入力が完了したら、または入力が必要がない場合は、Next をクリックします。

6. ジョブの時間をスケジュールします。

   • ジョブをすぐに実行するには、事前に選択されている Immediate execution をそのままにしておきます。
   • ジョブを将来実行するには、Future execution を選択します。
   • ジョブを定期的に実行するには、Recurring execution を選択します。

7. オプション: 将来または定期的な実行を選択した場合は、Query type を選択します。それ以外の場合は、Next をクリックします。

   • Static query を選択すると、指定したリストのホストでジョブが実行されます。

   • Dynamic query を選択すると、ジョブを実行する直前にホストのリストが評価されます。何らかのフィルターに基づいてホストのリストを入力した場合、そのフィルターを最初に使用したときとは異なる結果が得られることがあります。

     クエリーの種類を選択したら、Next をクリックします。

8. オプション: 将来または定期的な実行を選択した場合は、追加の詳細を入力します。

   • Future execution の場合は、Starts at に開始日時を入力します。また、Starts before の日時を選択することもできます。その時刻までにジョブを開始できない場合、ジョブはキャンセルされます。

   • Recurring execution の場合は、開始日時、頻度、および定期的なジョブを終了する条件を選択します。定期的なジョブは、終了しない、特定の時間に終了させる、または指定した回数繰り返した後に終了させることができます。また、ジョブを追跡するための特別なラベルである Purpose を追加することもできます。特定の目的を持つアクティブなジョブは、一度に 1 つしか存在できません。

     必要な情報を入力したら、Next をクリックします。

9. ジョブの詳細を確認します。ジョブウィザードの任意の部分に戻り、情報を編集することもできます。
10. Submit をクリックしてジョブの実行をスケジュールします。