Membuat dan mengelola kumpulan pribadi

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

Sebelum memulai

Buat project Google Cloud baru atau pilih project yang sudah ada. Anda akan menggunakan project ini untuk membuat kolam pribadi.
Aktifkan API Cloud Build.
Mengaktifkan API
Untuk menggunakan contoh command line dalam panduan ini, instal dan konfigurasi Google Cloud CLI.

Catatan: Jika sudah pernah 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 Anda dan jaringan Virtual Private Cloud tempat kumpulan pribadi berada. Untuk mengetahui petunjuknya, lihat menyiapkan lingkungan untuk membuat kumpulan pribadi.

Membuat kolam renang pribadi baru

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.

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

Konsol

Buka halaman Kumpulan Pekerja di konsol Google Cloud:

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

Anda akan melihat panel samping Buat kolam renang pribadi.

Masukkan informasi berikut untuk membuat kolam renang pribadi:
1. Nama: Masukkan nama untuk kolam renang pribadi Anda. Nilai ini hanya dapat berisi karakter alfanumerik /[a-z][0-9]/ atau tanda hubung -. Nama kolam pribadi Anda harus antara 1 dan 63 karakter.
2. Region: Pilih wilayah tempat Anda ingin membuat kolam pribadi.
3. Machine type: Pilih jenis mesin Compute Engine yang ingin digunakan untuk kumpulan pribadi Anda.
4. Ukuran disk yang tersedia: Masukkan ukuran disk untuk kolam renang pribadi Anda. Tentukan nilai yang lebih besar atau sama dengan 100 dan kurang dari atau sama dengan 1.000. Jika tidak disediakan, Cloud Build akan menggunakan ukuran disk 100.
  
  Di bagian Network type, pilih salah satu opsi berikut:
  1. Default network: Pilih opsi ini jika instance Anda dapat diakses melalui internet publik. Jika opsi Default network dipilih, kumpulan pribadi Anda akan menggunakan jaringan produsen layanan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan lingkungan untuk menggunakan kumpulan pribadi dalam 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 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 rentangnya menggunakan notasi pemilihan rute 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 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 lebih dari /29. Jika tidak ada nilai yang ditentukan untuk rentang tersebut, 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 ke rentang dalam jaringan VPC yang di-peering.
      
      Catatan: Anda hanya dapat menentukan rentang IP jika telah menentukan Jaringan. Jika Anda telah menentukan Network, rentang IP bersifat opsional.
5. Tetapkan IP eksternal: Opsi ini dipilih secara default untuk mengizinkan kumpulan pribadi mengakses internet publik. Hapus centang pada kotak ini untuk membatasi akses ke jaringan pribadi Anda.
Klik Create untuk membuat kolam renang 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.

Meneruskan file konfigurasi kumpulan pribadi ke perintah gcloud:

Buat file konfigurasi kumpulan pribadi dalam format YAML atau JSON.

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

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

Meneruskan opsi konfigurasi secara 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 perintah berikut:

PRIVATEPOOL_ID: ID unik untuk kolam renang 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 dari 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 terpasang ke kumpulan pribadi. Tentukan nilai yang lebih besar atau sama dengan 100 dan kurang dari atau sama dengan 1000. Jika tidak disediakan, Cloud Build akan menggunakan disk berukuran 100. --worker-disk-size 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 mengetahui daftar jenis mesin yang didukung, lihat Skema file konfigurasi kumpulan pribadi. --worker-machine-type diganti jika Anda menentukan jenis mesin lain menggunakan --machine-type selama gcloud builds submit.
--no-public-egress: Jika tanda ini ditetapkan, kumpulan pribadi akan dibuat tanpa alamat IP eksternal. Tetapkan flag ini jika Anda membuat kumpulan pribadi dalam perimeter Kontrol Layanan VPC.

API

Buat file konfigurasi kumpulan pribadi 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 perintah berikut:
- PRIVATEPOOL_PROJECT_ID: ID project Google Cloud tempat Anda ingin membuat kumpulan pribadi.
- PRIVATEPOOL_ID: ID untuk kumpulan objek pribadi Anda. Nilai ini harus terdiri dari 1-63 karakter, dan karakter yang valid adalah [a-zA-Z0-9_-]+.
- REGION: salah satu wilayah 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 kolam renang 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 sudah ada. Untuk memperbarui kolam renang pribadi:

Konsol

Buka halaman Kumpulan pekerja di konsol Google Cloud:

Buka halaman kumpulan pekerja Cloud Build
Pilih project tempat Anda membuat kumpulan pribadi.
Klik nama kolam renang 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 kumpulan pribadi Anda, REGION adalah region tempat kumpulan pribadi Anda berada, dan PRIVATEPOOL_CONFIG_FILE adalah nama file konfigurasi kumpulan pribadi 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 perintah berikut:

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

API

Di file konfigurasi kumpulan pribadi, perbarui ukuran disk dan/atau jenis mesin.
Gunakan cURL untuk memanggil Cloud Build API dan 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 perintah berikut:
- PRIVATEPOOL_ID: ID kolam renang pribadi Anda.
- PRIVATEPOOL_PROJECT_ID: ID project Google Cloud yang berisi kumpulan pribadi Anda.
- REGION: wilayah tempat Anda membuat kolam renang pribadi.

Melihat detail kolam renang 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 kolam renang pribadi:

Konsol

Buka halaman Kumpulan pekerja di konsol Google Cloud:

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

Panel samping Edit private pool ditampilkan, yang menampilkan detail kumpulan kolam pribadi.

gcloud

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

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 kumpulan pribadi, jalankan perintah berikut untuk mendapatkan informasi selengkapnya tentang kumpulan pribadi:

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

Ganti nilai placeholder dalam perintah di atas dengan perintah berikut:

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

API

Jika tidak tahu ID kumpulan pribadi Anda, jalankan perintah cURL berikut untuk mencantumkan detail kumpulan pribadi Anda, 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 perintah berikut:

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

Menghapus kolam renang pribadi

Untuk menghapus kolam renang pribadi:

Konsol

Buka halaman Kumpulan pekerja di konsol Google Cloud:

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

gcloud

Untuk menghapus kumpulan pribadi, 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 perintah berikut:

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

Setelah kumpulan pribadi dihapus, Anda akan melihat output seperti 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 perintah berikut:

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

Langkah selanjutnya

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