Documentation

7. 既存 Tower インストールのアップグレード

既存の Tower インストールは最新バージョンに簡単にアップグレードできます。Tower は既存の設定ファイルを検索し、インストールではなくアップグレードが必要なタイミングを認識します。

インストールの場合と同様、アップグレードプロセスでは Tower サーバーがインターネットにアクセスできる必要があります。アップグレードのプロセスには、Tower のインストールとほぼ同様の時間がかかり、さらにデータ移行にも時間がかかります。

このアップグレード手順では、Ansible および Tower の作業用インストールがあることを前提としています。

注釈

Tower の組み込みデータベースを、アップグレードの一環として Active/Passive 冗長性モードのインストールに変換することはできません。Tower を冗長性設定でデプロイする必要のあるユーザーは、Tower データベースをバックアップし、新規の冗長性設定を異なる VM または物理ホストにインストールしてからデータベースを復元する必要があります。プライマリーまたはセカンダリーインスタンスは、すでに外部データベースで機能している場合は後で追加することができます。Ansible Tower Administration Guide の「Active/Passive Redundancy 」の章を参照してください。

7.1. 要件

Tower インストールをアップグレードする前に、「要件」を参照して十分なディスク領域および RAM があることを確認し、ソフトウェアの要件を確認してください。たとえば、アップグレードを実行する前に Ansible の最新安定版をインストールしておく必要があります。

注釈

3 つ以上先のメジャーバージョンに対して、アップグレードはできません。たとえば、Ansible Tower 3.5.x にアップグレードするには、3.2.x から直接アップグレードできないので、先に 3.3.x にアップグレードしてください。カスタマーポータルから『 recommended upgrade path article 』を参照してください。

また、RHEL 8 で Ansible Tower 3.5 を実行するには、Ansible 2.8 以降にインストールする必要があります。

7.2. Tower インストールのバックアップ

システムをアップグレードする前にバックアップを作成することをお勧めします。バックアッププロセスが完了したら、OS/Ansible/Tower アップグレードに進みます。

Ansible Tower Administration Guide 』の「Backing Up and Restoring Tower 」を参照してください。

注釈

Tower 3.0.0 および 3.0.1 で正常なシステムのバックアップおよび復元を阻止していた問題が発見されている点に注意してください。

Tower v3.0.0 または v3.0.1 インストールをバックアップまたは復元する必要がある場合は v3.0.2 のインストーラーを使用してください。

7.3. Tower インストーラーの取得

スタンドアロンの Tower をインストールするか、バンドルのインストーラーを使用できます。

  • 直接インターネットアクセスが可能な環境で Tower を設定する場合は、スタンドアロンの Tower インストーラーをダウンロードできます。

  • オンラインリポジトリーへ直接アクセスできない環境で、Tower を設定する場合や、お使いの環境でプロキシーが有効になっている場合には、バンドルのインストーラーを使用する必要があります。

Ansible Tower インストール/アップグレードツールをダウンロードして展開してください (http://releases.ansible.com/ansible-tower/setup/)。

root@localhost:~$ tar xvzf ansible-tower-setup-latest.tar.gz
root@localhost:~$ cd ansible-tower-setup-<tower_version>

インストールまたはアップグレードするには、ansible-tower-setup-<tower_version> ディレクトリーのインベントリーファイルを編集します。<tower_version>2.4.53.0.0. ディレクトリーなどのバージョン番号に置き換えてください。

注釈

アップグレードプロセスの一環として、データベーススキーマの移行を実行できます。Tower インストールのサイズによっては時間がかかる場合があります。

Tower のアップグレードが失敗するか、またはヘルプが必要な場合には、Red Hat カスタマーポータル (https://access.redhat.com/) から Ansible までお問い合わせください。

7.4. 設定用の Playbook

注釈

Ansible Tower 3.0 はインストールが簡素化され、インストール設定の一部として ./configure/ を実行する必要性がなくなりました。以前のバージョンを使用している方は、http://docs.ansible.com/ に v.2.4.5 リリース (以前) の Tower ドキュメントに記載の説明に従うようにしてください。

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

注釈

Tower 3.0.0 および 3.0.1 で正常なシステムのバックアップおよび復元を阻止していた問題が発見されている点に注意してください。

Tower v3.0.0 または v3.0.1 インストールをバックアップまたは復元する必要がある場合は v3.0.2 のインストーラーを使用してください。