Località di Cloud Build

Cloud Build supporta le build a livello di regione nei pool privati e nei pool predefiniti.

Quando selezioni una regione per le build, le considerazioni principali devono essere latenza e disponibilità. In genere puoi selezionare la regione più vicina agli utenti di Cloud Build, ma devi anche considerare la posizione degli altri Google Cloud prodotti e servizi con cui la build potrebbe integrarsi. L'utilizzo di servizi in più località può influire sulla latenza dell'app, nonché sui prezzi.

Cloud Build è disponibile nelle seguenti regioni:

  • 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

Seleziona una regione

Per eseguire build regionali, specifica la regione quando avvii una build tramite la riga di comando o quando crei un trigger di build.

Per selezionare una regione per il pool privato, specifica la regione durante la creazione del pool privato. Una volta creato un pool privato all'interno di una regione, non puoi spostarlo in un'altra regione. Quando crei un pool privato in una regione specifica, questo viene gestito da Google per essere disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Se il file build config associato al trigger specifica un pool privato, la regione che selezioni per il trigger deve corrispondere alla regione del pool privato.

Se selezioni global come regione per il trigger di build, Cloud Build utilizza la regione specificata nel file di configurazione della build associato al trigger per eseguire la build. Può trattarsi della regione del pool privato, se ne specifichi uno nel file di configurazione della build, oppure del pool globale predefinito se non ne specifichi uno.

Accedere alle risorse Cloud Build utilizzando endpoint regionali

Puoi utilizzare gli endpoint regionali per accedere alle risorse in Cloud Build. L'utilizzo di endpoint regionali ti consente di eseguire i tuoi carichi di lavoro in modo conforme ai requisiti di residenza dei dati e sovranità dei dati, in cui il traffico delle richieste viene indirizzato direttamente alla regione specificata nell'endpoint.

Gli endpoint regionali sono endpoint di richiesta che consentono di procedere con le richieste solo se la risorsa interessata esiste nella località specificata dall'endpoint. Ad esempio, quando utilizzi l'endpoint https://cloudBuild.me-central2.rep.googleapis.com in una richiesta di creazione di build, la richiesta procede solo se il file di configurazione della build si trova in me-central2.

A differenza degli endpoint globali, in cui le richieste possono essere elaborate in una località diversa da quella in cui si trova la risorsa, gli endpoint regionali garantiscono che le richieste vengano elaborate solo all'interno della località specificata dall'endpoint in cui si trova la risorsa. Gli endpoint regionali terminano le sessioni TLS nella località specificata dall'endpoint per le richieste ricevute da internet, da altre risorseGoogle Cloud (come le macchine virtuali Compute Engine), da servizi on-premise che utilizzano VPN o Interconnect e da Virtual Private Cloud (VPC).

Gli endpoint regionali garantiscono la residenza dei dati assicurando che i dati at-rest e in transito dell'oggetto non vengano spostati dalla località specificata dall'endpoint. Questa garanzia esclude i metadati delle risorse, ad esempio i nomi degli oggetti e le policy IAM dei bucket. Per saperne di più, vedi Nota sui dati dei clienti e sui dati dei servizi.

Per informazioni sui passaggi necessari per eseguire una build, consulta Esecuzione di build.

Configura Google Cloud CLI per l'utilizzo con endpoint regionali

Per configurare gcloud CLI per l'utilizzo con endpoint regionali, procedi nel seguente modo:

  1. Assicurati di utilizzare Google Cloud CLI 402.0.0 o versioni successive.

  2. Imposta la proprietà api_endpoint_overrides/cloudbuild sull'endpoint regionale che vuoi utilizzare:

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

    In alternativa, puoi impostare la variabile di ambiente CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD sull'endpoint:

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