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

EKS/AKS 上の Automation Suite クラスター間でデータと構成を移行します。

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

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

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

上記に記載されていない移行シナリオはサポートされません。

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

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

• Linux の Automation Suite から EKS/AKS の Automation Suite または OpenShift の Automation Suite の既存のインストールに移行する。
• OpenShift クラスター上の Automation Suite を Linux クラスターの 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 に移行する。
• EKS の Automation Suite から EKS の Automation Suite の新規インストールに移行する。
• AKS の Automation Suite から AKS の Automation Suite の新規インストールに移行する。
• OpenShift の Automation Suite から OpenShift の Automation Suite の新規インストールに移行します。

プロセスの概要

次の表に、クラスターの移行プロセスの概要を示します。

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

For detailed migration instructions, refer to the Automation Suite on EKS/AKS Installation Guide.

要件

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

• 以下の成果物をダウンロードします。
  • uipathctl
  • versions.json
• 2 つの環境の間に接続を確立する必要があります。
• You must have an external objectstore configured in your source cluster. If you use in-cluster storage, refer to Migrating in-cluster objectstore to external objectstore.
• ソース クラスターに、宛先のオブジェクト ストアに対する読み取り/書き込み権限を付与する必要があります。永続ボリューム (PV) がコピーされると、ソースクラスターはデータを宛先のオブジェクトストアに書き込み、宛先クラスターはオブジェクトストアからデータをプルして、対応する PV を作成します。
• 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®
監視 (データ)	不要 監視データは、新しいクラスターには適用されません。 組み込みの監視コンポーネントを使用しない場合は、移行のアップグレード後に外部監視コンポーネントを設定する必要があります。	N/A

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

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

重要:

Do not run uipathctl manifest apply until you have completed Step 1 in the Running the cluster migration section. Running this command too early can result in configuration inconsistencies in the target cluster.

注:

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

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

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

   uipathctl manifest get-revision
   

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

   

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

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

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

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

   Automation Suite 2.2510 の Process Mining には、Process Mining 専用の Microsoft SQL Server と PostgreSQL の Airflow データベースが必要です。

   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 ファイルです。

   To generate the kubeconfig file, refer to Generating the kubeconfig file.

4. If you are migrating from Automation Suite on Linux to a EKS/AKS deployment, you must put the source cluster in maintenance mode. For details, refer to Putting the cluster in maintenance mode.

5. ソース デプロイからターゲット デプロイに SQL データベースを複製します。

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

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

1. Follow the steps to hydrate the registry used by the target cluster with the offline bundle in Option B: Hydrating the registry with the offline bundle.

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 準拠レジストリをハイドレートする

If you use a private registry, you must seed it. For instructions, refer to Configuring the OCI-compliant registry.

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

ターゲットの 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 - スキルがデプロイされ、利用可能です。