Automation Cloud

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

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

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

注:

アップグレードまたは移行を計画する際は、ベストプラクティスに従うことをお勧めします。

Automation Cloud 移行ツールは単独で動作し、標準のプロダクトライフサイクルには従いません。

要件

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

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

前提条件

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

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

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

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

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

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

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

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

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

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

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 に接続して、移行するエンティティを Orchestrator でインポートおよび作成します。

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

ツール用にダウンロードした .zip ファイルを展開してから、ツールの .exe を実行します。
アクティベーションの方法として、[オンプレミスの MSI] を選択します。
以下の情報を入力して、ツールが On-Premises Orchestrator に接続できるようにします。

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

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

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

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

[インポートを開始] を選択して Automation Cloud に接続し、ターゲットの Orchestrator サービスへの情報の移行を開始します。
インポートが開始されます。完了までに時間がかかる場合があります。
OAuth を使用して Automation Cloud に接続するには、外部アプリケーションの登録時に追加される範囲に対する適切な権限を持つユーザーが、Automation Cloud にログインする必要があります。ログイン後 OAuth フローが正常に完了すると、新しいウィンドウが開き、成功のメッセージが表示されます。

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

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

移行後のタスク

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

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