手順

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

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

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

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

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

1. Satellite Web UI で、設定 > 変数 に移動します。
2. ウィンドウの右上で、インポートする Ansible 変数を含む Capsule を選択します。
3. インポートする Ansible 変数を選択して、更新 をクリックします。

手順

1. Satellite Web UI で、設定 > 変数 に移動します。
2. 右上隅で 新規 Ansible 変数 をクリックします。
3. キー フィールドで、変数の名前を入力します。この名前が Ansible ロール名を参照していることを確認します。
4. 説明 フィールドには、変数の説明を入力します。
5. Ansible ロール リストから、Ansible ロールを選択して変数を関連付けます。
6. オプション: Satellite を使用して Ansible 変数を上書きするには、「Satellite での Ansible 変数のオーバーライド」 を参照してください。
7. Ansible 変数を保存するには、送信 をクリックします。

1. Satellite Web UI で、設定 > 変数 に移動します。
2. Satellite でオーバーライドし、管理する Ansible 変数を選択します。
3. デフォルトの動作 エリアに移動して、上書き チェックボックスを選択します。
4. パラメータータイプ から、検証の値タイプを選択します。(例: 文字列 や ブール値 の変数など)。
5. デフォルト値 フィールドで、変数と一致するものがない場合に使用するデフォルト値を入力します。
6. オプション: Ansible 変数をプレーンテキストで表示したくない場合は、値の非表示 のチェックボックスを選択し、Satellite Web UI で変数のコンテンツをアスタリスクとして表示します。
7. オーバーライド設定を保存するには、送信 をクリックします。

ホストグループの場合:

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

ホストの場合:

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

グローバルパラメーターとして追加する手順:

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

手順

1. rhel-7-server-extras-rpms リポジトリーが有効になっていることを確認します。

   # 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 で、ホスト > すべてのホスト に移動します。
2. Ansible ロールを割り当てるホストで、編集 をクリックします。
3. Ansible ロール タブを選択して、すべての項目 リストで、追加するロールを検索します。
4. 追加するロールを選択して、矢印アイコンをクリックし、選択された項目 リストにロールを移動させます。
5. 送信 をクリックします。

手順

1. Satellite Web UI で、ホスト > すべてのホスト に移動します。
2. 実行する Ansible ロールが含まれるホストのチェックボックスを選択します。
3. アクションの選択 リストから Ansible ロールのプレイ を選択します。

手順

1. Satellite Web UI で、設定 > ホストグループ に移動します。
2. ホストグループの一覧から、Ansible ロールを追加するホストグループ名をクリックします。
3. Ansible ロール タブを選択して、すべての項目 リストで、追加するロールを検索します。
4. 追加するロールを選択して、矢印アイコンをクリックし、選択された項目 リストにロールを移動させます。
5. Submit をクリックします。

手順

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

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

5. この段階で Satellite がリモート実行 Capsule を検出できず、任意の Capsule へのフォールバック 設定が有効になっている場合、Satellite は別の Capsule のセットを追加して、そこからリモート実行 Capsule を選択します。Satellite は、ホストに割り当てられている以下のタイプの Capsule の中から最も負荷の少ない Capsule を選択します。

   • ホストのサブネットに割り当てられた DHCP Capsule、DNS Capsule、および TFTP Capsule
   • ホストのドメインに割り当てられた DNS Capsule
   • ホストのレルムに割り当てられた Realm Capsule
   • Puppet Master Capsule
   • Puppet CA Capsule
   • OpenSCAP Capsule
6. この段階で Satellite がリモート実行 Capsule を検出せず、グローバル Capsule の有効化 設定が有効になっている場合、Satellite は、ホストの組織およびロケーションにあるすべての Capsule のセットから最も負荷の少ないリモート実行 Capsule を選択し、リモートジョブを実行します。

1. ホスト > ジョブテンプレート に移動します。
2. 新規ジョブテンプレート をクリックします。
3. テンプレート タブをクリックして、名前 フィールドにジョブテンプレートの一意名を入力します。
4. デフォルト を選択して、テンプレートをすべての組織およびロケーションで利用できるようにします。
5. テンプレートエディターで直接テンプレートを作成するか、インポート をクリックしてテキストファイルからテンプレートをアップロードします。
6. オプション: 監査コメント フィールドで、変更に関する情報を追加します。
7. ジョブ タブをクリックして、ジョブカテゴリー フィールドに独自のカテゴリーを入力するか、「デフォルトのジョブテンプレートカテゴリー」 に記載のデフォルトカテゴリーから選択します。
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. ロケーション タブをクリックして、テンプレートを使用するロケーションを追加します。
16. 組織 タブをクリックして、テンプレートを使用する組織を追加します。
17. 送信 をクリックして変更を保存します。

手順

1. Satellite Web UI で、管理 > 設定に移動します。
2. リモート実行 をクリックします。
3. 任意の Capsule へのフォールバック を設定します。

手順

1. Satellite Web UI で、管理 > 設定に移動します。
2. リモート実行 をクリックします。
3. グローバル Capsule の有効化 を設定します。

1. 新しいディレクトリーを作成します (例: new_place )。

   # mkdir /remote_working_dir

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

   # chcon --reference=/var /remote_working_dir

3. /etc/foreman-proxy/settings.d/ansible.yml ファイルの ansible_working_dir 設定を編集して、必要なディレクトリーにポイントさせます。以下に例を示します。

   :ansible_working_dir: /remote_working_dir

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

手順

1. Capsule で以下のコマンドを入力します。管理するターゲットホストごとに繰り返します。

   # ssh-copy-id -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy.pub root@target.example.com

2. ターゲットホストに鍵が正常にコピーされたことを確認するには、Capsule で以下のコマンドを入力します。

   # ssh -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy root@target.example.com

手順

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. Keytab のディレクトリーを作成します。

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

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

   # cp your_client.keytab /var/kerberos/krb5/user/USER_ID/client.keytab

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

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

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

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

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

   # restorecon -RvF /var/kerberos/krb5

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

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

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

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

手順

1. ホスト > すべてのホスト に移動し、リモートジョブを実行するターゲットホストを選択します。検索フィールドを使用してホストの一覧を絞り込むことができます。
2. アクションの選択 リストから リモートジョブのスケジュール を選択します。
3. ジョブ呼び出し ページで、主なジョブ設定を定義します。
4. 使用する ジョブカテゴリー および ジョブテンプレートを選択します。
5. オプション: ブックマーク リストに保存された検索文字列を選択し、ターゲットホストを指定します。
6. オプション: 検索クエリー を入力し、ターゲットホストの範囲をさらに狭めることができます。解決 行には、クエリーの影響を受けるホストの数が表示されます。更新ボタンを押して、クエリー変更後の数を再計算します。プレビューアーイコンにはターゲットホストが一覧表示されます。
7. 残りの設定は、選択したジョブテンプレートによって異なります。カスタムパラメーターをテンプレートに追加する方法は、「ジョブテンプレートの作成」 を参照してください。

8. オプション: ジョブの詳細設定を行うには、詳細フィールドの表示 をクリックします。一部の詳細設定はジョブテンプレートによって異なります。以下は一般的な設定です。

   • 実効ユーザー: ジョブを実行するためにユーザーを定義します。デフォルトは SSH ユーザーです。
   • 同時実行レベル は一度に実行するジョブの最大数を定義します。この定義で、多数のホストでジョブを実行する時に、システムのリソースに負荷が過剰にかかるのを防ぐことができます。
   • Timeout to kill は、ジョブが終了しない場合に、ジョブの強制終了までの間隔 (秒単位) を定義します。以前のタスクが終了するまで時間がかかりすぎているなど、定義した間隔で起動できなかったタスクはキャンセルされます。
   • クエリーのタイプ: 検索クエリーが評価されるタイミングを定義します。これは、スケジュールされているタスクに対してクエリーが常に最新の状態に保つのに役立ちます。

   • 実行順序 は、ジョブがホストで実行される順序を決定します (アルファベット順またはランダム)。

     同時実行レベル および Timeout to kill 設定により、お使いのインフラストラクチャーハードウェアおよびニーズに合わせてジョブ実行を調整することができます。

9. ジョブをすぐに実行する場合は、スケジュール が 今すぐ実行 に設定されていることを確認します。さらに、1 回限りのジョブを未来の日付で定義したり、定期的なジョブを設定することもできます。定期的なジョブについては、開始日と終了日、実行回数と頻度を定義できます。また cron 構文を使用して繰り返しを定義することもできます。cron の詳細は、Red Hat Enterprise Linux 7 のシステム管理者のガイドの システムタスクの自動化 セクションを参照してください。
10. 送信 をクリックします。これにより ジョブの概要 ページが表示され、ジョブの完了時にはジョブのステータスも表示されます。

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

   # hammer job-template list

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

   # hammer job-template info --id template_ID

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

   # hammer job-invocation create \
   --job-template "template_name" \
   --inputs key1="value",key2="value",... \
   --search-query "query"

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

手順

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

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

   # hammer job-invocation list

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

   # hammer job-invocation output \
   --id job_ID \
   --host host_name

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

   # hammer job-invocation cancel \
   --id job_ID

1. Ansible Tower Web UI で、Satellite に対して認証情報を作成します。認証情報の作成方法はAnsible Tower ユーザーガイドの 新規認証情報の追加 および Red Hat Satellite 6 認証情報 を参照してください。

   表4.1 Satellite の認証情報

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

2. 新しい認証情報に Ansible Tower ユーザーを追加します。ユーザーを認証情報に追加する方法はAnsible Tower ユーザーガイドの 認証情報の使用開始 を参照してください。
3. 新しいインベントリーを追加します。詳細はAnsible Tower ユーザーガイドの 新規インベントリーの追加 を参照してください。

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

   表4.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 で作成したホストに割り当てる予定の認証情報に、同じパスワードを入力するようにしてください。詳細は、Ansible Tower ユーザーガイドの 新規認証情報の追加 を参照してください。
2. プロジェクトを作成します。詳細は、Ansible Tower ユーザーガイドの プロジェクト を参照してください。
3. ジョブテンプレートをプロジェクトに追加します。詳細情報は、Ansible Tower ユーザーガイドの ジョブテンプレート を参照してください。
4. ジョブテンプレートで、プロビジョニングコールバックを有効にし、ホストの設定キーを生成して、ジョブテンプレートの template_ID をメモする必要があります。ジョブテンプレートの詳細は、Ansible Tower User Guide の Job Templates を参照してください。

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

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

   表4.3 ホストパラメーター

   名前	値	説明
   ansible_tower_provisioning	true	プロビジョニングコールバックを有効にします。
   ansible_tower_fqdn	tower.example.com	Ansible Tower の完全修飾ドメイン名 (FQDN)。https は Ansible Tower が追加するので、追加する必要はありません。
   ansible_job_template_id	template_ID	テンプレートの URL で確認できるプロビジョニングテンプレートの ID (/templates/job_template/5)。
   ansible_host_config_key	config_KEY	Ansible Tower のジョブテンプレートが作成したホスト設定キー。

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