Cloud Build mendukung build regional di kumpulan pribadi dan kumpulan default.
Saat memilih region untuk build, pertimbangan utama Anda haruslah latensi dan ketersediaan. Secara umum, Anda dapat memilih region yang paling dekat dengan pengguna Cloud Build, tetapi Anda juga harus mempertimbangkan lokasi produk dan layanan Google Cloud lain yang mungkin terintegrasi dengan build Anda. Penggunaan layanan di beberapa lokasi dapat memengaruhi latensi dan harga aplikasi.
Cloud Build tersedia di region berikut:
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
Pilih region
Untuk menjalankan build regional, tentukan region saat memulai build melalui command line atau saat membuat pemicu build.
Untuk memilih region bagi kumpulan pribadi Anda, tentukan region saat membuat kumpulan pribadi. Setelah membuat kumpulan pribadi dalam suatu region, Anda tidak dapat memindahkannya ke region lain. Saat Anda membuat kumpulan pribadi di region tertentu, kumpulan tersebut dikelola oleh Google agar tersedia secara redundan di semua zona dalam region tersebut.
Jika file build config yang terkait dengan pemicu Anda menentukan kumpulan pribadi, region yang Anda pilih untuk pemicu harus cocok dengan region kumpulan pribadi.
Jika Anda memilih global
sebagai region untuk pemicu build, Cloud Build akan menggunakan region yang ditentukan dalam file konfigurasi build yang terkait dengan pemicu untuk menjalankan build. Ini dapat berupa region
kumpulan pribadi, jika Anda menentukan kumpulan pribadi dalam file konfigurasi build, atau
kumpulan default global jika Anda tidak menentukan kumpulan pribadi.
Mengakses resource Cloud Build menggunakan endpoint regional
Anda dapat menggunakan endpoint regional untuk mengakses resource di Cloud Build. Dengan menggunakan endpoint regional, Anda dapat menjalankan beban kerja dengan cara yang mematuhi persyaratan residensi data dan kedaulatan data, dengan traffic permintaan Anda dirutekan langsung ke region yang ditentukan di endpoint.
Endpoint regional adalah endpoint permintaan yang hanya mengizinkan permintaan dilanjutkan jika resource yang terpengaruh ada di lokasi yang ditentukan oleh endpoint. Misalnya, saat Anda menggunakan endpoint https://cloudBuild.me-central2.rep.googleapis.com
dalam permintaan pembuatan build, permintaan hanya akan dilanjutkan jika file konfigurasi build berada di me-central2
.
Tidak seperti endpoint global, tempat permintaan dapat diproses di lokasi yang berbeda dari tempat resource berada, endpoint regional menjamin bahwa permintaan Anda hanya akan diproses dalam lokasi yang ditentukan oleh endpoint tempat resource berada. Endpoint regional menghentikan sesi TLS di lokasi yang ditentukan oleh endpoint untuk permintaan yang diterima dari Internet, dari resourceGoogle Cloud lainnya (seperti virtual machine Compute Engine),dari layanan lokal yang menggunakan VPN atau Interconnect, dan dari Virtual Private Cloud (VPC).
Endpoint regional menjamin residensi data dengan memastikan bahwa data objek Anda dalam penyimpanan dan dalam pengiriman tidak dipindahkan dari lokasi yang ditentukan oleh endpoint. Jaminan ini mengecualikan metadata resource, seperti nama objek dan kebijakan IAM bucket. Untuk informasi selengkapnya, lihat Catatan tentang Data Pelanggan dan Data layanan.
Untuk mengetahui informasi tentang langkah-langkah yang diperlukan untuk menjalankan build, lihat Menjalankan build.
Mengonfigurasi Google Cloud CLI untuk digunakan dengan endpoint regional
Untuk mengonfigurasi gcloud CLI agar dapat digunakan dengan endpoint regional, lakukan langkah berikut:
Pastikan Anda menggunakan Google Cloud CLI 402.0.0 atau yang lebih baru.
Tetapkan properti
api_endpoint_overrides/cloudbuild
ke endpoint regional yang ingin Anda gunakan:gcloud config set api_endpoint_overrides/cloudbuild https://cloudbuild.LOCATION.rep.googleapis.com/
Atau, Anda dapat menetapkan variabel lingkungan
CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD
ke endpoint:CLOUDSDK_API_ENDPOINT_OVERRIDES_CLOUDBUILD=https://cloudbuild.LOCATION.rep.googleapis.com/
Wilayah yang dibatasi untuk beberapa project
Bergantung pada penggunaan, project tertentu mungkin dibatasi untuk hanya menggunakan Cloud Build di region berikut:
us-central1
us-west2
europe-west1
asia-east1
australia-southeast1
southamerica-east1