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® のサービスとコンポーネントをアップグレードする

準備

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

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

実行

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

クラスターが健全であることを確認します。
```
uipathctl health checkuipathctl health check
```
クラスターをメンテナンスモードにして、一貫性のあるバックアップを保証します。
```
uipathctl cluster maintenance enableuipathctl cluster maintenance enable
```
重要:
この操作によりダウンタイムが発生し、タイムメンテナンスモードが有効化されている間はお使いのビジネスオートメーションが中断されます。
クラスターがメンテナンスモードであることを確認するには、以下を実行します。
```
uipathctl cluster maintenance is-enableduipathctl cluster maintenance is-enabled
```
クラスターと SQL データベースをバックアップし、バックアップが正常に完了したことを確認します。
重要:
Automation Suite をアップグレードする前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。
以下の要件を同時に満たす場合は、必ず global.userInputs.identity.krb5KeytabSecret の値を global.kerberosAuthConfig.userKeytab にコピーしてください。
- Active Directory との連携を、ユーザー名とパスワードを使用して構成している
- Windows 認証を有効化している
- SQL 統合認証を使用していない
メンテナンスモードを無効化する
```
uipathctl cluster maintenance disableuipathctl cluster maintenance disable
```
注: アップグレード前にメンテナンスモードを無効化する必要があります。AKS/EKS の Automation Suite のアップグレードプロセスでメンテナンスモードを有効化することはできません。
UiPath® のサービスとコンポーネントのアップグレードを実行します。
```
uipathctl cluster upgrade input.json --versions versions.jsonuipathctl cluster upgrade input.json --versions versions.json
```
重要:
この操作によりダウンタイムが発生し、ビジネスオートメーションはアップグレードプロセス中に中断されます。アップグレードはメンテナンスウィンドウ中にのみ実行することが重要です。
アップグレード後にクラスターが正常であることを確認します。
```
uipathctl health checkuipathctl health check
```

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

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

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