Red Hat Ansible Automation Platform のアップグレードおよび移行ガイド

1. Red Hat Ansible Automation Platform のダウンロード ページに移動します。
2. Ansible Automation Platform <latest-version> Setup の Download Now をクリックします。

3. ファイルをデプロイメントします。

   $ tar xvzf ansible-automation-platform-setup-<latest-version>.tar.gz

   Copy to Clipboard Toggle word wrap

1. Ansible Automation Platform インストーラーパッケージをインストールします。

   v.2.3 for RHEL 8 for x86_64

   $ sudo dnf install --enablerepo=ansible-automation-platform-2.3-for-rhel-8-x86_64-rpms ansible-automation-platform-installer

   Copy to Clipboard Toggle word wrap

   v.2.3 for RHEL 9 for x86-64

   $ sudo dnf install --enablerepo=ansible-automation-platform-2.3-for-rhel-9-x86_64-rpms ansible-automation-platform-installer

   Copy to Clipboard Toggle word wrap

1. Red Hat Ansible Automation Platform のダウンロード ページに移動します。
2. Ansible Automation Platform <latest-version> Setup Bundle の Download Now をクリックします。

3. ファイルをデプロイメントします。

   $ tar xvzf ansible-automation-platform-setup-bundle-<latest-version>.tar.gz

   Copy to Clipboard Toggle word wrap

手順

1. インストールプログラムディレクトリーに移動します。

   バンドルのインストーラー

   $ cd ansible-automation-platform-setup-bundle-2.3-1.2

   Copy to Clipboard Toggle word wrap

   オンラインインストーラー

   $ cd ansible-automation-platform-setup-2.3-1.2

   Copy to Clipboard Toggle word wrap

2. 編集する inventory ファイルを開きます。

3. inventory ファイルを変更して、新規ノードのプロビジョニング、ノードまたはグループのプロビジョニング解除、および自動化ハブ API トークンのインポートまたは生成を行います。

   環境に変更を加えない場合は、既存の Ansible Automation Platform 2.1 インストールから同じ inventory ファイルを使用できます。

   注記

   [automationhub] および [automationcontroller] ホストに到達可能な IP アドレスまたは完全修飾ドメイン名 (FQDN) を提供して、ユーザーが別のノードの Ansible Automation Hub からコンテンツを同期してインストールできるようにします。localhost は使用しないでください。localhost を使用している場合は、アップグレードがプリフライトチェックの一部として停止します。

手順

1. setup.sh スクリプトを実行します。

   $ ./setup.sh

   Copy to Clipboard Toggle word wrap

1. ansible-tower-setup-latest ディレクトリーに移動します。

2. 以下の例に従って、./setup.sh スクリプトを実行します。

   $ ./setup.sh -e ‘backup_dir=/ansible/mybackup’ -e ‘use_compression=True’ @credentials.yml -b 

   1

   2

   Copy to Clipboard Toggle word wrap

   1

   backup_dir は、バックアップを保存するディレクトリーを指定します。

   2

   @ credentials.yml は、パスワード変数およびその値を ansible-vault で暗号化して渡します。

手順

1. 以下のコマンドを実行します。

   $ ./setup.sh -r -e ‘restore_backup_file=/ansible/mybackup/tower-backup-latest.tar.gz’ -e ‘use_compression=True’ -e @credentials.yml -r -- --ask-vault-pass 

   1

   2

   3

   Copy to Clipboard Toggle word wrap

   1

   restore_backup_file は、Ansible Automation Platform バックアップデータベースの場所を指定します

   2

   バックアッププロセス中に圧縮が使用されているため、use_compression は True に設定されています

   3

   -r は、データベースの復元オプションを True に設定します

2. 新しい RHEL 8 Tower 3.8 インスタンスにログインして、元のインスタンスのコンテンツが復元されているかどうかを確認します。

   1. Administration → Instance groups に移動します。再作成されたインスタンスグループには、元のインスタンスの Total Jobs が含まれているはずです。
   2. サイドナビゲーションパネルを使用して、ジョブ、テンプレート、インベントリー、クレデンシャル、ユーザーなどのコンテンツが元のインスタンスからインポートされていることを確認します。

1. Red Hat Ansible Automation Platform の最新のインストーラーを Red Hat Customer Portal からダウンロードします。

2. ファイルをデプロイメントします。

   $ tar xvzf ansible-automation-platform-setup-<latest_version>.tar.gz

   Copy to Clipboard Toggle word wrap

3. Ansible Automation Platform のインストールディレクトリーに移動します。

   $ cd ansible-automation-platform-setup-<latest_version>/

   Copy to Clipboard Toggle word wrap

4. 元のインスタンスから最新のインストーラーのディレクトリーに inventory ファイルをコピーします。

   $ cp ansible-tower-setup-3.8.x.x/inventory ansible-automation-platform-setup-<latest_version>

   Copy to Clipboard Toggle word wrap

5. setup.sh スクリプトを実行します。

   $ ./setup.sh

   Copy to Clipboard Toggle word wrap

   セットアップスクリプトは一時停止し、"pre-2.x" インベントリーファイルが検出されたことを示しますが、inventory.new.ini という新しいファイルが提供され、元のインスタンスのアップグレードを続行できます。

6. テキストエディターで inventory.new.ini を開きます。

   注記

   インストーラーは、セットアップスクリプトを実行することで、tower の名前を automationcontroller に変更するなど、元のインベントリーファイルからいくつかのフィールドを変更しました。

7. 新しく生成された inventory.new.ini ファイルを変更して、関連する変数、ノード、および関連するノード間ピア接続を割り当てて、自動化メッシュを設定します。

   注記

   自動化メッシュトポロジーの設計は、環境の自動化のニーズによって異なります。このドキュメントでは、考えられるシナリオの設計をすべて提供することはしていません。以下は、自動化メッシュ設計の例です。ニーズに合わせて設計する方法は、Ansible Automation Platform オートメーションメッシュの完全なガイド を参照してください。

   ホップノードを利用する 3 つのノードで構成される標準のコントロールプレーンを含むインベントリーファイルの例:

   [automationcontroller]
   control-plane-1.example.com
   control-plane-2.example.com
   control-plane-3.example.com
   
   [automationcontroller:vars]
   node_type=control 

   1

   
   peers=execution_nodes 

   2

   
   
   
   [execution_nodes]
   execution-node-1.example.com peers=execution-node-2.example.com
   execution-node-2.example.com peers=execution-node-3.example.com
   execution-node-3.example.com peers=execution-node-4.example.com
   execution-node-4.example.com peers=execution-node-5.example.com node_type=hop
   execution-node-5.example.com peers=execution-node-6.example.com node_type=hop 

   3

   
   execution-node-6.example.com peers=execution-node-7.example.com
   execution-node-7.example.com
   
   [execution_nodes:vars]
   node_type=execution

   Copy to Clipboard Toggle word wrap

   1

   プロジェクトとインベントリーの更新やシステムジョブを実行するが、通常のジョブを実行しない、制御ノードを指定します。これらのノードでは実行機能は無効になります。

   2

   [execution_nodes] グループ内のノード間接続のピア関係を指定します。

   3

   トラフィックを他の実行ノードにルーティングするホップノードを指定します。ホップノードは自動化を実行できません。

8. 自動化ハブ API トークンをインポートまたは生成します。

   • automationhub_api_token フラグを使用して既存の API トークンをインポートします。

     automationhub_api_token=<api_token>

     Copy to Clipboard Toggle word wrap

   • generate_automationhub_token フラグを True に設定して、新しい API トークンを生成し、既存のトークンを無効にします。

     generate_automationhub_token=True

     Copy to Clipboard Toggle word wrap

9. 自動化メッシュ用に inventory.new.ini の設定が完了したら、inventory.new.ini を使用してセットアップスクリプトを実行します。

   $ ./setup.sh -i inventory.new.ini -e @credentials.yml -- --ask-vault-pass

   Copy to Clipboard Toggle word wrap
10. インストールが完了したら、すべての自動化コントローラーノードで Ansible Automation Platform ダッシュボード UI にログインして、Ansible Automation Platform が正常にインストールされたことを確認します。