3.3. データベースを使用した同一ノードへの Automation Hub のインストール
これらの手順に従って、同じノード上のデータベース、またはインストーラー以外が管理するデータベースを使用して Automation Hub のスタンドアロンインスタンスをインストールできます。
3.3.1. 前提条件
- Red Hat Ansible Automation Platform Product Software からプラットフォームインストーラーを選択して入手している。
- ベースシステムの要件を満たすマシンにインストールしている。
- すべてのパッケージが RHEL ノードの最新バージョンに更新されている。
Ansible Automation Platform をインストールする前に、RHEL ノードを完全にアップグレードしないと、エラーが発生する可能性があります。
- レジストリーサービスアカウントの作成 ガイドの手順に従って Red Hat レジストリーサービスアカウントを作成している。
- すべてのノードで NTP クライアントを設定する必要があります。詳細は、Chrony を使用した NTP サーバーの設定 を参照してください。
3.3.2. Red Hat Ansible Automation Platform インストーラーのインベントリーファイルの編集
Red Hat Ansible Automation Platform インストーラーのインベントリーファイルを使用して、インストールシナリオを指定できます。
手順
インストーラーに移動します。
[バンドルのインストーラー]
$ cd ansible-automation-platform-setup-bundle-<latest-version>
[オンラインインストーラー]
$ cd ansible-automation-platform-setup-<latest-version>
-
テキストエディターで
inventoryファイルを開きます。 -
inventoryファイルのパラメーターを編集して、インストールシナリオを指定します。以下の例に従ってください。
3.3.3. スタンドアロンの Automation Hub のインベントリーファイルの例
以下の例では、Automation Hub のスタンドアロンインスタンスをデプロイするためにインベントリーファイルを設定する方法を説明します。
-
Red Hat Ansible Automation Platform または自動化ハブの場合:
[automationhub]グループに自動化ハブホストを追加します。Automation Controller と Automation Hub を同じノードにインストールすることはできません。 -
[automationhub]ホストに到達可能な IP アドレスまたは完全修飾ドメイン名 (FQDN) を指定して、ユーザーが別のノードから Automation Hub のコンテンツを同期してインストールできるようにします。「localhost」は使用しないでください。 -
registry_usernameおよびregistry_passwordに Red Hat Registry Service Account の認証情報を入力し、Red Hat コンテナーレジストリーにリンクします。
[automationcontroller] [automationhub] <FQDN> ansible_connection=local [all:vars] registry_url='registry.redhat.io' registry_username='<registry username>' registry_password='<registry password>' automationhub_admin_password= <PASSWORD> automationhub_pg_host='' automationhub_pg_port='' automationhub_pg_database='automationhub' automationhub_pg_username='automationhub' automationhub_pg_password=<PASSWORD> automationhub_pg_sslmode='prefer' # The default install will deploy a TLS enabled Automation Hub. # If for some reason this is not the behavior wanted one can # disable TLS enabled deployment. # # automationhub_disable_https = False # The default install will generate self-signed certificates for the Automation # Hub service. If you are providing valid certificate via automationhub_ssl_cert # and automationhub_ssl_key, one should toggle that value to True. # # automationhub_ssl_validate_certs = False # SSL-related variables # If set, this will install a custom CA certificate to the system trust store. # custom_ca_cert=/path/to/ca.crt # Certificate and key to install in Automation Hub node # automationhub_ssl_cert=/path/to/automationhub.cert # automationhub_ssl_key=/path/to/automationhub.key
3.3.4. 設定スクリプトフラグおよび追加変数
設定スクリプトを実行して Automation Controller をインストールする場合に、フラグおよび追加変数を指定することもできます。
表3.7 フラグ
| 引数 | 説明 |
|---|---|
|
| ヘルプメッセージを表示して終了します。 |
|
|
Ansible インベントリーファイルへのパス (デフォルト: |
|
| 追加の Ansible 変数を key=value または YAML/JSON として設定します。 |
|
| インストールの代わりにデータベースのバックアップを実行します。 |
|
| インストールの代わりにデータベースの復元を行います。 |
|
| SECRET_KEY を生成 および 配布します。 この引数を使用して setup.sh スクリプトを実行すると、デフォルトで、新しい秘密鍵が Automation Controller に対して生成および配布されますが、自動化サービスカタログに対しては配布されません。
Automation Controller と自動化サービスカタログの両方に新しい秘密鍵を生成して配布するには、変数 |
-- の区切り文字を使用して、適用する Ansible 引数を追加します。たとえば、./setup.sh -i my_awesome_inventory.yml -e matburt_is_country_gold=True — -K となります。
-rを渡してデータベース復元を実行する場合は、EXTRA_VARS でデフォルト以外のパスを指定しない限り、デフォルト復元パスが使用されます。復元パスを指定する EXTRA_VAR を渡す以下の例を参照してください。./setup.sh -e 'restore_backup_file=/path/to/nondefault/location' -r
-e bundle_install=falseを渡すと、オンラインインストールを強制的に実行できます。$ ./setup.sh -e bundle_install=false
表3.8 追加変数
| 変数 | 説明 | デフォルト |
|---|---|---|
|
| Automation Controller のインストール時に、Ansible も最新の状態であることを確認します。 |
|
|
| Tower のインストール時に、デモ組織、プロジェクト、認証情報、ジョブテンプレートなども作成します。 |
|
|
| バンドルからインストールする場合に、バンドルされているリポジトリーを配置する場所 |
|
|
| nginx で HTTPS トラフィックを無効にします。HTTPS の負荷をロードバランサーに分散する場合に便利です。 |
|
|
| Web セキュリティーポリシーメカニズム HSTS を無効にします。 |
|
|
| nginx が HTTP をリッスンするように設定するポート |
|
|
| nginx が HTTPS をリッスンするように設定するポート |
|
|
| バックアップ時に使用する一時的な場所 |
|
|
| 復元元として使用する別のバックアップファイルを指定します。 | なし |
|
| Tower のインストールに必要な最小メモリー (テストインストールの場合に限り変更してください) |
|
|
| 表示ファイルの説明に使用できる最小リソース (テストインストールの場合に限り変更してください) | なし |
|
|
プリフライトチェックを無視します。これはテンプレートや他のシステム以外のイメージにインストールするときに便利です ( |
|
|
|
この変数を |
|
例
- コアをアップグレードするには、以下を実行します。
./setup.sh -e upgrade_ansible_with_tower=1
- nginx で処理する https を無効化するには、以下を実行します。
./setup.sh -e nginx_disable_https=true
- バックアップファイルから復元時にデフォルトではないパスを指定する場合は、以下を実行します。
./setup.sh -e 'restore_backup_file=/path/to/nondefault/location' -r
3.3.5. Red Hat Ansible Automation Platform インストーラー設定スクリプトの実行
Private Automation Hub のインストールに必要なパラメーターを使用して inventory ファイルを更新したら、setup スクリプトを実行ができます。
手順
setup.shスクリプトを実行します。$ ./setup.sh
インストールが開始します。
3.3.6. Automation Hub のインストールの確認
インストールが完了したら、inventory ファイルに挿入した管理者認証情報でログインして、自動化ハブが正常にインストールしたことを確認できます。
手順
-
inventoryファイルの自動化ハブノードに指定した IP アドレスに移動します。 -
inventoryファイルに設定した管理者認証情報を使用してログインします。
インストールに失敗し、Red Hat Ansible Automation Platform の有効なライセンスを購入済みのお客様は、Red Hat カスタマーポータル (https://access.redhat.com/) から Ansible までお問い合せください。
Automation Hub へのログインが成功すると、Red Hat Ansible Automation Platform 2.2 のインストールが完了します。
3.3.6.1. 追加の Automation Hub の設定とリソース
追加の Automation Hub 設定については、以下のリソースを参照してください。
表3.9 Automation Controller を設定するための資料
| リンク | 説明 |
|---|---|
| Automation Hub のユーザーアクセスを設定します。 | |
| Automation Hub での Red Hat 認定コレクションおよび Ansible Galaxy コレクションの管理 | Automation Hub にコンテンツを追加します。 |
| Automation Hub で社内で開発したコレクションを公開します。 |
3.3.7. Ansible Automation Platform 2.2 の次のステップ
Ansible Automation Platform を初めて使用するユーザーの場合でも、以前の Ansible コンテンツを最新版をインストールした Red Hat Ansible Automation Platform に移行する予定の既存の管理者の場合でも、次の手順を確認して、Ansible Automation Platform 2.2 の新機能を活用し始めてみてください。
3.3.7.1. Ansible Automation Platform 2.2 へのデータの移行
プラットフォーム管理者が Ansible Automation Platform 2.2 へのアップグレードを行う場合は、完了する前にデータを新しいインスタンスに移行する追加の手順が必要になる場合があります。
3.3.7.1.1. 従来の仮想環境 (venvs) から自動化実行環境への移行
Ansible Automation Platform 2.2 は、カスタム Python 仮想環境 (venvs) よりも、自動化実行環境 (Ansible 自動化の実行およびスケーリングに必要なコンポーネントをパッケージ化するコンテナー化されたイメージ) を優先するようになっています。これには、Ansible Core、Ansible Content Collections、Python の依存関係、Red Hat Enterprise Linux UBI 8、およびその他のパッケージの依存関係が含まれます。
venv を実行環境に移行する場合は、(1) awx-manage コマンドを使用して、元のインスタンスから venv のリストを一覧表示してエクスポートし、(2) ansible-builder を使用して実行環境を作成する必要があります。詳細は、自動化実行環境へのアップグレードガイド および 実行環境の作成および消費 を参照してください。
3.3.7.1.2. Ansible Builder を使用した Ansible Engine 2.9 イメージへの移行
Ansible Automation Platform 2.2 で使用するために Ansible Engine2.9 イメージを移行するには、ansible-builder ツールで、自動化実行環境で使用するためにイメージ (カスタムプラグインおよび依存関係を含む) を再構築するプロセスを自動化します。Ansible Builder を使用して実行環境を構築する方法の詳細は、実行環境の作成および消費 を参照してください。
3.3.7.1.3. Ansible Core 2.13 への移行
Ansible Core 2.13 にアップグレードする場合に、最新版の Ansible Core でサポートされるようにするには、Playbook、プラグイン、または Ansible インフラストラクチャーの他の部分を更新する必要があります。Ansible コンテンツを更新して Ansible Core 2.13 との互換性を確保する手順は、Ansible-core 2.13 移植ガイド を参照してください。
3.3.7.2. 自動化メッシュを使用した自動化スケールアップ
Red Hat Ansible Automation Platform の自動化メッシュコンポーネントは、マルチサイトのデプロイメント全体に自動化を分散するプロセスを簡素化します。IT 環境が複数に分離されている企業の場合、自動化メッシュは、ピアツーピアメッシュ通信ネットワークを使用して実行ノード全体に自動化をデプロイしてスケールアップするための一貫性があり、信頼性の高い方法を提供します。
バージョン 1.x から最新バージョンの Ansible Automation Platform にアップグレードする場合は、データをレガシーの分離ノードから自動化メッシュに必要な実行ノードに移行する必要があります。ハイブリッドノードとコントロールノードのネットワークを計画して、Ansible Automation Platform インストーラーにあるインベントリーファイルを編集して、メッシュ関連の値を各実行ノードに割り当てることで、自動化メッシュを実装できます。
分離ノードから実行ノードに移行する方法については、アップグレードおよび移行ガイド を参照してください。
自動化メッシュと、ご使用の環境に合わせて自動化メッシュを設計するさまざまな方法については、Red Hat Ansible Automation Platform 化メッシュガイド を参照してください。
