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

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

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

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

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

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

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

準備

注:

Automation Suite 2024.10.3 以降にアップグレードし、最新バージョンの Airflow が必要な場合は、 AutomationSuite_Airflow 用の PostgreSQL データベースを利用し、その接続文字列を input.jsonで構成する必要があります。

詳しくは、「 Process Mining 固有の構成」をご覧ください。

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

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 接続文字列テンプレートを cluster_config.json ファイルで追加または更新する必要があります ( postgresql_connection_string_template_sqlalchemy_pyodbc)。

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

   注:

   これは、Automation Suite 2024.10.3 以降の Process Mining にのみ適用されます。

実行

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

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

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

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

   uipathctl cluster maintenance enable
   

   重要:

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

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

   uipathctl cluster maintenance is-enabled
   

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

   Automation Suite をアップグレードする前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。これは、Kubernetes インフラストラクチャをアップグレードする前にも適用されます。以下の要件を同時に満たす場合は、必ず global.userInputs.identity.krb5KeytabSecret の値を global.kerberosAuthConfig.userKeytabにコピーしてください。

   • Active Directory との連携を、ユーザー名とパスワードを使用して構成している
   • Windows 認証を有効化している
   • SQL 統合認証を使用していない
5. メンテナンス モードを無効化する

   uipathctl cluster maintenance disable
   

   注:

   アップグレード前にメンテナンス モードを無効化する必要があります。Automation Suite のアップグレード プロセスでメンテナンス モードを有効化することはできません。

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

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

   重要:

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

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

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

   注:

   Automation Suite 2024.10.3 以降にアップグレードした場合、Task Mining を有効化していない場合は、Dapr と Cert Manager をアンインストールできます。詳しくは、「 Dapr をアンインストール する」および「 Cert Manager をアンインストール する」のセクションをご覧ください。

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

注:

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

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