プロジェクトの移行チェックリスト

このチェックリストは、組織リソース間でプロジェクトを移行する際に役立ちます。以下のチェックリストには、組織リソース間でのプロジェクトの移行に関連する主なタスクのリスト、各ステップの簡単な手順、詳細情報へのリンクが含まれています。

移行計画を作成する

移行によるプロジェクト内で実行されているサービスへの影響を考慮する必要があります。プロジェクトの移行によってリソース階層が変更されると、継承されるポリシー（組織のポリシーや Identity and Access Management ポリシーなど）が変更されることがあります。

プロジェクトの移行中の潜在的な影響が緩和されるように計画を作成します。計画の周知を図るには、Move Analysis API を使用して、プロジェクトの移行の阻害要因の詳細を確認します。

詳細については、移行計画を作成するをご覧ください。

Identity and Access Management のロールを割り当てる

組織リソース間でプロジェクトを移行するには、特定の IAM ロールのセットが必要です。組織のポリシーを作成および管理するための権限も必要です。

これらの権限は、次のロールを取得することで取得できます。

• 移行するプロジェクトとその親リソースのプロジェクト移動（roles/resourcemanager.projectMover）。

• 宛先フォルダまたは組織リソースのプロジェクト作成者（roles/resourcemanager.projectCreator）。

• 移行元と移行先の両方の組織リソースに対する組織ポリシー管理者（roles/orgpolicy.policyAdmin）。

必要なロールと権限の詳細については、権限を割り当てるをご覧ください。

組織のポリシーの構成

組織リソース間でプロジェクトの移行を実行するには、constraints/resourcemanager.allowedExportDestinations 制約を設定する必要があります。これにより、プロジェクトの移行先となる組織リソースが定義されます。

宛先側では、プロジェクトをインポートできる組織リソースを定義する constraints/resourcemanager.allowedImportSources 制約を設定する必要があります。

どちらの制約も適切に設定されていない場合、移行は FAILED_PRECONDITION エラーで失敗します。

これらの組織のポリシーの制約の詳細については、組織のポリシーの構成をご覧ください。

特殊なケースに対応する

組織リソース間でプロジェクトを移行する場合は、プロジェクト レベルと組織リソースレベルで特定のシナリオに対処しなければならない場合があります。考慮しなければならないサービスが存在する可能性があるため、移行計画の一環として、プロジェクトのオペレーションに関連するサービスに依存する場合は、これらのケースを考慮する必要があります。

特殊なケースとその処理方法については、特殊なケースの処理をご覧ください。

移行を実行する

上記の手順を完了したら、Resource Manager API を使用してプロジェクトを移行できます。移行を実行するには、gcloud beta projects move Google Cloud CLI コマンドまたは projects.update() REST API メソッドを使用します。

プロジェクトの移行の詳細については、移行を実行するをご覧ください。