Automation Cloud 移行ツールを使用する

Automation Cloud 移行ツールは、あるデプロイ オプションから別のデプロイ オプションへの移行プロセスを簡素化するために設計されたデスクトップ アプリケーションです。このツールを使用してさまざまな移行手順を自動化することで、スタンドアロンまたは Automation Suite の Orchestrator を Test Cloud、Test Cloud (専有型)、Test Cloud (公共部門向け)、またはオンプレミス版 Test Cloud に簡単に移行できます。

このページの説明は、On-Premises Orchestrator をスタンドアロンでまたは Automation Suite 経由でクラウド プラットフォームに移行する場合に適用されます。

注:

利用可能な機能は、使用するクラウド プラットフォームによって異なります。詳しくは、「 利用可能な機能」をご覧ください。

はじめる前に

オンプレミスの Orchestrator からクラウド プラットフォームへの移行を計画している際は、次の手順を実行することをお勧めします。

1. サポートされているオンプレミス Orchestrator のバージョンにアップグレードします。
2. クラシック フォルダーからモダン フォルダーに移行します。クラウド プラットフォームでは クラシック フォルダー の使用に制限があるため、UiPath のクラウド プラットフォームにはクラシック フォルダーが存在しないためです。
3. 移行ツールを実行して、オンプレミスの Orchestrator を目的のクラウド プラットフォームに移行します。
   注:

   • 技術的には他の順序も可能ですが、これが最も一般的なアプローチです。
   • Automation Cloud 移行ツールは単独で動作し、標準のプロダクト ライフサイクルには従いません。

要件

移行ツールを使用するには、次の条件を満たす必要があります。

• お使いのスタンドアロンの Orchestrator のバージョンがサポートされている必要があります。特定のバージョンの詳細については、プロダクト ライフサイクルのドキュメントをご覧ください。
• クラウド プラットフォーム用のアクティブなライセンスが必要です。詳しくは、 ライセンスに関する ドキュメントをご覧ください。
• フレックス ライセンスをご利用の場合は、Automation Cloud の Pro、Pro Trial、または Enterprise のライセンスが必要です。Pro Trial の使用中にこのツールを使って評価を行うことはできますが、テナントやロボットのライセンスの制限など、制限がいくつか適用される場合があります。詳しくは、 ライセンスに関する ドキュメントをご覧ください。

前提条件

Automation Cloud 移行ツールを開く前に、次の準備を行います。

1. クラウド プラットフォームに応じて、Enterprise または Enterprise 無料トライアルのライセンス プラン (管理者 > ライセンス) がアクティブであることを確認します。
2. 移行するロボットの数に見合った十分な数のロボット ライセンスがあることを確認してください ([管理] > [ライセンス] > [ロボットとサービス])。このツールは、利用可能なライセンスがある間はロボットを移行し、ライセンス数を超えるとロボットのスキップを開始します。
3. 移行元の環境の管理者資格情報を持っている必要があります。
4. 移行するすべてのエンティティの表示権限があることを確認してください。一部のエンティティの表示権限がない場合、それらのエンティティは移行されません。
5. このツールを外部アプリケーションとして登録するには、Automation Cloud の組織管理者である必要があります。
6. Automation Cloud 移行ツールを実行するマシンが次の要件を満たしていることを確認します。
   1. スタンドアロンの Orchestrator、クラウド プラットフォームの Orchestrator、Automation Suite の Orchestrator に接続できる
   2. クラウド プラットフォームにアクセスできる (インターネットにアクセス可能でサポートされている ブラウザーがインストールされている)
   3. Windows オペレーティング システムを実行している
7. 前の手順の要件を満たすマシンに移行ツールをダウンロードします。

移行ツールで移行されるエンティティ

移行ツールを使用すると、以下のエンティティが下表のとおりにクラウド プラットフォーム内に自動的に作成され、Orchestrator の設定が反映されます。

エンティティ	移行される	移行されない
設定	はい (例外あり)	オンプレミスの一部の設定 (テナントに公開されているパスワードや特定の設定など)
パッケージ	すべてのパッケージとパッケージ バージョン	認証が必要な外部パッケージ フィードに依存するエンティティ 注: 基本認証が設定されている外部パッケージ フィードでは、移行の完了後に認証が必要です。
ライブラリ	テナントレベルのフィードのみ	ホスト レベルの構成が含まれるライブラリ、またはアクセスできない外部ライブラリに依存するエンティティ
予定表	はい	N/A
マシン	はい 注: ライセンスがないためにマシン スロットの割り当てが制限される可能性があります。	マシン キー ロボット アカウントのマッピングが使用されている場合は失敗します。
フォルダー	はい 注: すべてのフォルダーを一括で移行することも、個々のフォルダーも移行できます。	個人用ワークスペースのフォルダー
環境 (ロボット グループ)	はい (クラシック フォルダーの場合)。	N/A (モダン フォルダーの場合)
ロボット (クラシック)	はい 注: ライセンスがないためにロボットの作成が制限される可能性があります。	ライセンスを使い切った場合はスキップされ、スキップされたロボットそれぞれについてエラーがログに記録されます。
ロボット (モダン)	はい 注: 特定の条件下で、メール アドレスを持つオンプレミスのユーザーにロボットが関連付けられ、その同じメール アドレスがすでに UiPath のクラウド プラットフォームに招待されていて、ユーザーに関連付けられている場合です。	ライセンスを使い切った場合はスキップされ、スキップされたロボットそれぞれについてエラーがログに記録されます。 UiPath クラウド プラットフォームにユーザーが存在しない場合は失敗します。 ロボット アカウントのマッピングが使用されている場合は失敗します。
ロボット グループの関連付け	ロボットとロボット グループのマッピング	N/A
プロセス	はい 注: 移行ツールでは、プロセスをリリースと呼ぶ場合があります。	N/A
キュー	はい	N/A
トリガー	はい、ただし無効として設定されます。	UiPath クラウド プラットフォームにユーザーが存在しない場合は失敗します。 ロボット アカウントのマッピングが使用されている場合は失敗します。
アセット	特定のアセットの種類は完全にサポートされますが、資格情報アセットには考慮事項がいくつかあります。	モダン フォルダー内のユーザーごとのアセット値
フォルダー フィード	はい	N/A

移行ツールで移行されないエンティティ

移行ツールでは、以下のエンティティは移行されません。

• ユーザー アカウントとロボット アカウント
• ロールの割り当て
• キュー アイテム
• アクション カタログ
• Webhook
• テスト エンティティ (テスト セット、テスト ケース、テスト実行、テスト スケジュール、テスト データのキュー)
• ストレージ バケット
• ログ
• タスク

外部アプリケーションとして移行ツールを登録する

移行ツールは、移行されるエンティティを作成するためにクラウド プラットフォームの Orchestrator サービス API に接続する必要があります。これには OAuth フローが使用されるため、外部アプリケーションとして登録する必要があります。

Automation Cloud 移行ツールを外部アプリケーションとして登録するには、以下の手順を実行します。

1. 「外部アプリケーションを追加する」の手順に従って、移行ツールを新しい外部アプリケーションとして追加します。必ず次の設定を使用してください。
   • 種類: 非機密
   • リソース: Orchestrator API
   • ユーザー スコープ: OR.Folders、OR.Settings、OR.Robots、OR.Machines、OR.Execution、OR.Assets、OR.Users、OR.Jobs、OR.Queues
   • リダイレクト URL: http://127.0.0.1:8888/auth/
2. 後で使用するためにアプリケーション ID を保存します。

移行ツールを実行する

移行ツールでは、一度に 1 つのテナントを移行できます。このツールはテナントごとに実行できます。実行するたびに、ツールは次の操作を実行します。

• On-Premises Orchestrator に接続して、指定したテナントのエンティティをエクスポートします。
• クラウド プラットフォームに接続して、移行するエンティティを Orchestrator でインポートおよび作成します。

移行の対象となるエンティティについて詳しくは、ツールによって移行されるエンティティに関するこちらのページをご覧ください。

1. ツール用にダウンロードした .zip ファイルを展開してから、.exe ツールを実行します。

2. エクスポート環境を選択するには、以下のいずれかの手順を実行します。

   • スタンドアロンの Orchestrator から移行する場合は、[オンプレミスの MSI] を選択します。
   • Automation Suite の Orchestrator から移行する場合は、[Automation Suite] を選択して外部アプリケーションに接続し、エクスポートの入力フォームに入力します。
   

3. 以下の情報を入力して、ツールが On-Premises Orchestrator に接続できるようにします。

   
   
   注:

   移行するすべてのエンティティに対する [表示 ] 権限も持つ管理者アカウントの資格情報を提供するようにしてください。

4. [ エクスポートを開始 ] を選択して、ソース環境に接続し、セットアップ情報をダウンロードします。エクスポートが開始されます。完了までに時間がかかる場合があります。

   

   完了すると、エクスポートの概要には、正常にエクスポートされたすべてのエンティティのリストが表示されます。[ファイルを開く] を選択すると、エクスポートの概要用に作成されたローカル ファイル (詳細を含む) を表示できます。

   

5. [ホーム] を選択して、移行ツールの最初の画面に戻ります。

6. アクティベーションの方法として、今回は [Automation Cloud に接続] を選択します。

7. 以下の情報を入力して、ツールがクラウド プラットフォームに接続してセットアップ情報をアップロードできるようにします。クラウド プラットフォームに接続するために必要なフィールドは、下表のとおりです。

   

フィールド	詳細
クライアント アプリケーション ID	クラウド プラットフォームでの外部アプリケーションの登録に関連付けられた アプリケーション ID の値です。 この値は、[管理] > [外部アプリケーション] ページで見つかります。
組織名	クラウド プラットフォーム URL の組織に固有の部分です。組織管理者は、[管理] > [組織設定] の [URL] フィールドでこの情報を確認できます。 注: 完全な URL を含める必要はなく、組織に固有の編集可能な部分のみを含める必要があります。たとえば、URL が https://cloud.uipath.com/myOrgName の場合は、フィールドに myOrgName を追加します。
テナント名	移行する情報を追加する Cloud Platform のテナントの正確な名前です。移行されたデータは、そのテナントに関連付けられた Orchestrator サービスに表示されます。

8. **[インポートを開始]** を選択してクラウド プラットフォームに接続し、対象の Orchestrator サービスへの情報の移行を開始します。

インポートが開始されます。完了までに時間がかかる場合があります。

OAuth を使用してクラウド プラットフォームに接続するには、外部アプリケーションの登録時に追加される範囲に対する適切な権限を持つユーザーが、クラウド オファーにログインする必要があります。ログイン後 OAuth フローが正常に完了すると、新しいウィンドウが開き、成功のメッセージが表示されます。

完了すると、インポートの概要には、クラウド プラットフォームの Orchestrator サービスに正常にインポートされたすべてのエンティティのリストが表示されます。

インポートされなかったものはすべて Error としてリストされ、部分的にインポートされたものは Warning としてリストされます。[レポートを表示] をクリックすると、Error または Warning が発生したエンティティのより詳細な情報を表示できます。 9. 準備ができたら、[完了] を選択してツールを閉じます。

ヒント:

必要に応じて、ツールを再度実行して別のテナントのデータを移行できます。

移行後のタスク

Automation Cloud 移行ツールですべてのデータを移行することはできないため、いくつかの最終的な作業を手動で実行する必要があります。

1. クラウド プラットフォームでインポート対象だったテナントを選択し、Orchestrator を開きます。フォルダーとエンティティが正常に移行されたことを確認します。インポートの概要で、警告やエラーが発生した特定の項目を確認できます。
2. Orchestrator にロボットとサービスのライセンスを割り当てるマシンは、利用可能なライセンスが存在する間は作成され、ライセンスが付与されますが、ライセンスを使い切った後もマシンはライセンスなしで作成され続けます。そのため、マシンを更新して適切な数のライセンスを割り当てる必要があります。
3. ツールで移行されなかったライブラリ フィードを手動でアップロードします。
4. エクスポート時またはインポート時にスキップされたロボットがある場合は、それらを手動で作成します。
5. ツールで移行されない Webhook、タスク カタログ、資格情報ストア、その他の情報を作成します。移行ツールによって移行されるエンティティに関するこちらのセクションには、ツールで移行されないエンティティのリストも含まれています。
6. Cloud Orchestrator サービスに手動でロボットを接続します。
7. 必要に応じてトリガーを手動で有効化します。
8. Orchestrator 内のパスワードが必要な場所 (ロボット、設定、資格情報アセット) をすべて確認してパスワードを追加します。

ヘルプ

エクスポートまたはインポート中、あるいはインポート後に発生した問題に対する支援が必要な場合は、サポート チケットを開き、以下のファイルを提出します。

• ログ ファイル (logs サブフォルダー内)
• エクスポート レポート ファイル (MigrationAssets サブフォルダー内)
• インポート レポート ファイル (MigrationAssets サブフォルダー内)

上記のファイルの他に、次の情報があると役立ちます。

• On-Premises Orchestrator のバージョン
• クラウド プラットフォームの組織名とテナント名