Localizações do Cloud Build

O Cloud Build suporta compilações regionais em pools privados e pools predefinidos.

Quando selecionar uma região para as suas compilações, as principais considerações devem ser a latência e a disponibilidade. Geralmente, pode selecionar a região mais próxima dos utilizadores do Cloud Build, mas também deve considerar a localização dos outros Google Cloud produtos e serviços com os quais a compilação se pode integrar. A utilização de serviços em várias localizações pode afetar a latência da sua app, bem como os preços.

O Cloud Build está disponível nas seguintes regiões:

  • 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

Selecionar região

Para executar compilações regionais, especifique a região quando iniciar uma compilação através da linha de comandos ou quando criar um acionador de compilação.

Para selecionar uma região para o seu conjunto privado, especifique a região quando criar o conjunto privado. Depois de criar um conjunto privado numa região, não pode movê-lo para outra região. Quando cria um pool privado numa região específica, este é gerido pela Google para estar redundante e disponível em todas as zonas dessa região.

Se o ficheiro de configuração de compilação associado ao acionador especificar um conjunto privado, a região que selecionar para o acionador tem de corresponder à região do conjunto privado.

Se selecionar global como a região para o acionador de compilação, o Cloud Build usa a região especificada no ficheiro de configuração de compilação associado ao acionador para executar a compilação. Pode ser a região do conjunto privado, se especificar um conjunto privado no ficheiro de configuração de compilação, ou o conjunto predefinido global se não especificar um conjunto privado.

Aceda aos recursos do Cloud Build através de pontos finais regionais

Pode usar pontos finais regionais para aceder a recursos no Cloud Build. A utilização de pontos finais regionais permite-lhe executar as suas cargas de trabalho de uma forma que esteja em conformidade com os requisitos de residência de dados e soberania de dados, em que o tráfego de pedidos é encaminhado diretamente para a região especificada no ponto final.

Os pontos finais regionais são pontos finais de pedidos que só permitem que os pedidos prossigam se o recurso afetado existir na localização especificada pelo ponto final. Por exemplo, quando usa o ponto final https://cloudBuild.me-central2.rep.googleapis.com num pedido de criação de compilações, o pedido só prossegue se o ficheiro de configuração da compilação estiver localizado em me-central2.

Ao contrário dos pontos finais globais, em que os pedidos podem ser processados numa localização diferente da localização do recurso, os pontos finais regionais garantem que os seus pedidos são processados apenas na localização especificada pelo ponto final onde o recurso reside. Os pontos finais regionais terminam as sessões TLS na localização especificada pelo ponto final para pedidos recebidos da Internet, de outrosGoogle Cloud recursos (como máquinas virtuais do Compute Engine), de serviços no local através de VPN ou Interconnect e de nuvens privadas virtuais (VPCs).

Os pontos finais regionais garantem a residência de dados, assegurando que os dados do objeto em repouso e em trânsito não são movidos para fora da localização especificada pelo ponto final. Esta garantia exclui metadados de recursos, como nomes de objetos e políticas de IAM de contentores. Para mais informações, consulte a Nota sobre os dados de clientes e os dados de serviços.

Para ver informações sobre os passos necessários para executar uma compilação, consulte o artigo Executar compilações.

Configure a CLI do Google Cloud para utilização com pontos finais regionais

Para configurar a gcloud CLI para utilização com pontos finais regionais, faça o seguinte:

  1. Certifique-se de que está a usar a CLI do Google Cloud 402.0.0 ou mais recente.

  2. Defina a propriedade api_endpoint_overrides/cloudbuild para o ponto final regional que quer usar:

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

    Em alternativa, pode definir a variável de ambiente CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD para o ponto final:

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

Regiões restritas para alguns projetos

Consoante a utilização, determinados projetos podem estar restritos à utilização do Cloud Build nas seguintes regiões:

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