Documentation

10. awx-manage ユーティリティー

awx-manage (以前の awx-manage) ユーティリティーは、詳細にわたる Tower 内の情報にアクセスする際に使用します。awx-manage のコマンドは、awx または root ユーザーとして実行してください。

10.1. インベントリーのインポート

awx-manage は、カスタムインベントリースクリプトを使用することができないユーザー向けに、Tower の管理者が Tower にインベントリーを直接インポートするメカニズムのことです。

awx-manage を正しく使用するには、まずインポート先として使用できるように Tower にインベントリーを作成する必要があります。

awx-manage のヘルプは、awx-manage inventory_import [--help] のコマンドを実行します。

inventory\_import コマンドは、テキストベースのインベントリーファイル、動的なインベントリースクリプト、またはコアの Ansible でサポートされている上記のファイルやスクリプトのディレクトリーと、Tower のインベントリーオブジェクトを同期します。

コマンドの実行時に、--inventory-id または --inventory-name、Ansible インベントリーのソースへのパス (--source) のいずれかを指定します。

awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1

デフォルトでは、Tower にすでに保存されているインベントリーデータと、外部ソースからのデータは混在します。外部データのみを使用するには、--overwrite を指定します。既存のホストが --source のみから変数データを取得するように設定するには、--overwrite_vars を指定します。デフォルトの動作は、外部ソースから新しい変数を追加して、既存のキーについては上書きしますが、外部のデータソースから取得していない変数は保持されます。

awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1 --overwrite

注釈

Ansible Tower 2.4.0 リリースでは、--overwrite_vars設定されていない限り、インベントリーホスト変数への編集や追加はインベントリーの同期後も永続されるようになりました。インベントリーの同期を以前と同じように動作させるには、--overwrite--overwrite_vars の両方を設定する必要があります。

10.2. 以前のデータの消去

awx-manage には、Tower から以前のデータを消去する際に使用するコマンドが複数あります。Tower 管理者は、Tower Managment ジョブインターフェースからコマンドラインにアクセスするか、コマンドラインを使用することができます。

  • awx-manage cleanup_jobs [--help]

このコマンドでは、ジョブの詳細や、指定の日数以前のジョブの出力が完全に削除されます。

  • awx-manage cleanup_activitystream [--help]

このコマンドでは、指定の日数以前の activity stream のデータを削除します。

10.3. HA 管理

awx-manage provision_instanceawx-manage deprovision_instance コマンドの詳細は、「クラスタリング」のセクションを参照してください。

注釈

Ansible サポートからの指示がない限り、他の awx-manage コマンドは実行しないようにしてください。