EKS/AKS の Automation Suite をアップグレードする

重要:

Active Directory (AD) を使用していて、v2023.4.0 へのアップグレードを計画している場合は、v2023.4.0、v2023.4.1、v2023.4.2 が AD の問題の影響を受けているため、スキップして v2023.4.3 にアップグレードすることを強くお勧めします。

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

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

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

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

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

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

準備

注:

AKS/EKS バージョン 2023.10.0 から 2023.10.7 の Automation Suite のバックアップ ロジックには既知の問題があります。 具体的には、この問題では Insights のダッシュボードのバックアップは対象外です。 ただし、すべての履歴データは正常にバックアップされます。

Insights のダッシュボードをバックアップに含めるには、 こちらのスクリプトを使用してバックアップ ソリューションを再構成する必要があります。 このスクリプトを使用すると、バックアップ ソリューションを再構成し、バックアップを作成できます。 コマンドの実行方法の詳細については、こちら のセクションをご覧ください。

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

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

     uipathctl manifest get-revision

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

     uipathctl manifest list-revisions

実行

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

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

   uipathctl health check

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

   uipathctl cluster maintenance enable

   重要:

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

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

   uipathctl cluster maintenance is-enabled

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

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

   以下の要件を同時に満たす場合は、必ず 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

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

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

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