15. インベントリー¶

15.3.1. パーミッションの追加¶

パーミッション タブでは、ユーザーおよびチームメンバーに関連付けられたパーミッションの確認、付与、編集および削除を実行できます。このリソースについて特定ユーザーにパーミッションを割り当てるには以下を行います。

1. パーミッション タブをクリックします。

2. ボタンをクリックして、ユーザー/チームの追加ウィンドウを開きます。

3. アクセス権のあるユーザーまたはチームを指定してから、これらのユーザーやチームに特定のロールを割り当てます。

1. ユーザーまたはチームの名前の横にある 1 つまたは複数のチェックボックスをクリックしてチェックマークを付け、これらを選択します。

注釈

ユーザー と チーム タブ間を保存せずに移動して、複数のユーザーとチームを同時に選択することができます。

選択を終えると、ウィンドウが展開され、ドロップダウンメニューの一覧から選択した各ユーザーまたはチームのロールを選択できるようになります。

上記の例では、インベントリー関連のオプションが表示されます。リソース毎に、利用できるオプションが異なります。

• 管理者 は権限の読み取り、実行および編集を許可します (すべてのリソースに適用)。

• 使用 は、ジョブテンプレートのリソースの使用を許可します (ジョブテンプレート以外の全リソースに適用)。

• 更新: SCM 更新でのプロジェクトの更新を許可します (プロジェクトおよびインベントリーに適用)。

• アドホック: アドホックコマンドの使用を許可します (インベントリーに適用)。

• 実行 は、ジョブテンプレートの起動を許可します (ジョブテンプレートに適用)。

• 読み取り は、表示のみのアクセスを許可します (すべてのリソースに適用)。

ちなみに

ロールの選択ペインの キー ボタンを使用して、各ロールの説明を表示します。詳細情報は、本ガイドの「ロール」を参照してください。

2. 選択したユーザーまたはチームに適用するロールを選択します。

注釈

ユーザー と チーム タブ間を保存せずに移動すると、複数のユーザーとチームにロールを割り当てることができます。

4. 各ユーザーとチームのロールの割り当てを確認します。

5. 完了したら 保存 をクリックすると、ユーザー/チームの追加ウィンドウが閉じ、各ユーザーやチームに割り当てられた更新済みのロールが表示されます。

   

特定ユーザーのパーミッションを削除するには、そのリソースの横にある「関連付けの解除」 (x) ボタンをクリックします。

これにより確認ダイアログが起動し、関連付けの解除を確定するように求められます。

15.3.2. グループの追加¶

インベントリーは、ホストおよび他のグループか、またはホストが含まれるグループに分類されます。グループは標準インベントリーのみに適用され、スマートインベントリーから直接設定することはできません。既存グループは、標準インベントリーで使用されるホストに関連付けることができます。標準インベントリーで選択可能なアクションには以下が含まれます。

• 新規グループの作成

• 新規ホストの作成

• 選択したインベントリーでのコマンドの実行

• インベントリープロパティーの編集

• グループおよびホストのアクティビティーストリームの表示

• インベントリーの構築に関するヘルプの取得

インベントリーの新規グループを作成するには、以下を実行します。

1. 追加 ボタンをクリックして、グループの作成 ウィンドウを開きます。

2. 必須およびオプションのフィールドに該当する詳細を入力します。

• 名前: 必須

• 説明: 任意の説明を入力します (オプション)。

• 変数: このグループのすべてのホストに適用される定義および値を入力します。JSON または YAML 構文のいずれかを使用して変数を入力します。ラジオボタンを使用してこれら 2 つの間の切り替えを行います。

3. 完了したら、保存 をクリックします。

15.3.2.2. インベントリーグループの表示または編集¶

Ansible Tower 3.5 以降、一度にすべてのインベントリーグループを表示するか、フィルタリングして root グループのみを表示できるようになりました。インベントリーグループは、別のグループのサブセットでない場合には、root グループとみなされます。

依存関係を考慮せずにサブグループを削除できますが、root グループを削除する場合は、Tower は子グループやホストなど依存関係がないか検索します。削除する root グループに両依存関係が含まれる場合には、root グループおよび全サブグループとホストを削除するかどうか、またはホストとともに、トップgレベルになるようにサブグループをプロモートするかどうかの確認ダイアログが表示されます。

root グループに含まれるサブグループにホストがない場合には、単にすべて削除するか、グループをプロモートするかの確認ダイアログが表示されます。

15.3.3. ホストの追加¶

ホストをインベントリー、グループおよびグループ内のグループ用に設定することができます。ホストを設定するには、以下を実行します。

1. ホスト タブをクリックします。

2. 追加 ボタンをクリックして、設定にすでに存在するホストを追加するか、または新規ホストを作成するかどうかを選択します。

3. 新規ホストを作成する場合は、 ボタンを選択して、ジョブの実行中にこのホストを組み込むかどうかを指定します。

4. 必須およびオプションのフィールドに該当する詳細を入力します。

• ホスト名: 必須

• 説明: 任意の説明を入力します (オプション)。

• 変数: このグループのすべてのホストに適用される定義および値を入力します。JSON または YAML 構文のいずれかを使用して変数を入力します。ラジオボタンを使用してこれら 2 つの間の切り替えを行います。

5. 完了したら、保存 をクリックします。

ホストの作成 ウィンドウが閉じ、新規に作成されたホストが、元のグループに関連付けられたホストの一覧のエントリーとして表示されます。

既存ホストを追加する選択をした場合、選択可能なホストが別個の選択ウィンドウに表示されます。

ホストが選択されると、そのホストがグループに関連付けられたホストの一覧のエントリーとして表示されます。

6. To configure facts and additional groups for the host, click on the name of the host from the list of hosts.

これにより、選択したホストの「詳細」タブが開きます。

7. ファクト タブをクリックして、収集するファクトを入力します。ファクトについて詳しくは、「ファクトのキャッシング」セクションを参照してください。

8. グループ タブをクリックして、ホストのグループを設定します。

1. 追加 ボタンをクリックして、ホストを既存グループに関連付けます。

選択可能なグループが別個の選択ウィンドウに表示されます。

2. クリックして、ホストに関連付けるグループを選択し、保存 をクリックします。

グループが関連付けられると、そのグループがホストに関連付けられたグループの一覧にエントリーとして表示されます。

9. ホストがジョブの実行に使用されている場合には、このジョブの詳細は、ホストの 完了したジョブ タブで確認できます。各ジョブの詳細を表示するには、展開 をクリックします。

15.3.4. ソースの追加¶

インベントリーソースはグループに関連付けられなくなりました。Ansible Tower 3.2 より前のバージョンでは、生成されるグループやホストはインベントリーソースグループの子となりました。現在、生成されるグループは最上位に置かれます。これらのグループには子グループを持たせることができ、これらの生成されるすべてのグループにホストを含めることができます。

ソースのインベントリーへの追加は、標準インベントリーのみに適用されます。スマートインベントリーの場合、それらが関連付けられている標準インベントリーからソースを継承します。インベントリーのソースを設定するには、以下を実行します。

1. ソースを追加するインベントリーで、ソース タブをクリックします。

2. ボタンをクリックします。

これにより、「ソースの作成」ウィンドウが開きます。

3. 必須およびオプションのフィールドに該当する詳細を入力します。

• 名前: 必須

• 説明: 任意の説明を入力します (オプション)。

• ソース: インベントリーのソースを選択します。それぞれのソースや適切な情報を入力する詳細な方法は、「インベントリーソース」セクションを参照してください。Ansible Tower バージョン 3.2 以降、Rackspace Cloud Servers のサポートは廃止されました。

• Ansible 環境: このフィールドは、カスタムの仮想環境 (venv) が設定されている場合のみ表示されます。インベントリーのインポートを実行する venv を選択します。カスタムの venv の設定に関する詳細は、「Using virtualenv with Ansible Tower」を参照してください。

4. 選択した inventory source の情報を入力したら、必要に応じて、詳細、ホストフィルター、変数などのその他の共通パラメーターも指定します。

注釈

フィールドの リージョン、インスタンスフィルター、および グループ化のみ は Ansible Tower 3.8 で削除されました。

5. 詳細 ドロップダウンメニューから、インベントリーソースの更新ジョブで適切な出力レベルを選択します。

6. ホストフィルター フィールドを使用して、Tower にインポートされる一致するホスト名のみを指定します。

7. 有効な変数 で Tower を指定して、指定のホスト変数のディクショナリーから有効な状態を取得します。有効な変数は、ドット表記を使用して「foo.bar」として指定することで、ルックアップはネストされたディクショナリー (from_dict.get('foo', {}).get('bar', default) と同等) に移動します。

8. 有効な変数 フィールドでホスト変数のディクショナリーを指定した場合は、インポート時に有効にする値を指定できます。たとえば、enabled_var='status.power_state' および enabled_value='powered_on' で以下のホスト変数を使用する場合は、ホストが有効とマークされます。

{
"status": {
"power_state": "powered_on",
"created": "2020-08-04T18:13:04+00:00",
"healthy": true
},
"name": "foobar",
"ip_address": "192.168.2.1"
}

power_state が powered_on 以外になっていると、Tower にインポートしたときにホストが無効になります。キーが見つからない場合は、ホストが有効になります。

9. すべてのクラウドインベントリーソースには、以下の更新オプションがあります。

• 上書き: チェックが付いている場合、以前は外部ソースにあり、現在は削除されているホストおよびグループが Tower インベントリーから削除されます。インベントリーソースで管理されていなかったホストおよびグループは次に手動で作成されるグループにプロモートされるか、またはプロモート先となる手動で作成されたグループがない場合は、それらはインベントリーの「すべて」のデフォルトグループに残ります。

チェックが付いていない場合、外部ソースにないローカルの子ホストおよびグループは、インベントリーの更新プロセスによって処理されないままになります。

• 変数の上書き: チェックが付いている場合、子グループおよびホストの変数はすべて削除され、外部ソースで見つかったものに置き換えられます。チェックが付いていないと、マージが実行し、ローカル変数と、外部ソースで見つかったものが組み合わされます。

• 起動時の更新: このインベントリーを使用してジョブを実行するたびに、ジョブタスクの実行前に選択したソースからインベントリーの更新が実行されます。ジョブの生成速度がインベントリーの同期速度を上回る場合のジョブのオーバーフローを避けるために、これを選択して、特定の期間 (秒単位) 以前のインベントリーの同期をキャッシュするよう**キャッシュタイムアウト**を設定できます。

「起動時の更新」の設定は、プロジェクトおよびインベントリーの依存関係システムを参照しますが、特に 2 つのジョブが同時に実行されないようにする訳ではありません。キャッシュのタイムアウトを指定した場合には、2 番目のジョブの依存関係が作成され、最初のジョブで起動したプロジェクトおよびインベントリーの更新が使用されます。両方のジョブは、プロジェクトおよび/またはインベントリーの更新が終了するまで待機してから次に進みます。これらのジョブで異なるジョブテンプレートを使用しており、システムの容量がある場合には、両ジョブを同時に開始し、実行することができます。動的インベントリソースを使用する Tower のプロビジョニングコールバック機能を使用する場合には、インベントリーグループの "起動時に更新" を設定しておく必要があります。

10. 実行後にエントリーおよび選択を確認し、保存 をクリックします。これにより、通知やスケジュールなど、詳細をさらに設定することができます。

注釈

通知 タブは、新しく作成したソースを保存した後にのみ表示されます。

11. ソースの通知を設定するには、通知 タブをクリックします。

1. 通知がすでに設定されている場合は、トグルを使用して、特定のソースで使用する通知を有効または無効にします。詳細については「通知の有効化と無効化」を参照してください。

2. 通知が設定されていない場合には、詳細情報を「通知」で参照してください。

12. このインベントリーソースに関連付けられているスケジュールを設定するには、スケジュール タブをクリックします。

1. スケジュールがすでに設定されている場合には、スケジュールの設定をレビュー、編集、または有効化/無効化します。

2. スケジュールが設定されていない場合には、詳細情報を「スケジュール」で参照してください。

13. 実行後にエントリーおよび選択を確認し、保存 をクリックします。

ソースが定義されると、インベントリーに関連付けられたソースの一覧のエントリーとして表示されます。ソース タブから、単一ソースに対して同期を実行することも、1 度にすべての同期を実行することもできます。また、同期プロセスのスケジュールやソースの編集または削除など、追加のアクションを実行することもできます。

15.3.5. 完了したジョブの表示¶

インベントリーがジョブの実行に使用されている場合には、このジョブの詳細は、インベントリーの 完了したジョブ タブで確認できます。各ジョブの詳細を表示するには、展開 をクリックします。

/api/v2/hosts/?host_filter=name=localhost
/api/v2/hosts/?host_filter=ansible_facts__ansible_date_time__weekday_number="3"
/api/v2/hosts/?host_filter=ansible_facts__ansible_processor[]="GenuineIntel"
/api/v2/hosts/?host_filter=ansible_facts__ansible_lo__ipv6[]__scope="host"
/api/v2/hosts/?host_filter=ansible_facts__ansible_processor_vcpus=8
/api/v2/hosts/?host_filter=ansible_facts__ansible_env__PYTHONUNBUFFERED="true"
/api/v2/hosts/?host_filter=(name=localhost or name=database) and (groups__name=east or groups__name="west coast") and ansible_facts__an

groups.name:groupA

ansible_facts.ansible_fips:false

host_filter=name=my_host

host_filter=ansible_facts__packages__dnsmasq[]__version="2.66"