Cloud Build のロケーション

Cloud Build は、プライベート プールとデフォルト プールのリージョン ビルドをサポートします。

ビルドのリージョンを選択するときは、レイテンシと可用性を第一に考慮してください。一般的には、Cloud Build のユーザーに最も近いリージョンを選択しますが、ビルドと統合される他の Google Cloud プロダクトやサービスのロケーションも考慮する必要があります。使用するサービスが複数のロケーションにまたがっていると、アプリのレイテンシだけでなく、料金にも影響します。

Cloud Build は、次のリージョンで利用できます。

  • africa-south1
  • asia-east1
  • asia-east2
  • asia-northeast1
  • asia-northeast2
  • asia-northeast3
  • asia-south1
  • asia-south2
  • asia-southeast1
  • asia-southeast2
  • australia-southeast1
  • australia-southeast2
  • europe-central2
  • europe-north1
  • europe-north2
  • europe-southwest1
  • europe-west1
  • europe-west2
  • europe-west3
  • europe-west4
  • europe-west6
  • europe-west8
  • europe-west9
  • europe-west10
  • europe-west12
  • me-central1
  • me-central2
  • me-west1
  • northamerica-northeast1
  • northamerica-northeast2
  • northamerica-south1
  • southamerica-east1
  • southamerica-west1
  • us-central1
  • us-east1
  • us-east4
  • us-east5
  • us-south1
  • us-west1
  • us-west2
  • us-west3
  • us-west4

リージョンを選択

リージョンビルドを実行するには、コマンドラインでビルドを開始するときや、ビルドトリガーを作成するときに、リージョンを指定します。

プライベート プールのリージョンを選択するには、プライベート プールの作成時にリージョンを指定します。リージョン内にプライベート プールを作成した後は、そのプールを別のリージョンに移動できません。特定のリージョンにプライベート プールを作成すると、そのリージョン内のすべてのゾーンで冗長的に利用できるように Google によって管理されます。

トリガーに関連付けられたビルド構成ファイルでプライベート プールが指定されている場合、トリガーに選択するリージョンがプライベート プールのリージョンと一致する必要があります。

ビルドトリガーのリージョンとして global を選択すると、Cloud Build はトリガーに関連付けられたビルド構成ファイルで指定されたリージョンを使用してビルドを実行します。ビルド構成ファイルでプライベート プールを指定した場合はプライベート プールのリージョンになりますが、プライベート プールを指定しない場合はグローバル デフォルト プールになります。

リージョン エンドポイントを使用して Cloud Build リソースにアクセスする

リージョン エンドポイントを使用して、Cloud Build のリソースにアクセスできます。リージョン エンドポイントを使用すると、データ所在地とデータ主権の要件を遵守する方法でワークロードを実行できます。この場合、リクエスト トラフィックはエンドポイントで指定されているリージョンに直接転送されます。

リージョン エンドポイントは、影響を受けるリソースがエンドポイントで指定されたロケーションに存在する場合にのみ、リクエストの続行を許可するリクエスト エンドポイントです。たとえば、ビルドの作成リクエストでエンドポイント https://cloudBuild.me-central2.rep.googleapis.com を使用した場合、ビルド構成ファイルが me-central2 にある場合にのみリクエストが処理されます。

リソースが存在する場所とは異なるロケーションでリクエストを処理できるグローバル エンドポイントとは異なり、リージョン エンドポイントは、リソースが存在するエンドポイントによって指定されたロケーション内でのみ、リクエストが処理されることを保証します。リージョン エンドポイントは、インターネット、他のGoogle Cloud リソース（Compute Engine 仮想マシンなど）、VPN または Interconnect を使用したオンプレミス サービス、Virtual Private Cloud（VPC）から受信したリクエストに対して、エンドポイントで指定されたロケーションで TLS セッションを終端します。

リージョン エンドポイントは、オブジェクトの保存中と転送中のデータがエンドポイントで指定されたロケーションから移動しないようにすることで、データ所在地を保証します。オブジェクト名やバケットの IAM ポリシーなどのリソース メタデータはこの保証の対象外です。詳細については、顧客データとサービスデータに関する注意事項をご覧ください。

ビルドを実行するために必要な手順については、ビルドの実行をご覧ください。

リージョン エンドポイントで使用できるように Google Cloud CLI を構成する

リージョン エンドポイントで使用できるように gcloud CLI を構成する手順は次のとおりです。

  1. Google Cloud CLI 402.0.0 以降を使用していることを確認します。

  2. api_endpoint_overrides/cloudbuild プロパティを、使用するリージョン エンドポイントに設定します。

    gcloud config set api_endpoint_overrides/cloudbuild https://cloudbuild.LOCATION.rep.googleapis.com/

    または、CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD 環境変数をエンドポイントに設定することもできます。

    CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD=https://cloudbuild.LOCATION.rep.googleapis.com/