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 時，要求才會繼續執行。

與全域端點不同，全域端點可在資源所在位置以外的位置處理要求，而區域端點則可保證要求只會在資源所在端點指定的位置處理。區域端點會在端點指定的位置終止 TLS 工作階段，這些位置包括從網際網路、其他Google Cloud 資源 (例如 Compute Engine 虛擬機器)、使用 VPN 或 Interconnect 的內部服務，以及虛擬私有雲 (VPC) 收到的請求。

區域端點會確保物件靜態資料和傳輸中的資料不會移出端點指定的位置，以確保資料落地。這項保證不包含資源中繼資料，例如物件名稱和值區 IAM 政策。詳情請參閱「客戶資料和服務資料的注意事項」。

如要瞭解執行建構作業所需的步驟，請參閱「執行建構作業」。

設定 Google Cloud CLI 以便與區域端點搭配使用

如要設定 gcloud CLI 以搭配區域 Endpoints 使用，請執行下列操作：

  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/

部分專案的管制區域

視用途而定，某些專案可能會受到限制，只能在下列區域使用 Cloud Build：

  • us-central1
  • us-west2
  • europe-west1
  • asia-east1
  • australia-southeast1
  • southamerica-east1