Automation Suite をアップグレードする

EKS/AKS の Automation Suite のメジャー バージョンおよびマイナー バージョンのアップグレードを実行します。

Automation Suite は複数のコンポーネントで構成されています。お客様と UiPath® は、これらのコンポーネントに対する責任を共有します。詳しくは、「 責任マトリクス」をご覧ください。

アップグレードはユーザーの責任です。

• Automation Suite をデプロイする Kubernetes インフラストラクチャ (AKS または EKS)
• Automation Suite の一部として利用することを選択したコンポーネント (例: Gatekeeper、FluentD)

UiPath® は以下のアップグレードを担当します。

• UiPath® サービス (例: Orchestrator)
• Automation Suite の一部としてデプロイするコンポーネント (例: ArgoCD)

UiPath® のサービスとコンポーネントをアップグレードする

準備

注:

• Automation Suite 2.2510 にアップグレードする場合は、 AutomationSuite_Airflow 用の PostgreSQL データベースを取得し、その接続文字列を input.jsonで設定する必要があります。詳しくは、「 Process Mining 固有の設定」をご覧ください。
• Studio Web を使用して 2.2510.0 より前のバージョンからアップグレードする場合は、RWX アクセス モードをサポートするために、 storage_class_single_replicaで指定されているストレージ クラス名と同じストレージ クラス名を使用してください。詳しくは、「 input.jsonを設定する」をご覧ください。

さらに、アップグレードを開始する前に、次のデータベースのメンテナンス ガイダンスを確認してください。

重要:

Automation Suite のデータベース テーブルが非常に大きいと、データベース移行ジョブに長時間を要したり、アップグレード中に完了に失敗したりする可能性があります。データベース テーブルを適切に維持しておくことで、このリスクが軽減されます。

アップグレードを開始する前に、大容量のテーブルから不要になったデータをアーカイブまたは削除することをお勧めします。詳細については、「 データベースのメンテナンスを実行する」を参照してください。

アップグレードの準備をするには、次の手順に従います。

1. 「相互運用性マトリクス」を確認して、利用可能な各アップグレード シナリオでサポートされているバージョンを確認します。独自のコンポーネントを持ち込んだ場合は、コンポーネントのバージョンがアップグレード先のバージョンと互換性があることを確認してください。詳しくは、「 相互運用性マトリクス」をご覧ください。

2. アップグレード先のバージョンの versions.json と uipathctl を管理マシンでダウンロードします。ダウンロードの手順については、「 インストール パッケージをダウンロードする」をご覧ください。

3. 次のように、最新の input.json ファイルを生成します。

   • オプション A:input.json ファイルの最新バージョンを取得するには、次のコマンドを実行します。

     uipathctl manifest get-revision
     

   • オプション B: 過去のすべての input.json ファイルをリストアップし、選択するファイルを決定するには、次のコマンドを実行します。

     uipathctl manifest list-revisions
     

4. 外部の OCI 準拠レジストリでオフライン設定を使用している場合は、アップグレードの前に、コンテナー イメージと Helm グラフを使用してレジストリをハイドレートする必要があります。詳しくは、「 オフライン バンドルでレジストリをハイドレートする」をご覧ください。

5. Process Mining がインストールされており、PostgreSQL を必要とする最新バージョンの Airflow を使用する場合は、アップグレード前に PostgreSQL に適用可能な sqlalchemy 接続文字列テンプレートを input.json ファイルで追加または更新する必要があります ( postgresql_connection_string_template_sqlalchemy_pyodbc)。

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
   

6. Integration Service がインストールされている場合は、外部のクラウド キュー (SQS) が同期されていて、リージョン間のレプリケーションが有効化されていることを確認してください。例えば：

   • Azure Queue Storage で、GRS/RA-GRS または GZRS/RA-GZRS 冗長オプションを構成します。詳しくは、以下をご覧ください。
     • Azure Storage でのデータの冗長性
     • Azure Queue Storage の信頼性
     • geo 冗長設計ガイダンス
   • Amazon SQS では、各リージョンに SQS キューを作成し、SNS ファンアウトまたはカスタムロジックを使用してメッセージをレプリケートします。詳しくは、以下をご覧ください。
     • Amazon SQS - アクティブ/アクティブな障害復旧
     • SNS クロスリージョン メッセージ配信

7. 以前のバージョンの Automation Suite 2024.10 から Automation Suite 2.2510.0 以降にアップグレードし、Studio Web を有効化する場合は、ソリューションも有効化する必要があります。詳しくは、「 ソリューションを有効化または無効化する」をご覧ください。必ず、ソリューションの追加のハードウェア要件も確認してください。詳しくは、「 要件算出ツール」をご覧ください。

実行

UiPath® のサービスとコンポーネントのアップグレードを実行するには、次の手順を実行します。

1. クラスターが健全であることを確認します。

   uipathctl health check --namespace <uipath> --versions versions.json
   

2. クラスターをメンテナンス モードにして、一貫性のあるバックアップを保証します。

   uipathctl cluster maintenance enable
   

   重要:

   この操作によりダウンタイムが発生し、タイム メンテナンス モードが有効化されている間はお使いのビジネス オートメーションが中断されます。

3. クラスターがメンテナンス モードであることを確認するには、以下を実行します。

   uipathctl cluster maintenance is-enabled
   

4. クラスターと SQL データベースをバックアップし、バックアップが正常に完了したことを確認します。Kubernetes インフラストラクチャをアップグレードする前にもバックアップを作成してください。

   以下の要件を同時に満たす場合は、必ず global.userInputs.identity.krb5KeytabSecret の値を global.kerberosAuthConfig.userKeytabにコピーしてください。

   • Active Directory との連携を、ユーザー名とパスワードを使用して構成している
   • Windows 認証を有効化している
   • SQL 統合認証を使用していない

5. Automation Suite 2.2510.2 以降では、アップグレード中はメンテナンス モードを有効化したままにしておく必要があります。Automation Suite 2.2510.2 より前のバージョンでは、アップグレードを実行する前にメンテナンス モードを無効化してください。

   uipathctl cluster maintenance disable
   

   注:

   Automation Suite 2.2510.2 以降にアップグレードする場合は、この手順をスキップしてメンテナンス モードを無効化するのはアップグレードの完了後だけにしてください。

6. UiPath® のサービスとコンポーネントのアップグレードを実行します。

   uipathctl cluster upgrade input.json --versions versions.json
   

   Automation Suite 2.2510.0 でメンテナンス モードが無効化されている場合、 uipathctl cluster upgrade コマンドは失敗し、次のエラーが表示されます Please enable maintenance mode prior to attempting an upgrade. Use 'uipathctl cluster maintenance enable'.

   このエラー メッセージを回避するには、次のコマンドを使用してアップグレードを実行します。続行する前に、必要なバックアップがすべて作成されていることを確認してください。

   uipathctl cluster upgrade input.json --versions versions.json --skip-upgrade-readiness
   

   重要:

   この操作によりダウンタイムが発生し、ビジネス オートメーションはアップグレード プロセス中に中断されます。アップグレードはメンテナンス ウィンドウ中にのみ実行することが重要です。

7. Automation Suite 2.2510.2 以降では、メンテナンス モードを無効化する

   uipathctl cluster maintenance disable
   

8. アップグレード後にクラスターが正常であることを確認します。

   uipathctl health check --namespace <uipath> --versions versions.json
   

   注:

   Automation Suite 2.2510 以降にアップグレードした場合、Dapr および Cert Manager を Process Mining または Task Mining 用に以前にインストールしてみると、これらのアドオンをアンインストールできます。詳しくは、「 Dapr をアンインストール する」および「 Cert Manager をアンインストール する」のセクションをご覧ください。

Kubernetes インフラストラクチャをアップグレードする

注:

Automation Suite は、クラウド プロバイダーに関係なく、アップストリームの N-1 から N-3 バージョンの Kubernetes をサポートします。たとえば、アップストリームが 1.27 の場合、バージョン 1.26、1.25、および 1.24 がサポートされます。サポートされているバージョンについては、「 相互運用性マトリクス」をご覧ください。

Automation Suite をホストする Kubernetes インフラストラクチャのアップグレードはユーザーの責任です。Kubernetes インフラストラクチャをアップグレードするには、会社の標準のプラクティスに従う必要があります。

アップグレード後の操作を実行する

次のシナリオでは、お使いの環境で必要なアップグレード後の操作について説明します。

• Automation Suite 2.2510.0 以降にアップグレードし、以前のバージョンで Process Mining または Task Mining が有効化されていた場合:

  • Dapr をアンインストールします。詳しくは、「 Dapr をアンインストールする方法」をご覧ください。
  • Cert Manager をアンインストールします。詳しくは、「 Cert Manager をアンインストールする方法」をご覧ください。

• Automation Suite 2.2510.0 以降にアップグレードした場合は、各組織とホストの既存のライセンスをすぐに再アクティベーションする必要があります。

  • オンラインアクティベーション: アップグレード後すぐに再アクティブ化します。
  • オフライン アクティベーション: Automation Suite インスタンスから新しいアクティベーション ペイロード ファイルを生成し、[ アクティベーション] にアップロードします。

  古いアクティベーション ファイルを再利用することはできず、ライセンスが無効になります。ライセンスの再アクティベーションは、[ ライセンスを更新 ] ボタンを使用して実行する必要があります。ライセンスを手動でアクティベーションしてから再度アクティベーションしないでください。そうしないとサービスが無効化されます。