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

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

このページの説明は、オンプレミスの Orchestrator をスタンドアロンでまたは Automation Suite 経由で Automation Cloud^TM に移行する場合に適用されます。

オンプレミスの Orchestrator から Automation Cloud^TM への移行を計画している際は、次の手順を実行することをお勧めします。

サポートされているオンプレミス Orchestrator のバージョンにアップグレードします。
クラシックフォルダーからモダンフォルダーに移行します。Automation Cloud^TM ではクラシックフォルダーの使用に制限があるためです。
移行ツールを実行して、オンプレミスの Orchestrator を Automation Cloud^TM に移行します。

注:

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

要件

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

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

前提条件

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

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

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

移行ツールを使用すると、Orchestrator の設定を反映するために、以下のエンティティが Automation Cloud^TM 内に自動的に作成されます。

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

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

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

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

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

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

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

「外部アプリケーションを追加する」の手順に従って、移行ツールを新しい外部アプリケーションとして追加します。必ず次の設定を使用してください。
- 種類: 非機密
- リソース: 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/
後で使用するためにアプリケーション ID を保存します。

移行ツールを実行する

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

On-Premises Orchestrator に接続して、指定したテナントのエンティティをエクスポートします。
Automation Cloud^TM に接続して、移行するエンティティを Orchestrator でインポートおよび作成します。

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

ツール用にダウンロードした .zip ファイルを展開してから、.exe ツールを実行します。
エクスポート環境を選択するには、以下のいずれかの手順を実行します。
- スタンドアロンの Orchestrator から移行する場合は、[オンプレミスの MSI] を選択します。
- Automation Suite の Orchestrator から移行する場合は、[Automation Suite] を選択して外部アプリケーションに接続し、エクスポートの入力フォームに入力します。
以下の情報を入力して、ツールが On-Premises Orchestrator に接続できるようにします。

注: 移行するすべてのエンティティに対する [表示] 権限も持つ管理者アカウントの資格情報を提供するようにしてください。
[エクスポートを開始] を選択して、ソース環境に接続し、セットアップ情報をダウンロードします。エクスポートが開始されます。完了までに時間がかかる場合があります。

完了すると、エクスポートの概要には、正常にエクスポートされたすべてのエンティティのリストが表示されます。[ファイルを開く] を選択すると、エクスポートの概要用に作成されたローカルファイル (詳細を含む) を表示できます。
[ホーム] を選択して、移行ツールの最初の画面に戻ります。
アクティベーションの方法として、今回は [Automation Cloud^TM に接続] を選択します。

以下の情報を入力して、ツールが Automation Cloud^TM に接続してセットアップ情報をアップロードできるようにします。

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

[インポートを開始] を選択して Automation Cloud^TM に接続し、対象の Orchestrator サービスへの情報の移行を開始します。

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

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

完了すると、インポートの概要には、Automation Cloud^TM の Orchestrator サービスに正常にインポートされたすべてのエンティティのリストが表示されます。

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

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

移行後のタスク

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

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