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

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

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

• Automation Suite がデプロイされている Kubernetes インフラストラクチャ (OpenShift)
• 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を設定する 」をご覧ください。

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

1. 「相互運用性マトリクス」を確認して、利用可能な各アップグレード シナリオでサポートされているバージョンを確認します。 独自のコンポーネントを持ち込んだ場合は、コンポーネントのバージョンがアップグレード先のバージョンと互換性があることを確認してください。 詳しくは、「 相互運用性マトリクス」をご覧ください。
2. アップグレード先のバージョンの versions.json と uipathctl を管理マシンでダウンロードします。ダウンロードの手順については、「インストール パッケージをダウンロードする」をご覧ください。
3. 次のように、最新の input.json ファイルを生成します。
   • オプション A: input.json ファイルの最新のリビジョンを取得するには、次のコマンドを実行します。

     uipathctl manifest get-revision --namespace <uipath>

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

     uipathctl manifest list-revisions --namespace <uipath>

4. 外部の OCI 準拠レジストリでオフライン設定を使用している場合は、アップグレード前にコンテナー イメージと Helm チャートを使用してレジストリをハイドレートする必要があります。詳しくは、「 オフライン バンドルでレジストリをハイドレートする」をご覧ください。
5. Process Mining がインストールされており、PostgreSQL を必要とする最新バージョンの Airflow を使用する場合は、アップグレード前に PostgreSQL に適用可能な sqlalchemy 接続文字列テンプレートを cluster_config.json ファイルで追加または更新する必要があります ( postgresql_connection_string_template_sqlalchemy_pyodbc)。

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

実行

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

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

   uipathctl health check --namespace <uipath>

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

   uipathctl cluster maintenance enable --namespace <uipath>

   重要:

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

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

   uipathctl cluster maintenance is-enabled --namespace <uipath>

4. クラスターと SQL データベースをバックアップし、バックアップが正常に完了したことを確認します。
   重要:

   Automation Suite をアップグレードする前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。これは、Kubernetes インフラストラクチャをアップグレードする前にも適用できます。

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

   • Active Directory との連携を、ユーザー名とパスワードを使用して構成している
   • Windows 認証を有効化している
   • SQL 統合認証を使用していない
5. UiPath® のサービスとコンポーネントのアップグレードを実行します。

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

   重要:

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

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

   uipathctl health check --namespace <uipath>

   Note: If you upgraded to Automation Suite 2.2510 or higher, you can uninstall Dapr and Cert Manager, if you previously installed these add-ons for Process Mining or Task Mining. For details, refer to the and sections.

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

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

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

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

次の表では、アップグレード後の操作を実行するために実行する必要があるシナリオについて説明します。

条件	操作
1.Automation Suite 2.2510.0 以降にアップグレードしている。	各組織とホストの既存のライセンスをただちに再アクティベーションする必要があります。 オンラインでのアクティベーション: アップグレード後すぐに再アクティベーションします。 オフライン アクティベーション: Automation Suite インスタンスから新しいアクティベーション ペイロード ファイルを生成し、[ アクティベーション] にアップロードします。 古いアクティベーション ファイルを再利用することはできず、ライセンスが無効になります。