第2章 Red Hat Ansible Automation Platform 2.6 へのアップグレード


Red Hat Ansible Automation Platform をアップグレードするには、アップグレードの 計画 を確認してアップグレードが成功することを確認してください。次に、必要なバージョンの Ansible Automation Platform インストーラーをダウンロードし、環境を反映するようにインストールバンドル内のインベントリーファイルを設定してから、インストーラーを実行できます。

重要

Ansible Automation Platform 2.6 では、Automation Controller の API が後方互換性を維持しながら、新規インストールで組織、チーム、およびユーザーを管理するためにプラットフォームゲートウェイ API を使用する必要があります。レガシー API を使用すると、Event-Driven Ansible Controller を含むすべてのコンポーネントに変更が同期されるまでの最大 15 分の遅延が発生します。

2.1. アップグレードの前提条件

アップグレードプロセスを開始する前に、以下の考慮事項を確認して、Ansible Automation Platform デプロイメントを計画し、準備してください。

2.1.1. Ansible Automation Platform の要件

  • 以前のバージョンの Ansible Automation Platform からアップグレードする前に、有効なサブスクリプションがあることを確認してください。既存のサブスクリプションは、アップグレードプロセス中に引き継がれます。
  • アップグレードの計画 を 確認し、アップグレードの要件およびシナリオ、および RPM トポロジーおよびインフラストラクチャーの テスト済みデプロイメントモデル を確認します。
  • 2.6 にアップグレードする前に、Ansible Automation Platform 2.4 または 2.5 を使用していることを確認してください。Ansible Automation Platform 2.4 または 2.5 から 2.6 のみアップグレードできます。
  • Red Hat Ansible Automation Platform 2.6 にアップグレードする前に、Ansible Automation Platform 2.4 または 2.5 の最新バージョンにアップグレードします。

    重要
    • Ansible Automation Platform 2.4 から 2.6 にアップグレードする場合、Automation Controller、Automation Hub、およびイベント駆動型 Ansible Controller の API エンドポイントはすべて使用できます。これらの API は非推奨になり、今後のリリースで無効になる予定です。現在の猶予期間は、プラットフォームゲートウェイとともに導入された新しい API への移行を可能にするためのものです。
    • Ansible Automation Platform 2.4 から 2.5 にアップグレードした場合は、レガシーオーセンティケーター機能が削除されるため、2.6 にアップグレードする前に認証方法およびユーザーを移行する必要があります。ユーザーの移行に関する詳細は、RPM Upgrade and Migration guide for 2.5 の Migrating Single Sign-On (SSO) users を参照してください。
  • 問題が発生した場合にアップグレードする前に、Ansible Automation Platform 環境をバックアップします。環境の特定のトポロジーの Operator 環境用の Ansible Automation Platform インスタンスおよびバックアップと復元 のバックアップ を参照してください。
  • アップグレードする前に、インベントリーまたはインスタンスグループの詳細を取得します。
  • プラットフォームゲートウェイの要件を確認します。

    • Ansible Automation Platform 2.4 から 2.6 へのアップグレードには、プラットフォームゲートウェイ が含まれています。アーキテクチャーの変更については、2 .6 ネットワークポートとプロトコル を確認してください。
    • プラットフォームゲートウェイには、多数の関連付けられたインベントリーファイル変数があり、その一部は必要です。2.6 の新しい変数と変更された変数の詳細については、付録 A. インベントリーファイル変数 を参照してください。
    • Ansible Automation Platform 2.4 から 2.6 にアップグレードする場合、ロードバランサーの後で Automation Controller を使用していると、プラットフォームゲートウェイ UI でプラットフォームゲートウェイ URL への接続が失敗する可能性があります。エラーメッセージ Error connecting to Controller API が表示されます。

      この問題を解決するには、Automation Controller ホストごとに、各 Automation Controller ホストの settings.py ファイルの CSRF_TRUSTED_ORIGIN 設定に、信頼できるソースとしてプラットフォームゲートウェイ URL を追加します。次に、URL の変更を実装するように、各 Automation Controller ホストを再起動する必要があります。詳細は、Ansible Automation Platform のトラブルシューティングアップグレード を参照してください。

  • スタンドアロントポロジーとクラスター化されたトポロジーの両方で、Ansible Automation Platform が提供する 一元化された Redis インスタンスを確認します。

    • Ansible Automation Platform 2.6 は、スタンドアロン トポロジーとクラスタートポロジーの両方で一元 化され た Redis インスタンスを提供します。Redis の設定方法は、「RPM インストール」ガイドの Redis の設定 を参照してください。
    • Redis の高可用性 (HA) 互換デプロイメントには、6 台の仮想マシンが必要です。Redis は、Automation Controller、実行ノード、または PostgreSQL データベースを除く各 Ansible Automation Platform コンポーネントの仮想マシンと同じ場所に配置できます。
    • 外部 Redis は、Ansible Automation Platform の RPM ベースのデプロイメントではサポートされていません。
  • 制限:

    • Event-Driven Ansible 2.5 から 2.6 へのアップグレードはサポートされますが、イベント駆動型 Ansible 2.4 から 2.6 へのアップグレードはサポートされていません。Event-Driven Ansible 2.4 と Event-Driven Ansible 2.6 間のデータベース移行には互換性がありません。Ansible Automation Platform 2.4 から 2.6 にアップグレードし、イベント駆動型 Ansible をデプロイした場合は、最初にイベント駆動型 Ansible 2.4 データベースを削除してから、プラットフォームを 2.6 にアップグレードする必要があります。この手順の詳細は、Event-Driven Ansible 2.4 データベースの削除 を参照してください。

2.1.2. システム要件

Expand
説明注記

Subscription

有効な Red Hat Ansible Automation Platform サブスクリプション

 

オペレーティングシステム

Red Hat Enterprise Linux 9.4 以降のマイナーバージョンの Red Hat Enterprise Linux 9

Red Hat Ansible Automation Platform は OpenShift でもサポートされています。詳細は、OpenShift Container Platform へのインストール を参照してください。

CPU アーキテクチャー

x86_64、AArch64、s390x (IBM Z)、ppc64le (IBM Power)

 

Ansible-core

Ansible-core バージョン 2.16 以降

Ansible Automation Platform は、プラットフォームのインストールには、システム全体の ansible-core パッケージを使用しますが、コントロールプレーンと組み込み実行環境には、ansible-core 2.16 を使用します。

ブラウザー

現在サポートされている Mozilla Firefox または Google Chrome のバージョン。

 

データベース

  • Ansible Automation Platform 管理対象データベースの場合:PostgreSQL 15。
  • お客様が用意する (外部) データベース: PostgreSQL 15、16、または 17
  • 外部 (お客様がサポートする) データベースは ICU をサポートしている必要があります。
  • PostgreSQL 16 または 17 を使用する外部データベースは、外部のバックアップおよび復元プロセスに依存する必要があります。バックアップおよび復元機能は、PostgreSQL 15 で提供されるユーティリティーに依存します。

2.1.3. データベース要件

  • Ansible Automation Platform は、次の 2 種類のデータベースに対応しています。

    • Ansible Automation Platform でインストールされたデータベース - このデータベースは、Red Hat が提供する PostgreSQL パッケージを使用して Ansible Automation Platform インストール中に行われた PostgreSQL インストールで構成されます。
    • お客様が用意または設定したデータベース - これは、ベアメタル、仮想マシン、コンテナー、またはクラウドホストサービス上の、お客様が用意する外部データベースです。Ansible Automation Platform では、お客様が用意する (外部) データベースが ICU をサポートしている必要があります。
  • PostgreSQL ユーザーパスワードは、データベースに保存する前に SCRAM-SHA-256 のセキュアハッシュアルゴリズムでハッシュ化されます。
  • 問題が発生した場合にアップグレードを行う前に、Ansible Automation Platform 環境をバックアップしてください。環境の特定のトポロジーは、バックアップおよび復元 および Operator 環境のバックアップとリカバリー を参照してください。

2.1.4. ユーザーの権限

  • Red Hat Enterprise Linux ホストに専用の非 root ユーザーが設定されている。

    • このユーザーには、インストール中に管理タスクを実行するため、sudo またはその他の Ansible がサポートする特権昇格(sudo)が必要です。
    • このユーザーは、RPM Ansible Automation Platform のインストールを行います。
    • root アクセスは、sudo コマンドまたは権限昇格により取得できます。権限を、root から、AWX、PostgreSQL、Event-Driven Ansible、Pulp などのユーザーに制限できます。
    • NTP クライアントは各ノードに設定されます。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat