18.4. 新規インベントリーの追加

手順

1. ナビゲーションパネルから、Resources Inventories を選択します。
2. テンプレートを選択し、Access tab で Add をクリックします。
3. 追加するユーザーまたはチームを選択し、Next をクリックします。
4. 名前の横にあるチェックボックスを選択して、リストからユーザーまたはチームを 1 つ以上メンバーとして追加します。

5. Next をクリックします。

   

   この例では、追加するユーザーが 2 つ選択されています。

6. 選択したユーザーまたはチームに付与するロールを選択します。下にスクロールして、ロールの完全なリストを表示します。リソースが異なれば、利用可能なオプションも異なります。

   

7. Save をクリックして、選択したユーザーまたはチームにロールを適用し、メンバーとして追加します。

手順

1. グループを追加するインベントリー名を選択します。
2. インベントリーの Details ページで、Groups タブを選択します。
3. Add をクリックして Create Group ウィンドウを開きます。

4. 適切な詳細を入力します。

   • Name: 必須
   • オプション: Description: 必要に応じて説明を入力します。
   • Variables: このグループ内のすべてのホストに適用される定義と値を入力します。JSON または YAML 構文を使用して変数を入力します。ラジオボタンを使用して、その 2 つを切り替えます。
5. Save をクリックします。
6. テンプレートにグループを追加すると、Group details ページが表示されます。

手順

1. グループを追加するインベントリー名を選択します。
2. インベントリーの Details ページで、Hosts タブを選択します。
3. Add をクリックします。
4. 設定にすでに存在するホストを追加するか、新しいホストを作成するかを選択します。
5. 新しいホストを作成する場合は、トグルを On に設定して、ジョブの実行中にこのホストを含めます。

6. 適切な詳細を入力します。

   • Host Name (必須):
   • オプション: Description: 必要に応じて説明を入力します。

   • Variables: 次の例のように、このグループ内のすべてのホストに適用される定義と値を入力します。

     {
       ansible_user : <username to ssh into>
       ansible_ssh_pass : <password for the username>
       ansible_become_pass: <password for becoming the root>
     }

     JSON または YAML 構文を使用して変数を入力します。ラジオボタンを使用して、その 2 つを切り替えます。

7. Save をクリックします。

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

   

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

   ホストを選択すると、グループに関連付けられているホストのリストに表示されます。

9. この画面でホストを選択し、 アイコンをクリックしてホストの関連付けを解除します。

   注記

   この画面からアドホックコマンドを実行することもできます。詳細は、「アドホックコマンドの実行」を参照してください。

10. ホストの追加グループを設定するには、ホストのリストからホストの名前をクリックします。

    

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

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

12. Add をクリックして、ホストを既存のグループに関連付けます。選択可能なグループが別個の選択ウィンドウに表示されます。

    

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

    グループが関連付けられている場合、そのグループはホストに関連付けられているグループのリストに表示されます。

14. ホストを使用してジョブを実行した場合は、ホストの Completed Jobs タブでそのようなジョブの詳細を表示できます。

15. Expanded をクリックして、各ジョブの詳細を表示します。

    

手順

1. ソースを追加するインベントリー名を選択します。
2. インベントリーの Details ページで、Sources タブを選択します。

3. Add をクリックします。これにより、Create Source ウィンドウが開きます。

   

4. 適切な詳細を入力します。

   • Name (必須):
   • オプション: Description: 必要に応じて説明を入力します。
   • オプション: Execution Environment: アイコンを選択するか、インベントリーのインポートを実行する実行環境の名前を入力します。実行環境の構築の詳細は、実行環境 を参照してください。
   • Source: Inventory のソースを選択します。ソースの詳細と適切な情報の提供については、インベントリーソース を参照してください。
5. 選択した インベントリーソース の情報がすべて揃ったら、オプションで、冗長性、ホストフィルター、変数などの他の共通パラメーターを指定できます。
6. Verbosity メニューを使用して、インベントリーソースの更新ジョブの出力レベルを選択します。
7. Host Filter フィールドを使用して、automation controller. にインポートされる一致するホスト名のみを指定します。
8. Enabled Variable フィールドで、Automation controller がホスト変数のディクショナリーから有効な状態を取得することを指定します。ドット表記を使用して有効な変数を 'foo.bar' として指定できます。この場合、ルックアップは from_dict.get('foo', {}).get('bar', default) と同等のネストされたディクショナリーを検索します。

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

   {
   "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 以外の値の場合、Automation controller へのインポート時にホストは無効になります。キーが見つからない場合、ホストは有効になっています。

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

    • Overwrite: チェックされている場合は、外部ソースにこれまで存在していたが現在は削除されているホストとグループが Automation controller インベントリーから削除されます。インベントリーソースの管理対象ではなかったホストとグループは、次に手動で作成されたグループにプロモートされます。または、これらをプロモートする手動で作成されたグループがない場合は、インベントリーの「すべて」のデフォルトグループに残されます。

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

    • Overwrite Variables: チェックが付けられている場合、子グループとホストのすべての変数が削除され、外部ソースで見つかった変数に置き換えられます。

      チェックが付けられていない場合は、ローカル変数と外部ソースにあるものを組み合わせるマージが実行されます。

    • Update on Launch: このインベントリーを使用してジョブを実行するたびに、ジョブタスクの実行前に選択したソースからのインベントリーが更新されます。

      インベントリーの同期よりも早くジョブが生成された場合のジョブのオーバーフローを回避するために、こちらを選択すると、以前のインベントリー同期を一定の秒数キャッシュするための Cache Timeout を設定できます。

      Update on Launch 設定は、プロジェクトとインベントリーの依存関係システムを参照しており、2 つのジョブの同時実行を特に除外するものではありません。

      キャッシュタイムアウトが指定されている場合、2 番目のジョブの依存関係が作成され、最初のジョブが生成したプロジェクトとインベントリーの更新が使用されます。

      その後、両方のジョブは、そのプロジェクトまたはインベントリーの更新が完了するのを待ってから続行します。ジョブテンプレートが異なり、システムにその機能がある場合は、両方を同時に開始および実行できます。動的インベントリーソースで Automation controller のプロビジョニングコールバック機能を使用する場合は、インベントリーグループに対して 起動時の更新 を設定する必要があります。

      起動時の更新 が設定されているプロジェクトを使用するインベントリーソースを同期すると、インベントリーの更新が開始される前に、(キャッシュタイムアウトルールに従って) プロジェクトが自動的に更新される可能性があります。

      テンプレートが使用するのと同じプロジェクトから取得するインベントリーを使うように、ジョブテンプレートを作成できます。このような場合、プロジェクトが更新されてからインベントリーが更新されます (更新がまだ進行中でない場合、またはキャッシュタイムアウトがまだ期限切れになっていない場合)。

11. 入力内容と選択内容を確認します。これにより、スケジュールや通知などの追加の詳細を設定できます。

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

    • スケジュールがすでに設定されている場合は、スケジュール設定を確認、編集、有効化または無効化します。
    • スケジュールが設定されていない場合、スケジュールの設定の詳細は、スケジュール を参照してください。

1. インベントリーの Details ページで、Notifications を選択します。

   注記

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

   

2. 通知がすでに設定されている場合は、トグルを使用して、特定のソースで使用する通知を有効または無効にします。詳細は、通知の有効化と無効化 を参照してください。
3. 通知が設定されていない場合、詳細は 通知 を参照してください。
4. 入力内容と選択内容を確認します。
5. Save をクリックします。