Migration Center を使用すると、アマゾン ウェブ サービス(AWS)や Azure などの他のクラウド プロバイダでホストされているインフラストラクチャのパフォーマンス データと使用状況データをインポートできます。
他のクラウド プロバイダからデータをインポートするには、次の手順を行います。
- 収集スクリプトをダウンロードします。
- クラウド インフラストラクチャでスクリプトを実行し、出力テーブルを生成します。
- Migration Center に出力テーブルをアップロードします。
収集スクリプトを実行するためのベスト プラクティス
収集スクリプトを実行する場合は、次の点を考慮してください。
- AWS CloudShell(AWS からデータを収集する場合)または Azure Cloud Shell(Azure からデータを収集する場合)のインスタンスを使用して収集スクリプトを実行します。これらのシェルを使用すると、他のランタイム環境で収集スクリプトを実行するための認証キーを生成、配布、保守する必要がなくなります。
- 最小限の読み取り専用権限を持つアカウントを借用して、収集スクリプトを実行します。読み取り専用権限を使用すると、AWS リソースまたは Azure リソースに誤って変更されるのを防ぐことができます。
- このスクリプトはオープンソースであるため、組織に特定の規制要件がある場合は、コードを確認して、収集されるデータの種類を正確に把握してください。
制限事項
- アップロードするファイルの最大サイズは 100 MB です。
スクリプトをダウンロードする
スクリプトをダウンロードするには、ご利用のクラウド プロバイダに応じて、次のいずれかのリンクを選択します。
スクリプトを実行する
スクリプトを実行するには、リポジトリの README ファイルの手順に沿って操作します。このスクリプトにより、収集されたデータのテーブルを含む ZIP ファイルが生成されます。 zip ファイルからファイルを抽出します。
ZIP ファイルには、Migration Center にアップロードする次のファイルが含まれています。
vmInfo.csv
perfInfo.csv
diskInfo.csv
tagInfo.csv
Migration Center にアップロードできない他のファイル(resources.json
ファイルなど)も含まれている場合があります。JSON ファイルを Migration Center にアップロードするとエラーが発生します。
収集スクリプトの結果をアップロードする
ファイルをアップロードする手順は次のとおりです。
コンソール
[データ インポート] ページに移動します。
[データを追加] > [ファイルをアップロード] をクリックします。
[ファイルのアップロードの設定] セクションで、ファイル アップロードの名前を入力します。
[ファイル形式] リストから [AWS エクスポート] または [Azure エクスポート] を選択します。
[アップロードするファイルを選択] をクリックし、アップロードするすべてのファイルを選択します。
ファイルをアップロードすることを確認して開始するには、[ファイルをアップロード] をクリックします。
ファイルが正しく検証された場合、ファイルからアセットを作成するには、[データをインポート] をクリックしてから [確認] をクリックします。
API
インポート ジョブを作成します。
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID { "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID" }
以下を置き換えます。
PROJECT_ID
: インポート ジョブを作成するプロジェクトの ID。REGION
: インポート ジョブを作成するリージョン。IMPORT_JOB_ID
: 新しいインポート ジョブの ID。SOURCE_ID
: インポート ジョブに関連付ける既存のソースの ID。
省略可: インポート ジョブが正しく作成されたことを確認するには、インポート ジョブを取得します。
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
インポート ジョブにアタッチするインポート データ ファイルを作成します。
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID { "format": "IMPORT_JOB_FORMAT" }
以下を置き換えます。
DATA_FILE_ID
: 新しいデータファイルの IDIMPORT_JOB_FORMAT
:IMPORT_JOB_FORMAT_EXPORTED_AWS_CSV
またはIMPORT_JOB_FORMAT_EXPORTED_AZURE_CSV
のいずれか
データファイルを取得します。
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
レスポンスの
signedUrl
フィールドから URL をコピーします。コピーした URL にファイルをアップロードします。
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
以下を置き換えます。
UPLOAD_FILE_PATH
: アップロードするファイルのローカルパス。COPIED_URL
: プレビュー手順からコピーした署名付き URL。
省略可: 同じインポート ジョブでデータファイルをさらに作成するには、手順 3 ~ 6 を繰り返します。
省略可: インポート ジョブのすべてのデータファイルを取得します。
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
インポート ジョブを検証します。
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
インポート ジョブを取得して、検証レポートを表示します。状態が
READY
の場合、次のステップに進むことができます。 それ以外の場合は、ジョブまたは特定のファイルを修正する必要があります。ファイルの削除や新しいファイルのアップロードが必要になる場合があります。GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
インポート ジョブを実行します。
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
インポート ジョブを取得し、実行レポートを表示します。状態が
COMPLETED
の場合、ジョブは正常に実行されています。 それ以外の場合、ジョブが失敗して終了状態の場合、実行レポートにはエラーが含まれます。 新しいインポート ジョブを作成し、必要な変更を適用します。GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
ファイルのアップロードで問題が発生した場合は、一般的なエラー メッセージのトラブルシューティングをご覧ください。
アップロードを確認する
ファイルをアップロードすると、Migration Center はこれらのファイルが正式に正しいかどうかを検証します。検証に成功すると、Migration Center はデータを処理して、新しいアセットを作成するか、既存のアセットを更新します。アップロード ジョブのステータスは、Google Cloud コンソールで確認できます。
アップロード ジョブのステータスを確認する手順は次のとおりです。
- [データ インポート] ページに移動し、[ファイルのアップロード] をクリックします。
- ファイル インポートのリストから、確認するアップロードを選択します。
- [ファイルのアップロード] ページの [データ インポートの進行状況] で、アップロードしたファイルの [ステータス] を確認します。
ファイルのステータスは次のいずれかになります。
ステータスのリスト
- 完了。ファイルのインポートに成功しました。
- 準備完了。ファイルが検証に合格し、インポートできる状態になっています。
- 保留中。別のファイルの処理が完了するのを待機しています。
- 実行中。ファイルは現在処理中です。
- 検証中。ファイルは検証中です。
- 検証失敗。いくつかのエラーがファイルに含まれています。エラーを修正してから、ファイルをもう一度アップロードしてみてください。
- 失敗。ファイルをインポートできませんでした。
エラーの詳細を確認
ファイルをインポートした後にエラーが発生した場合は、Google Cloud コンソールでエラー メッセージを直接確認できます。
アップロード ジョブのエラーを確認するには、次の手順に従います。
- [データ インポート] ページに移動し、[ファイルのアップロード] をクリックします。
- 警告またはエラーが表示されているインポート ファイルをクリックします。 インポート ファイルの詳細ページにエラーの全一覧が表示されます。
インポート ファイルの詳細ページでは、エラーの原因となっているアセットとデータ フィールドを確認し、エラーの説明を表示できます。 ファイルのインポート ジョブのエラーにより、Migration Center が新しいアセットを作成したり、既存のアセットを新しい変更で更新したりできなくなる場合があります。エラーを修正するには、ファイルを編集して、新しいファイル インポート ジョブを作成し、もう一度アップロードします。
可能性のあるエラー メッセージの詳細については、ファイルのインポート エラーのトラブルシューティングをご覧ください。
次のステップ
- Migration Center の収集方法の詳細を確認する。
- ファイルのアップロードを管理する方法を確認する。