Membuat dan mengelola kumpulan pribadi

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

Sebelum memulai

  1. Buat project baru Google Cloud atau pilih project yang sudah ada. Anda akan menggunakan project ini untuk membuat pool pribadi.

  2. Enable the Cloud Build API.

    Enable the API

  3. Untuk menggunakan contoh command line dalam panduan ini, instal dan konfigurasi Google Cloud CLI.

  4. Opsional: Agar build dapat mengakses resource pribadi dari jaringan Virtual Private Cloud Anda, 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 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 Mengonfigurasi akses ke resource Cloud Build.

Untuk membuat kumpulan pribadi baru:

Konsol

  1. Buka halaman Worker Pool di konsol Google Cloud :

    Buka halaman kumpulan pekerja Cloud Build

  2. Pilih project tempat Anda ingin membuat kumpulan pribadi.

  3. Di halaman Worker pool, klik Create.

    Anda akan melihat panel samping Buat pool pribadi.

    Masukkan informasi berikut untuk membuat pool pribadi Anda:

    1. Nama: Masukkan nama untuk pool pribadi Anda. Nilai ini hanya boleh berisi karakter alfanumerik /[a-z][0-9]/ atau tanda hubung -. Nama kumpulan pribadi Anda harus terdiri dari 1 hingga 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 kumpulan pribadi.

    4. Ukuran disk yang tersedia: Masukkan ukuran disk untuk kumpulan pribadi Anda. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4000. 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 menggunakan internet publik. Jika opsi Jaringan default dipilih, pool 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 oleh 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 rentang IP digunakan sebagai subnet mask (192.0.2.0), sedangkan rentang alamat host yang mungkin adalah dari 192.0.2.0 hingga 192.0.2.255.

          Nilai panjang awalan 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 diberi rentang dalam jaringan VPC yang di-peering.

    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.

  4. Klik Buat untuk membuat pool pribadi Anda.

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 pool pribadi ke perintah gcloud:

  1. Buat file konfigurasi kumpulan pribadi dalam format YAML atau JSON.

  2. 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

Meneruskan 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

Dengan:

  • PRIVATEPOOL_ID: ID unik untuk pool pribadi Anda. Nilai ini harus terdiri dari 1-63 karakter, dan karakter yang valid adalah [a-zA-Z0-9_-]+.
  • PRIVATEPOOL_PROJECT_ID: ID Google Cloud project 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 memiliki 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 pool pribadi. Tentukan nilai yang lebih besar dari atau sama dengan 100 dan kurang dari atau sama dengan 4000. 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 mengetahui 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 disetel, kumpulan pribadi akan dibuat tanpa alamat IP eksternal. Tetapkan tanda ini jika Anda membuat kumpulan pribadi dalam perimeter Kontrol Layanan VPC.

API

  1. Buat file konfigurasi kumpulan pribadi bernama workerpool.json.

  2. 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

    Dengan:

    • PRIVATEPOOL_PROJECT_ID: ID Google Cloud project tempat Anda ingin membuat kumpulan pribadi.
    • PRIVATEPOOL_ID: ID untuk pool 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 pool pribadi yang ada. Untuk memperbarui pool pribadi:

Konsol

  1. Buka halaman Worker pool di konsol Google Cloud :

    Buka halaman kumpulan pekerja Cloud Build

  2. Pilih project tempat Anda membuat pool pribadi.

  3. Klik nama kumpulan pribadi.

  4. Jika perlu, di panel samping Edit pool pribadi, perbarui jenis mesin dan ukuran disk.

  5. Klik Simpan.

gcloud

Dengan memperbarui file konfigurasi kumpulan pribadi:

  1. Perbarui kolom yang perlu diubah di file konfigurasi pool pribadi.

  2. Jalankan perintah berikut, dengan PRIVATEPOOL_ID adalah ID unik untuk pool pribadi Anda, REGION adalah region tempat pool pribadi Anda berada, dan PRIVATEPOOL_CONFIG_FILE adalah nama file konfigurasi pool pribadi Anda:

    gcloud builds worker-pools update PRIVATEPOOL_ID \
    --region=REGION \
    --config-from-file=PRIVATEPOOL_CONFIG_FILE

Dengan meneruskan nilai yang akan diupdate 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 nilai berikut:

  • PRIVATEPOOL_ID: ID pool pribadi yang ada. Anda tidak dapat memperbarui nilai ini; Anda harus menentukan ID pool 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

  1. Di file konfigurasi kumpulan pribadi, perbarui ukuran disk dan/atau jenis mesin.

  2. 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

    Dengan:

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

Melihat detail pool 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

  1. Buka halaman Worker pool di konsol Google Cloud :

    Buka halaman kumpulan pekerja Cloud Build

  2. Pilih project tempat Anda membuat kumpulan pribadi

  3. Klik nama kumpulan pribadi.

Panel samping Edit pool pribadi ditampilkan, yang berisi detail pool pribadi.

gcloud

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

gcloud builds worker-pools list --region=REGION --project=PRIVATEPOOL_PROJECT_ID

Dengan:

  • PRIVATEPOOL_PROJECT_ID adalah ID Google Cloud project yang berisi kumpulan pribadi.
  • REGION adalah region pool 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

Dengan:

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

API

Jika Anda tidak mengetahui ID pool pribadi, jalankan perintah cURL berikut untuk mencantumkan detail pool pribadi Anda, dengan PRIVATEPOOL_PROJECT_ID adalah ID project Google Cloud yang berisi pool 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 pool pribadi, jalankan perintah cURL berikut untuk mendapatkan detail pool pribadi Anda:

    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 nilai berikut:

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

Menghapus pool 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

  1. Buka halaman Worker pool di konsol Google Cloud :

    Buka halaman kumpulan pekerja Cloud Build

  2. Di baris dengan kumpulan pribadi Anda, klik ikon tempat sampah.

gcloud

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

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

Dengan:

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

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

 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

Dengan:

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

Langkah berikutnya