Cloud Build-Standorte

Cloud Build unterstützt regionale Builds in privaten Pools und Standardpools.

Wenn Sie eine Region für Ihre Builds auswählen, sollten Sie hauptsächlich Latenz und Verfügbarkeit berücksichtigen. Sie können in der Regel die Region auswählen, die den Nutzern Ihres Cloud Build am nächsten liegt. Sie sollten jedoch auch den Standort der anderen Google Cloud Produkte und ‑Dienste berücksichtigen, in die Ihr Build möglicherweise integriert wird. Eine standortübergreifende Verwendung von Diensten kann die Latenz der Anwendung sowie die Preise beeinflussen.

Cloud Build ist in den folgenden Regionen verfügbar:

  • 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

Region auswählen

Wenn Sie regionale Builds ausführen möchten, geben Sie die Region an, wenn Sie einen Build über die Befehlszeile starten oder einen Build-Trigger erstellen.

Um eine Region für Ihren privaten Pool auszuwählen, geben Sie die Region beim Erstellen des privaten Pools an. Nachdem Sie einen privaten Pool in einer Region erstellt haben, können Sie ihn nicht in eine andere Region verschieben. Wenn Sie einen privaten Pool in einer bestimmten Region erstellen, wird er von Google verwaltet, um in allen Zonen innerhalb dieser Region redundant verfügbar zu sein.

Wenn in der Build-Konfigurationsdatei, die Ihrem Trigger zugeordnet ist, ein privater Pool angegeben ist, muss die Region, die Sie für Ihren Trigger auswählen, mit der Region des privaten Pools übereinstimmen.

Wenn Sie global als Region für den Build-Trigger auswählen, verwendet Cloud Build die Region, die in der mit dem Trigger verknüpften Build-Konfigurationsdatei angegeben ist, um den Build auszuführen. Dies kann entweder die Region des privaten Pools sein, wenn Sie einen privaten Pool in Ihrer Build-Konfigurationsdatei angeben, oder der globale Standardpool, wenn Sie keinen privaten Pool angeben.

Mit regionalen Endpunkten auf Cloud Build-Ressourcen zugreifen

Sie können regionale Endpunkte verwenden, um auf Ressourcen in Cloud Build zuzugreifen. Mit regionalen Endpunkten können Sie Ihre Arbeitslasten so ausführen, dass sie den Datenstandort- und Datenhoheitsanforderungen entsprechen, wobei Ihr Anfragetraffic direkt an die im Endpunkt angegebene Region weitergeleitet wird.

Regionale Endpunkte sind Anfrageendpunkte, die nur Anfragen zulassen, wenn die betroffene Ressource am vom Endpunkt angegebenen Standort vorhanden ist. Wenn Sie beispielsweise den Endpunkt https://cloudBuild.me-central2.rep.googleapis.com in einer Anfrage zum Erstellen von Builds verwenden, wird die Anfrage nur fortgesetzt, wenn sich die Build-Konfigurationsdatei in me-central2 befindet.

Im Gegensatz zu globalen Endpunkten, bei denen Anfragen an einem anderen Standort als dem der Ressource verarbeitet werden können, sorgen regionale Endpunkte dafür, dass Ihre Anfragen nur innerhalb des durch den Endpunkt angegebenen Standorts (an dem sich die Ressource befindet) verarbeitet werden. Regionale Endpunkte beenden TLS-Sitzungen an dem vom Endpunkt angegebenen Standort für Anfragen aus dem Internet, von anderenGoogle Cloud -Ressourcen (z. B. virtuellen Compute Engine-Maschinen), von lokalen Diensten mit VPN oder Interconnect und von Virtual Private Clouds (VPCs).

Regionale Endpunkte stellen den Datenstandort sicher, indem inaktive und übertragene Objektdaten nicht aus dem vom Endpunkt angegebenen Standort verschoben werden können. Die schließt Ressourcenmetadaten wie Objektnamen und Bucket-IAM-Richtlinien aus. Weitere Informationen finden Sie unter Hinweis zu Kundendaten und Dienstdaten.

Informationen zu den Schritten, die zum Ausführen eines Builds erforderlich sind, finden Sie unter Builds ausführen.

Google Cloud CLI für die Verwendung mit regionalen Endpunkten konfigurieren

So konfigurieren Sie die gcloud CLI für die Verwendung mit regionalen Endpunkten:

  1. Achten Sie darauf, dass Sie die Google Cloud CLI 402.0.0 oder höher verwenden.

  2. Setzen Sie das Attribut api_endpoint_overrides/cloudbuild auf den regionalen Endpunkt, den Sie verwenden möchten:

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

    Alternativ können Sie die Umgebungsvariable CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD auf den Endpunkt festlegen:

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