Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat dan mengelola kumpulan pribadi

Halaman ini menjelaskan cara membuat, mengupdate, melihat, dan menghapus kumpulan pribadi Cloud Build. Jika Anda belum terbiasa dengan kolam renang pribadi, baca Ringkasan kolam renang pribadi.

Sebelum memulai

Buat project Google Cloud baru atau pilih project yang sudah ada. Anda akan menggunakan project ini untuk membuat kumpulan pribadi.
Enable the Cloud Build API.
Enable the API
Untuk menggunakan contoh command line dalam panduan ini, instal dan konfigurasikan Google Cloud CLI.

Catatan: Jika sebelumnya Anda telah menginstal gcloud CLI, pastikan Anda memiliki versi terbaru yang tersedia dengan menjalankan gcloud components update.
[Opsional] Agar build dapat mengakses resource pribadi dari jaringan Virtual Private Cloud, Anda harus menyiapkan koneksi peering antara jaringan Virtual Private Cloud dan jaringan Virtual Private Cloud tempat kumpulan pribadi berada. Untuk mengetahui petunjuknya, lihat menyiapkan lingkungan untuk membuat pool pribadi.

Membuat kumpulan pribadi baru

Izin IAM: Anda memerlukan peran Cloud Build WorkerPool Owner untuk melakukan tugas ini. Untuk mengetahui petunjuk tentang cara memberikan peran ini, lihat artikel Mengonfigurasi akses ke resource Cloud Build.

Anda dapat membuat maksimal 10 kumpulan pribadi per project Google Cloud per region. Untuk membuat kumpulan pribadi baru:

Konsol

Buka halaman Worker Pool di konsol Google Cloud:

Buka halaman kumpulan pekerja Cloud Build
Pilih project tempat Anda ingin membuat kumpulan pribadi.
Di halaman Worker pool, klik Create.

Anda akan melihat panel samping Create private pool.

Masukkan informasi berikut untuk membuat pool pribadi:
1. Nama: Masukkan nama untuk kumpulan pribadi Anda. Nilai ini hanya boleh berisi karakter alfanumerik /[a-z][0-9]/ atau tanda hubung -. Nama kumpulan pribadi Anda harus antara 1 dan 63 karakter.
2. Region: Pilih region tempat Anda ingin membuat kumpulan pribadi.
3. Jenis mesin: Pilih jenis mesin Compute Engine yang ingin Anda gunakan untuk node pool pribadi.
4. Available disk size: Masukkan ukuran disk untuk kumpulan pribadi Anda. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4.000. Jika tidak diberikan, Cloud Build akan menggunakan ukuran disk 100.
  
  Di bagian Network type, pilih salah satu opsi berikut:
  1. Jaringan default: Pilih opsi ini jika instance Anda dapat diakses melalui internet publik. Jika opsi Jaringan default dipilih, kumpulan pribadi Anda akan menggunakan jaringan produsen layanan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan lingkungan untuk menggunakan kumpulan pribadi di jaringan VPC.
  2. Jaringan pribadi: Pilih opsi ini jika instance Anda dihosting di jaringan pribadi.
    1. Project: Pilih project ID Google Cloud Anda.
    2. Jaringan: Pilih jaringan Anda dari menu drop-down. Jika Anda belum membuat jaringan, lihat Membuat dan mengelola jaringan VPC untuk mempelajari cara membuat jaringan.
    3. Rentang IP: Masukkan rentang IP internal yang dapat digunakan jaringan produsen Cloud Build untuk dialokasikan ke VM yang mempertahankan koneksi dengan repositori pribadi.
      
      Anda dapat menentukan rentang menggunakan notasi perutean Classless Inter-Domain Routing (CIDR) dalam format STARTING_IP_ADDRESS/SUBNET_PREFIX_SIZE. Misalnya, 192.0.2.0/24 memiliki panjang awalan 24. 24 bit pertama dari rentang IP digunakan sebagai subnet mask (192.0.2.0), sedangkan kemungkinan alamat host berkisar dari 192.0.2.0 hingga 192.0.2.255.
      
      Nilai panjang awalan Anda tidak boleh melebihi /29. Jika tidak ada nilai yang ditentukan untuk rentang, nilai default /24 akan otomatis ditetapkan. Jika tidak ada nilai yang ditentukan untuk panjang awalan, alamat IP akan otomatis ditetapkan dalam jaringan VPC yang di-peering. Jika tidak ada nilai yang ditentukan untuk alamat IP, alamat IP akan otomatis ditetapkan rentangnya dalam jaringan VPC yang dihubungkan.
      
      Catatan: Anda hanya dapat menentukan rentang IP jika telah menentukan Jaringan. Jika Anda telah menentukan Jaringan, rentang IP bersifat opsional.
5. Tetapkan IP eksternal: Opsi ini dipilih secara default untuk mengizinkan kumpulan pribadi mengakses internet publik. Hapus centang kotak ini untuk membatasi akses ke jaringan pribadi Anda.
Klik Create untuk membuat kumpulan pribadi.

gcloud

Anda memiliki dua opsi untuk membuat kumpulan pribadi baru menggunakan gcloud: Anda dapat meneruskan file konfigurasi kumpulan pribadi ke perintah gcloud, atau meneruskan opsi konfigurasi langsung ke perintah gcloud.

Teruskan file konfigurasi kumpulan pribadi ke perintah gcloud:

Buat file konfigurasi kumpulan pribadi dalam format YAML atau JSON.

Jalankan perintah gcloud berikut, dengan PRIVATEPOOL_ID adalah ID unik untuk private pool Anda, PRIVATEPOOL_CONFIG_FILE adalah nama file konfigurasi private pool Anda, dan REGION adalah region tempat Anda ingin membuat private pool:

gcloud builds worker-pools create PRIVATEPOOL_ID --config-from-file PRIVATEPOOL_CONFIG_FILE --region REGION

Anda akan melihat output yang mirip dengan berikut ini:

Created [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/private-pool].
NAME                 CREATE_TIME                STATUS
private-pool  2018-11-19T16:08:24+00:00  RUNNING

Menyerahkan opsi konfigurasi langsung ke perintah gcloud:

Jalankan perintah gcloud berikut:

    gcloud builds worker-pools create PRIVATEPOOL_ID \
        --project=PRIVATEPOOL_PROJECT_ID \
        --region=REGION \
        --peered-network=PEERED_NETWORK \
        --worker-machine-type=PRIVATEPOOL_MACHINE_TYPE \
        --worker-disk-size=PRIVATEPOOL_DISK_SIZE_GB \
        --no-public-egress

Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:

PRIVATEPOOL_ID: ID unik untuk kumpulan pribadi Anda. Nilai ini harus terdiri dari 1-63 karakter, dan karakter yang valid adalah [a-zA-Z0-9_-]+.
PRIVATEPOOL_PROJECT_ID: ID project Google Cloud tempat Anda ingin membuat kumpulan pribadi.
REGION: salah satu wilayah yang didukung.
PEERED_NETWORK: URL resource jaringan jaringan yang di-peering ke jaringan produsen layanan. PEERED_NETWORK harus dalam format projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, dengan NETWORK_PROJECT_ID adalah project ID project Google Cloud yang menyimpan jaringan VPC Anda dan NETWORK_NAME adalah nama jaringan VPC Anda. Jika Anda tidak menentukan nilai, Cloud Build akan menggunakan jaringan penyedia layanan.
PRIVATEPOOL_DISK_SIZE_GB: ukuran disk yang dilampirkan ke pool pribadi. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4.000. Jika tidak diberikan, Cloud Build akan menggunakan ukuran disk 100. --worker-disk-size akan diganti jika Anda menentukan ukuran disk yang berbeda menggunakan --disk-size selama gcloud builds submit.
PRIVATEPOOL_MACHINE_TYPE: jenis mesin pekerja. Jika dibiarkan kosong, Cloud Build akan menggunakan nilai default e2-standard-2. Untuk daftar jenis mesin yang didukung, lihat Skema file konfigurasi kumpulan pribadi. --worker-machine-type akan diganti jika Anda menentukan jenis mesin yang berbeda menggunakan --machine-type selama gcloud builds submit.
--no-public-egress: Jika tanda ini ditetapkan, kumpulan pribadi akan dibuat tanpa alamat IP eksternal. Tetapkan tanda ini jika Anda membuat kumpulan pribadi dalam perimeter Kontrol Layanan VPC.

API

Buat file konfigurasi kumpulan pribadi Anda bernama workerpool.json.
Gunakan cURL untuk memanggil Cloud Build API:
```
    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -H "Content-Type: application/json" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/?workerPoolId=PRIVATEPOOL_ID -d @workerpool.json
```
Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:
- PRIVATEPOOL_PROJECT_ID: ID project Google Cloud tempat Anda ingin membuat kumpulan pribadi.
- PRIVATEPOOL_ID: ID untuk kumpulan data pribadi Anda. Nilai ini harus terdiri dari 1-63 karakter, dan karakter yang valid adalah [a-zA-Z0-9_-]+.
- REGION: salah satu region yang didukung untuk membuat kumpulan pribadi Anda.

Membuat kumpulan pribadi dalam perimeter Kontrol Layanan VPC

Jika Anda membuat kumpulan pribadi dalam perimeter Kontrol Layanan VPC, lihat Menggunakan Kontrol Layanan VPC.

Memperbarui kumpulan pribadi

Izin IAM: Anda memerlukan peran Cloud Build WorkerPool Editor untuk melakukan tugas ini. Untuk mengetahui petunjuk tentang cara memberikan peran ini, lihat Mengonfigurasi akses ke resource Cloud Build.

Anda dapat memperbarui ukuran disk dan jenis mesin dari kumpulan pribadi yang ada. Untuk memperbarui kumpulan pribadi:

Konsol

Buka halaman Worker pool di konsol Google Cloud:

Buka halaman kumpulan pekerja Cloud Build
Pilih project tempat Anda membuat kumpulan pribadi.
Klik nama kumpulan pribadi.
Di panel samping Edit private pool, perbarui jenis mesin dan/atau ukuran disk.
Klik Simpan.

gcloud

Dengan memperbarui file konfigurasi kumpulan pribadi:

Perbarui kolom yang ingin diubah di file konfigurasi kumpulan pribadi.
Jalankan perintah berikut, dengan PRIVATEPOOL_ID adalah ID unik untuk private pool Anda, REGION adalah region tempat private pool Anda berada, dan PRIVATEPOOL_CONFIG_FILE adalah nama file konfigurasi private pool Anda:
```
gcloud builds worker-pools update PRIVATEPOOL_ID \
    --region=REGION \
    --config-from-file=PRIVATEPOOL_CONFIG_FILE
```

Dengan meneruskan nilai yang akan diperbarui langsung ke perintah gcloud builds worker-pools update:

   gcloud builds worker-pools update PRIVATEPOOL_ID  \
       --region=REGION \
       --worker-disk-size=PRIVATEPOOL_DISK_SIZE \
       --worker-machine-type=PRIVATEPOOL_MACHINE_TYPE

Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:

PRIVATEPOOL_ID: ID kumpulan pribadi yang ada. Anda tidak dapat memperbarui nilai ini; Anda harus menentukan ID kumpulan pribadi yang ada.
REGION: region tempat Anda membuat kumpulan pribadi.
PRIVATEPOOL_DISK_SIZE: ukuran disk yang diperbarui.
PRIVATEPOOL_MACHINE_TYPE adalah jenis mesin yang diperbarui.

API

Di file konfigurasi kumpulan pribadi, perbarui ukuran disk dan/atau jenis mesin.
Gunakan cURL untuk memanggil Cloud Build API, dengan mengganti variabel dengan nilai yang sesuai:
```
curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID \
    -d @workerpool.json
```
Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:
- PRIVATEPOOL_ID: ID kumpulan pribadi Anda.
- PRIVATEPOOL_PROJECT_ID: ID project Google Cloud yang berisi kumpulan pribadi Anda.
- REGION: region tempat Anda membuat kumpulan pribadi.

Melihat detail kumpulan data pribadi Anda

Izin IAM: Anda memerlukan peran Cloud Build WorkerPool Viewer untuk melakukan tugas ini. Untuk mengetahui petunjuk tentang cara memberikan peran ini, lihat Mengonfigurasi akses ke resource Cloud Build.

Untuk melihat detail pool pribadi:

Konsol

Buka halaman Worker pool di konsol Google Cloud:

Buka halaman kumpulan pekerja Cloud Build
Pilih project tempat Anda membuat kumpulan pribadi
Klik nama kumpulan pribadi.

Panel samping Edit private pool akan ditampilkan, yang berisi detail private pool.

gcloud

Jika Anda tidak mengetahui ID kumpulan pribadi, jalankan perintah berikut untuk mencantumkan detail kumpulan pribadi:

gcloud builds worker-pools list --project=PRIVATEPOOL_PROJECT_ID

dengan PRIVATEPOOL_PROJECT_ID adalah ID project Google Cloud yang berisi kumpulan pribadi.

Anda akan melihat output yang mirip dengan berikut ini:

NAME                                                                  CREATE_TIME                STATUS
projects/[PRIVATEPOOL_PROJECT_ID]/locations/us-central1/workerPools/[PRIVATEPOOL_ID]      2018-11-19T16:08:24+00:00  RUNNING

Jika Anda mengetahui ID pool pribadi, jalankan perintah berikut untuk mendapatkan informasi selengkapnya tentang pool pribadi:

gcloud builds worker-pools describe PRIVATEPOOL_ID \
    --region=REGION \
    --project=PRIVATEPOOL_PROJECT_ID

Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:

PRIVATEPOOL_ID: ID kumpulan pribadi Anda.
REGION: region tempat Anda membuat kumpulan pribadi.
PRIVATEPOOL_PROJECT_ID: ID project Google Cloud yang berisi kumpulan pribadi Anda.

API

Jika Anda tidak mengetahui ID kumpulan pribadi, jalankan perintah cURL berikut untuk mencantumkan detail kumpulan pribadi, dengan PRIVATEPOOL_PROJECT_ID adalah ID project Google Cloud yang berisi kumpulan pribadi:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools

Jika Anda mengetahui ID kumpulan pribadi, jalankan perintah cURL berikut untuk mendapatkan detail kumpulan pribadi:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:

PRIVATEPOOL_ID: ID kumpulan pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID project Google Cloud yang berisi kumpulan pribadi Anda.
REGION: region tempat Anda membuat kumpulan pribadi.

Menghapus kumpulan pribadi

Izin IAM: Anda memerlukan peran Cloud Build WorkerPool Owner untuk melakukan tugas ini. Untuk mengetahui petunjuk tentang cara memberikan peran ini, lihat Mengonfigurasi akses ke resource Cloud Build.

Untuk menghapus kumpulan pribadi:

Konsol

Buka halaman Worker pool di konsol Google Cloud:

Buka halaman kumpulan pekerja Cloud Build
Di baris dengan kumpulan pribadi Anda, klik ikon tempat sampah.

gcloud

Untuk menghapus private pool, jalankan perintah gcloud builds worker-pools delete:

 gcloud builds worker-pools delete PRIVATEPOOL_ID \
     --region=REGION \
     --project=PRIVATEPOOL_PROJECT_ID

Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:

PRIVATEPOOL_ID: ID kumpulan pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID project Google Cloud yang berisi kumpulan pribadi Anda.
REGION: region tempat Anda membuat kumpulan pribadi.

Setelah kumpulan pribadi dihapus, Anda akan melihat output yang mirip dengan berikut:

 Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[PRIVATEPOOL_ID].

API

Gunakan cURL untuk memanggil Cloud Build API:

  curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Ganti nilai placeholder dalam perintah di atas dengan yang berikut ini:

PRIVATEPOOL_ID: ID kumpulan pribadi Anda.
PRIVATEPOOL_PROJECT_ID: ID project Google Cloud yang berisi kumpulan pribadi Anda.
REGION: region tempat Anda membuat kumpulan pribadi.

Langkah selanjutnya

Pelajari cara menjalankan build di kumpulan pribadi.
Pelajari cara menggunakan Kontrol Layanan VPC dengan kumpulan pribadi.