Documentation

2. Upgrading to Ansible Automation Platform

Automation Hub は、automation controller のコンテンツプロバイダーとして機能します。これには、automation controller デプロイメントと Automation Hub デプロイメントの両方を実行する必要があります。Ansible Automation Platform インストーラーには、その両方が含まれます。以下のセクションでは、アップグレードプロセスの各コンポーネントを説明します。

注釈

All upgrades should be no more than two major versions behind what you are currently upgrading to. For example, in order to upgrade to automation controller 4.3, you must first be on version 4.1.x; i.e., there is no direct upgrade path from version 3.8.x or earlier. Refer to the recommended upgrade path article on the Red Hat customer portal.

In order to run automation controller 4.3, you must also have Ansible 2.12 at minimum.

To help you determine the right upgrade or migration path when moving from an old Ansible Automation Platform or Tower version to a new Ansible Automation Platform version, use the Upgrade Assistant at https://access.redhat.com/labs/aapua/. If prompted, use your Red Hat customer credentials to login.

2.1. アップグレードのプランニング

以下のセクションでは、automation controller インスタンスのアップグレードを試行する際に留意する変更事項を説明します。

  • 以前のバージョンの有効なライセンスをお持ちの場合でも、最新の自動コントローラーにアップグレードする際に、認証情報またはサブスクリプションマニフェストを再度提供する必要があります。Automation Controller User Guide の サブスクリプションのインポート を参照してください。

  • Red Hat Enterprise Linux および automation controller をアップグレードする必要がある場合は、コントローラーデータを (自動コントローラーから) バックアップして復元する必要があります。詳細は、Automation Controller Administration Guide の バックアップおよび復元 を参照してください。

  • Clustered upgrades require special attention to instance and instance groups prior to starting the upgrade. See Editing the Red Hat Ansible Automation Platform installer inventory file and クラスタリング for details.

2.2. インストーラーの取得

詳細は、Red Hat Customer Portal の Choosing and obtaining a Red Hat Ansible Automation Platform installer を参照してください。すべてのコンテンツにアクセスするには、必ず Red Hat のカスタマーログインを使用してください。

2.3. インベントリーファイルの設定

See Editing the Red Hat Ansible Automation Platform installer inventory file for information.

You can also automatically generate an inventory file based on your selections using a utility called the Inventory File Generator, which you can access at https://access.redhat.com/labs/aapifg/. If prompted, use your Red Hat customer credentials to login.

2.4. 設定用 Playbook の実行

Tower の設定 Playbook のスクリプトでは inventory ファイルが使用され、Tower インストーラーの tarball を展開したパスから ./setup.sh として呼び出されます。

root@localhost:~$ ./setup.sh

設定スクリプトでは以下の引数を指定できます。

  • -h: ヘルプメッセージを表示して終了します。

  • -i INVENTORY_FILE: Ansible インベントリーファイルへのパス (デフォルト値: inventory)

  • -e EXTRA_VARS: 追加の Ansible 変数を key=value または YAML/JSON (つまり -e bundle_install=false は強制的にオンラインインストールを実行します) として設定します。

  • -b: インストールの代わりにデータベースのバックアップを実行します。

  • -r: インストールの代わりにデータベースの復元を実行します (以下のコード例に記載されているように、EXTRA_VARS でデフォルト以外のパスを指定しない限り、デフォルトの復元パスが使用されます)。

./setup.sh -e 'restore_backup_file=/path/to/nondefault/location' -r