14. プロジェクト¶

14.1.1. Playbook の手動による管理¶

• Playbook を保管する 1 つ以上のディレクトリーをプロジェクトのベースパス (例: /var/lib/awx/projects/) に作成します。

• Playbook ファイルを作成し、これを Playbook ディレクトリーにコピーします。

• Playbook ディレクトリーおよびファイルが、Tower サービスを実行するのと同じ UNIX ユーザーおよびグループで所有されていることを確認します。

• パーミッションが Playbook ディレクトリーおよびファイルについて適切であることを確認します。

プロジェクトパスを追加する際に問題がある場合は、プロジェクトディレクトリーおよびファイルのパーミッションおよび SELinux コンテキスト設定を確認します。

14.1.2. ソースコントロールの使用による Playbook の管理¶

注釈

デフォルトでは、Ansible Tower にシステム全体の設定があり、この設定で SCM プロジェクト用に requirements.yml ファイルからロールを動的にダウンロードできます。ロールのダウンロードを有効にする の切り替えボタンを オフ にすることで、設定 () メニューの ジョブ タブにあるこのオプションをオフにできます。

1. SCM タイプ ドロップダウンメニューの一覧から適切なオプションを選択します。

2. 以下のフィールドに該当する詳細を入力します。

• SCM URL: ヘルプ テキストの例を参照できます。

• SCM ブランチ/タグ/コミット: オプションで、ソースコントロール (Git、Subversion、または Mercurial) からチェックアウトする SCM ブランチ、タグ、コミットハッシュ値、任意の参照 (ref)、リビジョン番号 (該当する場合) を入力します。コミットハッシュ値および参照の中には、次のフィールドでカスタムの refspec も指定しないと使用できないものがあります。

• SCM Refspec: このフィールドは git ソースコントロール専用のオプションであり、git の知識があり、問題なく使用できる上級ユーザーのみが、リモートリポジトリーからダウンロードする参照を指定する必要があります。詳細については、「job branch overriding」を参照してください。

• SCM Credential (SCM 認証情報): 認証が必要な場合には、適切な SCM 認証情報を選択します。

• SCM 更新オプション:

• クリーニング: 更新の実行前にローカルの変更を削除します。

• 更新時の削除: 更新の実行前にローカルリポジトリーを完全に削除します。リポジトリーのサイズによっては、更新の完了までにかかる時間が大幅に増大します。

• 起動時のリビジョン更新: 起動時の更新: このプロジェクトを使用してジョブを実行する場合には、ジョブの開始前にローカルリポジトリーの更新を実行します。プロジェクトの同期速度よりジョブの起動速度が上回る場合のジョブのオーバーフローを避けるため、これを選択して、プロジェクトが同期するまでにキャッシュする具体的な秒数について、キャッシュのタイムアウトを設定できます。

• ブランチの上書きを許可する: このプロジェクトを使用するジョブテンプレートが、指定の SCM ブランチまたは、プロジェクトのリビジョン以外のリビジョンで起動できるようにします。詳細については、「job branch overriding」を参照してください。

3. 保存 をクリックしてプロジェクトを保存します。

ちなみに

GitHub リンクを使用すると、Playbook を簡単に使用できます。使用を開始するには、helloworld.yml ファイル (https://github.com/ansible/tower-example.git より利用可能) を使用します。

このリンクから、Ansible Tower Quick Start Guide の説明に従って手動で作成されたものに非常に似ている Playbook を追加することができます。これを使用しても、システムが変更されたり、破損することはありません。

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

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

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

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

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

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

注釈

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

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

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

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

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

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

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

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

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

ちなみに

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

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

注釈

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

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

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

   

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

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

14.5.1. プロジェクトのスケジュール¶

プロジェクトの実行をスケジュールするには、スケジュール タブをクリックします。

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

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