アップグレードを実行する

重要:

Automation Suite のアップグレードを実行するには、クラスターをメンテナンス モードにする必要があります。メンテナンス モードでは、アップグレード プロセス全体でダウンタイムが発生します。その間、ビジネス オートメーションは中断されます。

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

アップグレードを実行するには、次の手順を実行する必要があります。

1. 前提条件の確認を実行します。
2. バックアップを構成します。
3. バックアップを無効化します。
4. クラスターをメンテナンス モードにします。
5. Longhorn ワークロード、MongoDB データ、Ceph を Helm ベースのデプロイに移行します。
6. Kubernetes およびその他のインフラストラクチャ コンポーネントを更新します。
7. 共有コンポーネントと UiPath® サービスをアップグレードします。

前提条件の確認を実行する

クラスターをメンテナンス モードにする前に、アップグレードの要件がすべて満たされていることを確認する必要があります。

1. 次のコマンドを使用して、インフラストラクチャの前提条件の確認を実行します。

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json

2. 次のコマンドを使用して、共有コンポーネントとサービスの前提条件の確認を実行します。

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json 

バックアップを構成する

バックアップを構成するには、次の手順に従います。

1. クラスターでバックアップが有効であることを確認します。現在のデプロイで使用したバージョンと同じバージョンのインストーラーを使用してバックアップを作成する必要があります。手順については、Automation Suite のアップグレード元のバージョンに対応するバックアップと復元のドキュメントをご覧ください。たとえば、Automation Suite 2023.4 からのアップグレードを計画している場合は v2023.4 のガイドに記載されている手順に従います。
2. SSH を介していずれかのサーバー ノードに接続します。
3. 必要なすべてのボリュームがクラスターにバックアップされていることを確認します。

   • 2022.4 以前からアップグレードする場合は、次のコマンドを実行します。

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   • 2022.10 以降からアップグレードする場合は、次のコマンドを実行します。

     ./configureUiPathAS.sh snapshot list

   • 2024.10 以降からアップグレードする場合は、次のコマンドを実行します。

     ./bin/uipathctl snapshot list

   注: バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。

バックアップが作成されたら、続いて次の手順を実行します。

注:

23.10.0 以降のバージョンからアップグレードする場合は、必ずターゲット バージョン ディレクトリから uipathctl コマンドを使用してください。

バックアップを無効化する

クラスターをメンテナンス モードにする前に、バックアップを無効化して、クラスターが最適でない状態でバックアップされないようにする必要があります。詳しくは、「 スナップショットのバックアップを無効化する」をご覧ください。

大事な： バックアップを有効化し、2024.10.1 または 2024.10.2 にアップグレードする場合は、「 Velero の移行の問題によりアップグレードが失敗する 」に記載されている手順に従ってください。

クラスターをメンテナンス モードにする

クラスターをメンテナンス モードにすると、イングレス コントローラーとすべての UiPath® サービスがシャットダウンし、Automation Suite クラスターへのすべての受信トラフィックがブロックされます。

1. クラスターをメンテナンス モードにするには、以下を実行します。

   ./bin/uipathctl cluster maintenance enable

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

   ./bin/uipathctl cluster maintenance is-enabled

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

重要:

Automation Suite を 2024.10.0 から Automation Suite 2024.10.1 にアップグレードする場合、アップグレード前のコマンドを実行する前に、追加の手順を実行する必要があります。 詳しくは、「 トラブルシューティング」 セクションをご覧ください。

次の必須のアップグレード前コマンドを実行します。

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

このコマンドは、Longhorn のワークロードをローカルの PV に、MongoDB のデータを SQL に選択的に移行し、Ceph のデプロイを ArgoCD から Helm ベースのデプロイに移行します。

Kubernetes およびその他のインフラストラクチャ コンポーネントを更新する

Kubernetes およびその他のインフラストラクチャ コンポーネントをアップグレードするには、プライマリ サーバー ノードで次のコマンドを実行します。

重要:

生成された cluster_config.json ファイルを、「クラスター構成を更新する」の説明に従って更新したことを確認してください。

cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json

注:

• 前のコマンドをプライマリ サーバー ノードで実行すると、インストーラーと cluster_config.json が /opt/UiPathAutomationSuite/<version>/installer の既定の場所にコピーされ、すべてのマシンのインフラストラクチャがアップグレードされます。
• /opt/UiPathAutomationSuite/<version>の既定の場所には、すべてのノードで 5 GB 以上の空き容量が必要です。

• 既定の場所を変更するには、次の環境変数を目的の場所で更新します。その場所がすべてのノードで利用可能であり、アップグレードを実行するために必要なアクセス許可があることを確認します。

  export INSTALLER_DIRECTORY=/path/to/copy/installer

• 前のコマンドを実行してアップグレードを実行すると、インストーラーが /path/to/copy/installer/<version>/installer の場所にコピーされます。version は、実行するインストーラーのバージョンに置き換えられます。

トラブルシューティング

• インストーラーにカスタムの場所を明示的に使用していない限り、プライマリ サーバーのアップグレード ログは /opt/UiPathAutomationSuite/latest/installer/upgrade-logs の既定の場所にあります。
• 他のすべてのノードでは、INSTALLER_DIRECTORY 変数を使用して場所を明示的に変更しない限り、ログは /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs の既定の場所にあります。

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

1. Insights を有効化している場合は、次のコマンドを実行して、アップグレード後も Insights のデータが保持されるようにする必要があります。

   kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -

   注:

   Insights が有効でない場合、このコマンドを実行しても悪影響はありません。

2. 共有コンポーネントと UiPath® 製品サービスをアップグレードするには、プライマリ サーバー ノードで次のコマンドを実行します。

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json

   重要:

   アップグレードが完了すると、メンテナンス モードは自動的に無効化されます。

3. Automation Suite が正常かどうかを確認するには、次のいずれかのコマンドを実行します。

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl health check

   注:

   helm-charts.jsonが見つからない場合は、代わりに versions.jsonを使用できます。をダウンロードするには、「インストール パッケージをダウンロードするversions.json」をご覧ください。

アップグレードの完了後、該当するクリーンアップと移行のアクティビティを実行します。