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 以搭配使用區域端點，請完成下列步驟：

  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/