Automation Suite クラスター間を移行する

クラスターの移行について

カスタム名前空間の代わりに uipath 名前空間を使用しており、Automation Suite のフレーバーを移行する場合は、Automation Suite クラスター間で移行できます。 以下のシナリオがサポートされています。

• Linux の Automation Suite から EKS/AKS の Automation Suite の新しいインストールに移行します。

• EKS/AKS の Automation Suite から OpenShift の Automation Suite の新しいインストールに移行します。

• OpenShift の Automation Suite から EKS/AKS の Automation Suite の新しいインストールに移行します。

• EKS の Automation Suite から AKS の Automation Suite へ、または AKS の Automation Suite から EKS の Automation Suite に移行します。

移行操作を複数回試行しても、既存のクラスターには影響が及ばないことに注意してください。

次の移行シナリオはサポートされていません。

• Linux の Automation Suite から、EKS/AKS の Automation または OpenShift の Automation Suite の既存のインストールに移行する

• OpenShift の Automation Suite クラスターから Linux の Automation Suite のクラスターに移行する。

プロセスの概要

手順	説明
1.	必須です。 移行要件を満たしていることを確認します。 要件 データ移行と責任
2.	必須。 ソース クラスターとターゲット クラスターの両方のターゲット クラスターと Docker イメージを準備します。 ターゲット クラスターを準備する 任意です。デプロイメントがオフラインの場合、またはプライベート OCI レジストリを使用している場合は、必要なイメージが利用可能であることを確認してください。 オフライン設定で OCI 準拠レジストリをハイドレートする オンライン設定で OCI 準拠レジストリをハイドレートする
3.	必須。 移行を開始し、データを移動して、Automation Suite のインストールを実行します。 クラスターの移行を実行する
4.	任意です。 ソース クラスターとターゲット クラスターの両方で AI Center が有効化されている場合は、スキルを移行します。 AI Center のスキルを移行する

移行手順の詳細については、「 EKS/AKS の Automation Suite のインストール ガイド」をご覧ください。

要件

Automation Suite クラスターをあるクラスターから別のクラスターに移行するには、次の要件を満たす必要があります。

• 以下の成果物をダウンロードします。

  • uipathctl

  • versions.json

• 2 つの環境の間に接続を確立する必要があります。

• ソース クラスターに外部 ObjectStore が構成されている必要があります。クラスター内のストレージを使用する場合は、「クラスター内の ObjectStore から外部 ObjectStore に移行する」をご覧ください。

• Linux の Automation Suite から移行する場合、ソース クラスターのバージョンは 2022.10 以降である必要があります。

• OpenShift の Automation Suite に移行する場合、ソース クラスターのバージョンは 2023.10 以降である必要があります。

• オフラインのみの要件: ターゲット クラスターをハイドレートする必要があります。

データ移行と責任

データ	移行メカニズム
	ステータス	責任
SQL	保持 次の 2 つのオプションがあります。 新規インストールに同じデータベースを再利用します。 クラスター構成の SQL 接続文字列が既存のデータベース サーバーを指すようにします。 データベースを複製し、代わりに複製を使用します。	顧客 (Customer)
Docker レジストリ	移行されない プライベート レジストリを使用する場合は、ターゲット レジストリをハイドレートする必要があります。ターゲット クラスターに registry.uipath.com を使用する場合は、これ以上の手順は不要です。	顧客 (Customer)
fqdn	Required 新しいクラスターには新しい FQDN を選択する必要があります。オプションとして、必要に応じて以前の FQDN に戻すことができます。	顧客 (Customer)
証明書	移行されない 新しいクラスターのインストールの一部として証明書を提供する必要があります。	顧客 (Customer)
クラスターの構成	移行されない ターゲット クラスターの種類 (AKS または EKS) に適用できる新しい input.json を生成する必要があります。	顧客 (Customer)
ユーザーが作成したカスタム アラートとダッシュボード	移行されない 移行後に、Alertmanager ダッシュボードと Grafana ダッシュボードでカスタム アラートを再設定する必要があります。	顧客 (Customer)
アプリケーション ログ/ユーザーが作成した Prometheus ストリーミング設定	移行されない アプリケーション ログと Prometheus ストリーミングを再構成する必要があります。	顧客 (Customer)
動的なワークロード	アプリケーションによって異なる AI Center のトレーニング ジョブは失われ、スキルは保持されます。	スキル (アップグレード後にスクリプトを実行する必要があります): UiPath® トレーニング ジョブ: 顧客
Object Store	外部 ObjectStore: 保持 外部 ObjectStore には、次の 2 つのオプションがあります。 既存の外部 ObjectStore を再利用し、新しい環境に接続します。 現在の ObjectStore のレプリカを作成し、これを新しい設定に使用します。 重要: クラスター内 ObjectStore を使用している場合は、アップグレード前に Ceph から外部への移行を実行する必要があります。	クラスター内 ObjectStore から外部 ObjectStore に移行する: 顧客 外部 ObjectStore: UiPath®
Insights	保持	UiPath®
MongoDB データ	保持 MongoDB データがターゲット SQL に移動されます。	UiPath®
RabbitMQ	不要	UiPath®
監視 (データ)	不要 監視データは、新しいクラスターには適用されません。 Important: If you do not use the built-in monitoring components, you must set up external monitoring components after the migration upgrade.	N/A

クラスターの移行を準備する

ターゲット クラスターを準備する

大事な：「クラスターの移行を実行する」セクションの手順 1 を完了するまで、uipathctl manifest applyを実行しないでください。このコマンドの実行が早すぎると、ターゲット クラスターで構成に不整合が生じる可能性があります。

注:

移行プロセスの開始後にソース クラスターを変更しないでください。

ターゲット クラスターを準備するには、次の手順に従います。

1. ソース クラスターに対象のバージョンの input.json をダウンロードし、次のコマンドを実行して input.json ファイルを生成します。

   uipathctl manifest get-revision --namespace <uipath>

   詳しくは、以下の図を参照してください。

   
2. 以前に生成された input.json ファイルに基づいて、ターゲット クラスターの input.json ファイルを変更します。

   Orchestrator 固有の設定を転送する必要があります。

   さらに、次のコンポーネントを更新して、ターゲット クラスター内の正しいインフラストラクチャを参照するようにする必要があります。

   • 外部 ObjectStore
   • SQL Server または PostgreSQL 接続の詳細
   • Redis クラスターの構成

   注:

   Dedicated Microsoft SQL Server and PostgreSQL for Process Mining Airflow database is the required for Process Mining on Automation Suite 2.2510 or higher.

   v2024.10.3 より前のバージョンから移行する場合、ターゲット クラスター用に生成された input.json ファイルには、Airflow PostgreSQL データベースの接続文字列が含まれません。最新バージョンの Airflow を使用するには PostgreSQL が必要ですが、移行前に PostgreSQL 用の sqlalchemy 接続文字列テンプレートをターゲット クラスターの input.json ファイルに手動で追加する必要があります。

   Postgresql_connection_string_template_sqlalchemy_pyodbc

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/DB_NAME_PLACEHOLDER

3. 次のコマンドを実行して、ターゲット クラスターの前提条件を検証します。

   uipathctl prereq run input-target.json --kubeconfig kubeconfig.target --versions versions.json

   注: input-target.json は、ターゲット クラスターに対応する input.json ファイルです。

   kubeconfig ファイルを生成するには、「kubeconfig ファイルを生成する」をご覧ください。
4. Linux の Automation Suite から EKS/AKS のデプロイに移行する場合は、ソース クラスターをメンテナンス モードにする必要があります。詳しくは、「 クラスターをメンテナンス モードにする」をご覧ください。
5. ソース デプロイからターゲット デプロイに SQL データベースを複製します。

インターネットにアクセスせずに OCI 準拠のレジストリをハイドレートする

移行プロセスでは、ソース クラスターとターゲット クラスターの両方で最新の uipathcore Docker イメージ タグが利用可能でなければなりません。ソース クラスターがオフラインの場合は、以下の手順を実行してイメージを利用可能にします。

1. 「オプション B: オフライン バンドルでレジストリをハイドレートする」に記載されている手順に従って、ターゲット クラスターで使用されるレジストリをオフライン バンドルでハイドレートします。
2. ソース クラスターにアクセス可能な VM に uipathctl バイナリと versions.json ファイルをコピーします。
3. 次のコマンドを実行します。

   jq -r '.[][] | select(.name=="uipath/uipathcore") | .ref + ":" + .version' "/path/to/versions.json" > images.txt

4. ターゲット クラスターのレジストリからソース クラスターのレジストリに uipathcore イメージをシードします。

   ./uipathctl registry seed --tag-file ./images.txt \
               --source-registry "target.registry.fqdn.com" \
               --source-password "target-registry-username" \
               --source-username "target-registry-password" \
               --dest-registry "source.registry.fqdn.com" \
               --dest-username "source-registry-username" \
               --dest-password "source-registry-password"

   手記： コマンドを次のように更新してください。

   • 、target.registry.fqdn.com、および target-registry-password target.registry.fqdn.comは、ターゲット クラスターに関連付けられているレジストリに対応する適切な値に置き換えます。
   • 、source.registry.fqdn.com、および source-registry-password source.registry.fqdn.comを、ソース クラスターに関連付けられているレジストリに対応する適切な値に置き換えます。

インターネット アクセスを使用して OCI 準拠レジストリをハイドレートする

プライベート レジストリを使用する場合は、そのレジストリをシードする必要があります。手順については、「OCI 準拠のレジストリを設定」を参照してください。

クラスターの移行を実行する

ターゲットの Automation Suite クラスターに移行するには、次の手順に従います。

1. 次のコマンドを実行して、移行を実行します。

   uipathctl cluster migration run input-target.json --kubeconfig kubeconfig.source --target-kubeconfig kubeconfig.target --versions versions-target.json

2. 次のコマンドを実行して、ターゲット クラスターへの Automation Suite のインストールを完了します。

   uipathctl manifest apply input-target.json --kubeconfig kubeconfig.target --versions versions-target.json

AI Center のスキルを移行する

このセクションの手順は、ソース クラスターとターゲット クラスターの両方で AI Center を有効にした場合にのみ適用されます。 この手順では、ターゲット クラスター上の AI Center が、スキルを実行するためのスキル データを含むデータベースを指していることを前提としています。

移行が完了したら、AI Center のスキルを同期して、再び使用できるようにする必要があります。

スキルの移行ステータスを確認する

次のスクリプトを使用して、AI Center の ML スキルをターゲット クラスターに同期できます。このスクリプトは、アクティブな同期が進行中でない場合、バックグラウンドで同期をトリガーします。

このスクリプトは、スキルをバックグラウンド (非同期) で同期して戻ります。このジョブでは、スキルがデプロイされていることが確認され、現在のステータスを反映して DB エントリが更新されます。

uipathctl service aicenter sync-skills [skill_ids]

パラメーター	説明
[skill_ids]	スペースで区切られたスキル ID の任意の配列。スキルIDを指定した場合は、それらのスキルのみが更新されます。変換しないと、デプロイされたすべてのスキルが再同期されます。

uipathctl service aicenter sync-skills 783273-3232-3232-323 32-32-323-3232

//this will only sync the skills with ID 783273-3232-3232-323 and 32-32-323-3232

AI Center の ML スキルのステータスを表示するには、次のコマンドを実行します。

uipathctl service aicenter sync-skill-status [skill_ids]

次のいずれかのステータスが返されます。

• InProgess - スキルのデプロイが進行中です。
• Failed - スキルのデプロイに失敗しました。
• OutOfSync - スキルはデータベース内で利用可能ですが、まだデプロイされていません。
• Available - スキルがデプロイされ、利用可能です。