1. Tower インストールの準備¶

1.1. インストールおよびリファレンスガイド¶

本ガイドは基本事項を対象としていますが、より詳しい情報が必要な場合には、『Installation and Reference Guide』を参照してください。

「General Installation Notes 」を参照してから、インストールを開始してください。

1.2. 前提条件および要件¶

For platform information, refer to プラットフォーム固有のインストールに関する注意点.

Ansible Tower には以下の要件があります。

• サポート対象のオペレーティングシステム:

  • Red Hat Enterprise Linux 8.0 or later 64-bit (x86) (only Ansible Tower 3.5 and greater can be installed)

  • Red Hat Enterprise Linux 7.4 or later 64-bit (x86)

  • CentOS 7.4 or later 64-bit (x86)

• Mozilla Firefox または Google Chrome の現行のサポートバージョン

  • その他の HTML 5 準拠の Web ブラウザーは機能する場合がありますが、完全にテストまたはサポートされていません。

• Tower のインストールには、最低でも CPU が 2 つ 必要です。特定の設定でのフォーク数に必要とされる CPU の容量を判断するには、『 Ansible Tower User Guide 』の「capacity algorithm」のセクションを参照してください。

• 最小 4 GB のメモリー *(Tower のインストール)

  • 4 GB のメモリー (Vagrant 試用版のインストールには推奨最小要件)

  • 4 GB メモリー (外部のスタンドアロン PostgreSQL データベースには最小要件)

  • 固有のメモリー要件については、『 Ansible Tower User Guide 』の「capacity algorithm」セクションを参照して、特定の設定でのフォーク数に必要とされる容量を判断してください。

• Tower サービスモード専用の ハードディスク容量 20 GB

  • 要件 20 GB 中で /var/ 専用に 10 GB 分割り当てる必要があります。/var/ は Tower がファイルおよび作業ディレクトリーを保存する場所です。

  • ストレージボリュームは、最低ベースラインとして IOPS が 750 となるようにする必要があります。

• データベースを含むノード専用の ハードディスク容量 20 GB (150 GB 以上を推奨)

  • ストレージボリュームは、ベースライン IOPS (1000 以上) を高くする必要があります。

  • Tower データはすべてデータベースに格納されます。データベースストレージは、管理するホスト、実行するジョブ数、ファクトキャッシュに保存するファクト数、個別ジョブのタスク数に合わせて増加します。たとえば、ホスト 250 台とタスク 20 件に対して 1 時間毎 (1 日に 24 回) に実行される Playbook は毎週データベースに 80 万件以上のイベントを保存します。

  • データベースに十分な容量が確保されていない場合には、以前のジョブ実行やファクトを定期的に消去する必要があります。詳しい情報は、『 Ansible Tower User Guide 』の「Management Jobs」を参照してください。

• 64 ビットのサポートが必要 (カーネルとランタイム)

• |at| 3.2 以降を実行するには PostgreSQL バージョン 10 が必要

• ** Ansible Tower バージョン 3.2 以降を実行するには (最低でも) Ansible バージョン 2.2 が必要**

• Amazon EC2 の場合:

  • インスタンスのサイズは m4.large 以上

  • ホスト 100 台以上ある場合には m4.xlarge 以上

max_connections == 1024
shared_buffers == ansible_memtotal_mb*0.3
work_mem == ansible_memtotal_mb*0.03
maintenance_work_mem == ansible_memtotal_mb*0.04

1.3. Tower のインストールシナリオ¶

Tower は、以下のシナリオの 1 つを使用してインストールすることができます。

単一マシン:

• 統合インストールとして:

  • これは Tower を単一のマシンにインストールしたものです。Web フロントエンド、REST API バックエンド、データベースがすべて単一のマシンに含まれています。これは、Tower の標準インストールです。また、お使いの OS ベンダーリポジトリーから PostgreSQL もインストールされ、Tower サービスがデータベースとして使用するように設定されます。

• 外部データベースの使用 (利用可能なオプションは 2 つ):

  • リモートの DB 設定のある Tower: この構成では、単一マシンに Tower サーバーをインストールし、Tower のデータベースとして、PostgreSQL 10 のリモートのインスタンスと対話するように設定します。このリモートの PostgreSQL には自身で管理するサーバーを使用することも、Amazon RDS などのクラウドサービスで提供することも可能です。

  • Playbook でインストールされたリモートの PostgreSQL システムを含む Tower: この構成では、単一のマシンに Tower サーバーをインストールし、(Tower が管理する) Playbook インストーラーでリモートの PostgreSQL データベースをインストールします。

従来の Tower のインストールに使用できる設定:

• pg_sslmode は、PostgreSQL クライアントの SSL 機能 (Tower サーバーがデータベースにどのように接続するか) を制御します。初期設定は、prefer です。この設定では、データベースサーバーに SSL がある場合は、クライアントで SSL を使用します。また、verify-full に設定して、SSL を有効にし、証明書の信頼を完全に検証することも可能です。

• web_server_ssl_cert および web_server_ssl_key では、Tower UI と API 向けの Web サーバーにインストールする証明書とキーをユーザーが指定できるようにします。この設定は、両方指定するか、両方指定しないようにしてください。指定しない場合には、自己署名 (信頼されていない) 証明書がインストール時に生成されます。

• postgres_use_ssl (true/false): SSL を必須として PostgreSQL サーバーを設定するかどうかを制御します。これは、内部/埋め込みデータベースでのみ (Tower インストールスクリプトがデータベースサーバーのデプロイメントを実行している場合) 効果があり、外部データベースには影響はありません。

• postgres_ssl_cert および postgres_ssl_key: postgres_use_ssl が true の場合に指定する必要があります。この証明書には、Tower ノードがデータベースサーバーへの接続に使用するホスト名と一致する CN (またはワイルドカード、サブジェクトの別名など) が必要です。

• rabbitmq_use_ssl (true/false): RabbitMQのノード間通信を暗号化するかどうかを制御します。これが true に設定されている場合には、インストールスクリプトで 1 回限りの「固定」CA とサーバー証明書が生成されます。RabbitMQ の証明書を指定する必要はありません。

OpenShift ベースのデプロイメントについては、「 OpenShift Deployment and Configuration 」を参照してください。

高可用性の複数マシンクラスター:

Tower は高可用性クラスターモードでインストールできます。このモードでは、複数の Tower ノードがインストールされ、アクティブ化されます。どのノードでも HTTP 要求を受信でき、すべてのノードがジョブを実行することができます。

• クラスター化された Tower の設定は、外部のデータベースでインストールする必要があります (利用可能なオプションは 2 つ)。

  • リモートの DB 設定のある Tower: この構成では、単一マシンに Tower サーバーをインストールし、Tower のデータベースとして、PostgreSQL のリモートのインスタンスと対話するように設定します。このリモートの PostgreSQL は自身で管理するサーバーを使用することも、Amazon RDS などのクラウドサービスで提供することも可能です。

  • Playbook でインストールされたリモートの PostgreSQL システムを含む Tower: この構成では、単一のマシンに Tower サーバーをインストールし、(Tower が管理する) Playbook インストーラーでリモートの PostgreSQL データベースをインストールします。

• クラスター化の設定に関する情報は、「クラスタリング」を参照してください。