組織リソース間でプロジェクトを移行する

プロジェクトの移行は、リソース階層内のプロジェクトの場所を変更するメタデータ オペレーションです。 Google Cloud このページでは、プロジェクトが新しい組織に移動したときに、移行の仕組み、変更されないもの、変更されるものの概要について説明します。

リソース階層内のプロジェクト

プロジェクト リソースは、組織リソースの基本レベルの構成エンティティです。 Google Cloudプロジェクトは組織リソースの下に作成され、 フォルダまたは組織リソース自体の下に配置でき、リソース階層を形成します。

買収、規制要件、事業部門の分離などの理由により、組織リソース間でプロジェクトを移行する必要が生じることがあります。 Resource Manager API を使用して、これらのプロジェクトを移行できます。移行オペレーションは、オペレーション名を表す文字列を返します。また、API を使用すると、必要に応じて移行をロールバックし、プロジェクトを階層内の元の場所に戻すことができます。

移行のシナリオ

プロジェクトの場所によって、次の 2 つのパスのどちらを使用するかが決まります。

  • プロジェクトを 1 つの組織から別の組織リソースに移行する。
  • スタンドアロン プロジェクト(組織なしで作成)を組織リソースの階層に移行する。

組織リソースに関連付けられた後でプロジェクトを 組織なし に戻す必要がある場合は、 Cloud カスタマーケアにお問い合わせください。 組織から組織なしへのセルフサービス ロールバックはサポートされていません。

API に加えて、 Google Cloud コンソールを使用して プロジェクトを選択し、新しい親の宛先を割り当てることで、プロジェクトを移動することもできます。

プロジェクトの現在の状態を確認する

始める前に、プロジェクトが組織リソースに関連付けられているかどうかを確認する必要があります。これにより、組織間パス または組織なしパス のどちらを使用するかが決まります。

プロジェクトの親組織リソースに対する resourcemanager.organizations.get 権限がない場合、コンソール内の実際の組織でプロジェクトが想定どおりに反映されない可能性があります。Google Cloud これにより、プロジェクトが組織リソースに関連付けられていないように見えることがあります。

プロジェクトが組織リソースに関連付けられているかどうかを確認するには、次のコマンドを実行します。

gcloud

gcloud projects get-ancestors PROJECT_ID

PROJECT_ID は、移行するプロジェクトの ID に置き換えます。

出力に階層内の organization リソースタイプが含まれている場合、プロジェクトはすでに組織階層の一部です。

organization タイプがないか空の場合、プロジェクトは組織リソースのないスタンドアロン プロジェクトです。

プロジェクトの状態に応じて、次のガイドに従ってください。

移行の仕組み

プロジェクトの移行はデータ転送ではありません。サービス、データベース、仮想マシン(VM)インスタンスはアクティブなままで、ダウンタイムは発生しません。代わりに、移行によってプロジェクトの親リソースが更新されます。 Google Cloud は階層継承モデルに従うため、プロジェクトが新しい親に関連付けられると、プロジェクトのセキュリティ ポスチャーがすぐに変更されます。

機能 ステータス 影響
プロジェクト ID と番号 変更なし API キー、サービス名、ハードコードされた ID は変更されません。
データとリソース 変更なし VM、Storage バケット、データベースはオンラインのままです。
直接 IAM ロール 変更なし プロジェクトに直接付与されたロールは、プロジェクトとともに移動します。
継承された IAM ロール 変更 ソース組織またはフォルダレベルで付与されたロールは失われます。
組織のポリシー 変更 ソースの制約は宛先の制約に置き換えられます。
割り当て 変更 継承された組織レベルの割り当ては失われます。プロジェクト レベルの割り当ては残ります。
請求先アカウント 変更なし プロジェクトは元の請求先アカウントにリンクされたままになります。

割り当ての影響

特定のリソースレベルで割り当てが定義されている場合、移行後に次の要素が適用されます。

  • プロジェクト レベルで定義された割り当ては変更されません。
  • 組織リソースレベルで定義された割り当ては転送されません。 組織は、継承された割り当てまたは割り当てのオーバーライドを失います。

次のページを使用して、組織リソースに適用する割り当てを判断できます。

$ gcloud alpha services quota list --service=compute.googleapis.com --consumer=projects/workloadyee --filter="metric: compute.googleapis.com/cpus"

...
  - defaultLimit: '600'
    dimensions:
      region: us-central1
    effectiveLimit: '650'
...

重要な考慮事項

移行を開始する前に、サービスの中断を防ぐために、次のリスクの高い領域を確認してください。

  • 割り当て上限: 宛先組織の割り当て上限がソースよりも低い場合、プロジェクトが到着時に割り当てを超える可能性があります。

  • アセット インベントリ: Cloud Asset Inventory のリソースの完全なリストの更新は、移行後、完全に反映されるまでに数日かかることがあります。

  • 費用と割引: 元の組織に SKU ベースまたは Enterprise Discount Program(EDP)の割引が適用されていた場合、Google の営業担当者と交渉するまで、新しい組織ではこれらの割引は適用されません。 確約利用割引(CUD)と Google Cloud Marketplace の購入も、再購入が必要になる場合があります。

  • サポートティア: 宛先組織に有効なサポート契約がない場合や、サポートレベルが低い場合は、現在のサポートティアが失われる可能性があります。

  • カスタムロール: プロジェクトが組織レベルで定義されたカスタム IAM ロールに依存している場合、これらのロールは宛先に存在しません。移動する前に、宛先組織で再作成してください。

移行のロードマップ

プロジェクトの移行プロセスを進めるには、次のロードマップを使用します。

  1. 準備: 移行計画を作成してタイミングを調整します。
  2. 実行: IAM ロールを割り当て、組織のポリシーを構成して、移行を実行します
  3. 確認: 継承されたポリシーの監査や請求の更新など、移行後のタスクを完了します。

次のステップ