Cloud Assembly での Ansible Tower 統合の設定

Ansible Tower を Cloud Assembly に統合すると、展開されたリソースの構成管理をサポートできます。統合の設定後、クラウドテンプレートエディタを使用して、新しい展開または既存の展開に Ansible Tower 仮想コンポーネントを追加できます。

前提条件

管理者以外のユーザーに、Ansible Tower へのアクセスに適切な権限を付与します。ほとんどの構成で機能する 2 つのオプションがあります。構成に最適なオプションを選択してください。
- 組織レベルでインベントリ管理者ロールおよびジョブテンプレート管理者ロールをユーザーに付与します。
- 特定のインベントリに対する管理者権限と、プロビジョニングに使用するすべてのジョブテンプレートに対する実行ロールをユーザーに付与します。
展開で使用する認証情報とテンプレートを Ansible Tower で適切に設定する必要があります。テンプレートには、ジョブテンプレートまたはワークフローテンプレートを使用できます。ジョブテンプレートでは、展開で使用するインベントリと Playbook を定義します。ジョブテンプレートと Playbook は 1:1 でマッピングされます。Playbook では、YAML に似た構文を使用して、テンプレートに関連付けられたタスクを定義します。最も一般的な展開では、認証にマシンの認証情報を使用します。

ワークフローテンプレートを使用すると、ユーザーはジョブテンプレート、プロジェクト同期、インベントリ同期の任意の構成によるシーケンスを作成することで、これらを相互にリンクして 1 つのユニットとして実行できます。Ansible Tower Workflow Visualizer は、ユーザーがワークフローテンプレートを設計するのに役立ちます。最も一般的な展開では、認証にマシンの認証情報を使用できます。
1. Ansible Tower にログインして、[テンプレート] セクションに移動します。
2. [新規ジョブテンプレートの追加] を選択します。
  - すでに作成されている認証情報を選択します。これらは、Ansible Tower で管理されるマシンの認証情報です。それぞれのジョブテンプレートでは、認証情報オブジェクトを 1 つ使用できます。
  - [制限] の選択項目では [起動時にプロンプトを表示] を選択します。これにより、Cloud Assembly からプロビジョニングまたはプロビジョニング解除されるノードに対して、ジョブテンプレートが実行されます。このオプションが選択されていない場合は、ジョブテンプレートを含むブループリントを展開するときに、「制限が設定されていない」という旨のエラーが表示されます。
3. 新規ワークフローテンプレートの追加を選択します。
  - すでに作成されている認証情報を選択し、インベントリを定義します。Workflow Visualizer を使用して、ワークフローテンプレートを設計します。
  ワークフローテンプレートまたはジョブテンプレートの [制限] ボックスでは、通常、[起動時にプロンプトを表示] を選択します。この選択により、ジョブテンプレートまたはワークフローテンプレートは、Cloud Assembly からプロビジョニングまたはプロビジョニング解除されるノードに対して実行されます。
Cloud Assembly から起動されたジョブテンプレートまたはワークフローテンプレートの実行は、[Ansible Tower ジョブ] タブで確認できます。

手順

[インフラストラクチャ] > [接続] > [統合] の順に選択して、[統合の追加] をクリックします。
[Ansible Tower] をクリックします。
Ansible の設定画面が表示されます。
Ansible Tower インスタンスの [ホスト名]（IP アドレスも可）とその他の必須情報を入力します。
該当する Ansible Tower インスタンスのユーザーインターフェイスベース認証の [ユーザー名] と [パスワード] を入力します。
[検証] をクリックして、統合を検証します。
統合の [名前] と [説明] を適切に入力します。
[追加] をクリックします。

結果

Ansible Tower はクラウドテンプレートで使用できます。

次のタスク

目的のクラウドテンプレートに Ansible Tower コンポーネントを追加します。統合アカウントで指定されたユーザーに対して、実行権限を含む適切なジョブテンプレートを指定する必要があります。

[クラウドテンプレートキャンバス] 画面のブループリントオプションメニューで、[構成管理] の見出しの下にある [Ansible] を選択し、Ansible Tower コンポーネントをキャンバスにドラッグします。
右側のパネルで、ジョブテンプレートなどの該当する Ansible Tower プロパティを構成します。

Ansible Tower タイルをクラウドテンプレートに追加すると、vRealize Automation は接続された仮想マシンのホストエントリを Ansible Tower に作成します。デフォルトでは、vRealize Automation は仮想マシンのリソース名を使用してホストエントリを作成しますが、ブループリント YAML の hostName プロパティを使用して任意の名前を指定できます。マシンと通信するために、vRealize Automation はホストエントリのホスト変数 ansible_host: IP Address を作成します。デフォルトの動作をオーバーライドして、FQDN を使用して通信を構成できます。それには、キーワード ansible_host を hostVariables 下で指定し、その値として FQDN を指定します。次の YAML コードスニペットは、ホスト名と FQDN の通信を構成する方法の例を示しています。

Cloud_Ansible_Tower_1:
	type: Cloud Ansible Tower
	properties:
		host: name of host
		account: name of account
		hostName: resource name
		hostVariables:
			ansible_host:Host FQDN

この例では、FQDN を指定して、ansible_host のデフォルト値をオーバーライドします。これは、Ansible Tower を FQDN を使用してホストマシンに接続するユーザーに役立つ場合があります。

YAML 内の hostVariables のデフォルト値は ansible_host:IP_address で、IP アドレスがサーバとの通信に使用されます。

Ansible Tower の YAML count プロパティが 1 を超える場合、ホスト名はそれぞれの仮想マシンのプロパティにマッピングできます。次の例は、アドレスプロパティをホスト名にマッピングする場合の Ubuntu-VM という名前の仮想マシンリソースのマッピングを示しています。

 hostname: '${resource.Ubuntu-VM.address[count.index]}'

Ansible Tower コンポーネントをクラウドテンプレートに追加する際に、呼び出すジョブテンプレートをクラウドテンプレート YAML で指定できます。ワークフローテンプレート、またはジョブテンプレートとワークフローテンプレートの組み合わせを指定することもできます。テンプレートタイプを指定しない場合、デフォルトでは、vRealize Automation はジョブテンプレートを呼び出すと見なします。

次の YAML スニペットは、Ansible Tower クラウドテンプレートでジョブテンプレートとワークフローテンプレートの組み合わせを呼び出す方法の例を示しています。

Cloud_Ansible_1:
type: Cloud.Ansible.Tower
  properties:
    host: ‘${resource.CentOS_Machine.*}’
    account:
    maxConnectionRetries: 2
    maxJobRetries: 2
    templates:
      provision:
        - name: My workflow
          type: workflow
        - name: My job template

Ansible 関連の障害を処理するために、maxConnectionsRetries および maxJobRetries を追加しました。クラウドテンプレートはカスタム値を受け入れ、値が指定されていない場合はデフォルト値を使用します。maxConnectionRetries のデフォルト値は 10、maxJobRetries のデフォルト値は 3 です。

注： vRealize Automation の以前のバージョンでジョブテンプレートの実行がサポートされていたのは、クラウドテンプレートで jobTemplate スキーマを使用する場合だけでした。今回、jobTemplate は非推奨となり、今後のリリースで削除される可能性があります。現時点では、jobTemplate プロパティを使用しても引き続き想定どおりに動作します。ワークフローテンプレートを実行して追加機能を使用するには、テンプレートスキーマを使用することをお勧めします。

Ansible Tower 統合のための Cloud Assembly クラウドテンプレートには true または false の値を持つ useDefaultLimit プロパティが含まれ、これにより、Ansible テンプレートが実行される場所が決まります。Ansible テンプレートには、ジョブテンプレートまたはワークフローテンプレートを使用できます。この値を true に設定すると、指定されたテンプレートは Ansible テンプレート画面の [制限] ボックスで指定されたマシンに対して実行されます。値が false に設定されている場合、テンプレートはプロビジョニングされたマシンに対して実行されますが、ユーザーは Ansible Tower テンプレート画面の [起動時にプロンプトを表示] チェックボックスをオンにする必要があります。デフォルトでは、このプロパティの値は false です。次の YAML の例は、クラウドテンプレートで useDefaultLimit プロパティがどのように記述されるかを示しています。

templates:
  provision:
    - name: ping aws_credentials
      type: job
      useDefaultLimit: false
      extraVars: '{"rubiconSurveyJob" : "checkSurvey"}'

また、前の例に示すように、extraVars プロパティを使用して追加の変数または調査変数を指定できます。この機能は、入力を要求するテンプレートを実行するときに役立ちます。ユーザーが調査変数を管理している場合は、エラーを回避するために、クラウドテンプレートの extraVars セクションで変数を渡す必要があります。