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
  • asia-southeast3
  • 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 或互連網路的地端部署服務，以及虛擬私有雲 (VPC) 收到的要求，在端點指定的位置終止 TLS 工作階段。

區域端點可確保物件的靜態和傳輸中資料不會移出端點指定的位置，藉此保證資料落地。這項保證不包含資源中繼資料，例如物件名稱和 bucket 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/