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

このチェックリストは、組織リソース間でプロジェクトを移行する際に有用です。以下のチェックリストには、組織リソース間でプロジェクトを移行する際に必要な主なタスクのリスト、各ステップの簡単な手順、詳細情報へのリンクが記載されています。

移行計画を作成する

移行によるプロジェクト内で実行されているサービスへの影響を考慮する必要があります。プロジェクトの移行によってリソース階層が変更されると、継承されるポリシー（組織のポリシーや 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 エラーが発生します。

プロジェクトの移行に必要な組織のポリシーを構成するには、親組織と移行先の組織に対する roles/orgPolicy.policyAdmin ロールが必要です。

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

特殊なケースに対応する

組織リソース間でプロジェクトを移行する場合は、プロジェクト レベルと組織リソースレベルで特定のシナリオに対処する必要が生じる場合があります。移行計画の一環として、プロジェクトの運用を関連サービスに依存している場合は、このようなケースを検討する必要があります。

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

移行を実行する

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

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