Membuat dan mengelola kumpulan node

Halaman ini menjelaskan cara membuat dan mengelola resource kumpulan node Google Distributed Cloud di zona Distributed Cloud.

Di Distributed Cloud Servers, node pool dibuat dan diisi secara otomatis saat Anda membuat cluster. Anda juga memiliki opsi untuk mengonfigurasi kumpulan node tambahan setelah membuat cluster.

Untuk mengetahui informasi selengkapnya tentang node pool Distributed Cloud, lihat Cara kerja Distributed Cloud.

Membuat node pool

Untuk membuat node pool Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran berikut di Google Cloud project:

  • Peran Edge Container Admin (roles/edgecontainer.admin)

  • Peran Edge Container Machine User (roles/edgecontainer.machineUser)

    Anda juga harus memiliki peran ini di project Google Cloud yang berisi mesin Distributed Cloud yang akan ditetapkan ke kumpulan node ini jika project tersebut berbeda dengan projectGoogle Cloud tempat Anda membuat kumpulan node.

Konsol

Jika menggunakan konsol Google Cloud , Anda hanya dapat membuat node pool saat membuat cluster. Untuk membuat node pool mandiri, Anda harus menggunakan Google Cloud CLI atau Distributed Cloud Edge Container API.

gcloud

Gunakan perintah gcloud edge-cloud container clusters node-pools create:

gcloud edge-cloud container clusters node-pools create POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-location=ZONE_NAME \
    --node-count=NODE_COUNT \
    --node-labels=NODE_LABELS \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY

Ganti kode berikut:

  • POOL_NAME: nama deskriptif yang secara unik mengidentifikasi node pool ini. Nama ini harus sesuai dengan RFC 1213 dan hanya terdiri dari karakter alfanumerik huruf kecil dan tanda hubung (-). Nama ini harus diawali dan diakhiri dengan karakter alfanumerik.
  • PROJECT_ID: ID project Google Cloud target.
  • REGION: region Google Cloud tempat cluster Distributed Cloud target untuk node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • ZONE_NAME: nama target zona Distributed Cloud. Zona ini harus berada di region yang ditentukan dalam REGION.
  • NODE_COUNT: jumlah node yang dimiliki node pool ini.
  • NODE_LABELS: daftar pasangan nilai kunci yang dipisahkan koma yang terdiri dari label untuk setiap node dalam node pool.
  • MACHINE_FILTER (opsional): menentukan kriteria pemfilteran untuk pemilihan mesin. Untuk melihat kolom yang dapat Anda gunakan untuk memfilter, lihat Mendapatkan informasi tentang mesin. Hanya mesin yang cocok dengan filter ini yang diizinkan untuk bergabung dengan node pool ini.

  • POOL_KMS_KEY (opsional): jalur lengkap ke kunci Cloud KMS yang ingin Anda gunakan dengan node pool ini. Contoh:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Flag ini hanya berlaku jika Anda telah mengintegrasikan Distributed Cloud dengan Cloud Key Management Service seperti yang dijelaskan dalam Mengaktifkan dukungan untuk kunci enkripsi yang dikelola pelanggan (CMEK) untuk penyimpanan lokal.

API

Buat permintaan POST ke metode projects.locations.clusters.nodePools.create:

POST /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "nodeLabels": NODE_LABELS,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": POOL_KMS_KEY,
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: region Google Cloud tempat cluster Distributed Cloud target untuk node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • NODEPOOL_ID: ID terprogram unik yang mengidentifikasi resource node pool ini.
  • REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.
  • POOL_NAME: nama deskriptif yang secara unik mengidentifikasi node pool ini.
  • LABELS: daftar label yang akan diterapkan ke resource node pool ini.
  • ZONE_NAME: nama target zona Distributed Cloud. Zona ini harus berada di region yang ditentukan dalam REGION.
  • NODE_COUNT: jumlah node yang dimiliki node pool ini.
  • NODE_LABELS: daftar pasangan nilai kunci yang dipisahkan koma yang terdiri dari label untuk setiap node dalam node pool.
  • MACHINE_FILTER (opsional): menentukan kriteria pemfilteran untuk pemilihan mesin. Hanya mesin yang cocok dengan filter ini yang diizinkan untuk bergabung ke node pool ini.

  • POOL_KMS_KEY (opsional): jalur lengkap ke kunci Cloud KMS yang ingin Anda gunakan dengan node pool ini. Contoh:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Parameter ini hanya berlaku jika Anda telah mengintegrasikan Distributed Cloud dengan Cloud Key Management Service seperti yang dijelaskan dalam Mengaktifkan dukungan untuk kunci enkripsi yang dikelola pelanggan (CMEK) untuk penyimpanan lokal.

Mencantumkan kumpulan node

Untuk mencantumkan node pool Distributed Cloud yang tersedia di zona Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters node-pools list:

gcloud edge-cloud container clusters node-pools list \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.

API

Buat permintaan GET ke metode projects.locations.clusters.nodePools.list:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • FILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.
  • PAGE_SIZE: jumlah hasil yang akan ditampilkan per halaman.
  • SORT_BY: daftar nama kolom yang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Urutan pengurutan default adalah menaik; untuk urutan pengurutan menurun, beri awalan kolom yang diinginkan dengan ~.
  • PAGE_TOKEN: token yang diterima dalam respons terhadap permintaan daftar terakhir di kolom nextPageToken dalam respons. Kirim token ini untuk menerima halaman hasil.

Mendapatkan informasi tentang kumpulan node

Untuk mendapatkan informasi tentang kumpulan node Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters node-pools describe:

gcloud edge-cloud container clusters node-pools describe POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Ganti kode berikut:

  • POOL_NAME: nama node pool target.
  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.

API

Buat permintaan GET ke metode projects.locations.clusters.nodePools.get:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • POOL_NAME: nama node pool target.

Mengubah node pool

Untuk mengubah node pool Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters node-pools update:

gcloud edge-cloud container clusters node-pools update POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-count=NODE_COUNT \
    --machine-filter=MACHINE_FILTER

Ganti kode berikut:

  • POOL_NAME: nama node pool target.
  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • NODE_COUNT: jumlah node yang dimiliki node pool ini.
  • MACHINE_FILTER (opsional): menentukan kriteria pemfilteran untuk pemilihan mesin. Untuk melihat kolom yang dapat Anda gunakan untuk memfilter, lihat Mendapatkan informasi tentang mesin.

API

Buat permintaan PATCH ke metode projects.locations.clusters.nodePools.patch:

PATCH /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": KMS_KEY,
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • NODEPOOL_ID: ID terprogram unik yang mengidentifikasi node pool ini.
  • REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.
  • POOL_NAME: nama deskriptif yang secara unik mengidentifikasi node pool ini.
  • LABELS: daftar label yang akan diterapkan ke resource node pool ini.
  • ZONE_NAME: nama target zona Distributed Cloud. Zona ini harus berada di region yang ditentukan dalam REGION.
  • NODE_COUNT: jumlah node yang dimiliki node pool ini.
  • MACHINE_FILTER (opsional): menentukan kriteria pemfilteran untuk pemilihan mesin. Hanya mesin yang cocok dengan filter ini yang diizinkan untuk bergabung ke node pool ini.

  • KMS_KEY (opsional): jalur lengkap ke kunci Cloud KMS yang ingin Anda gunakan dengan node pool ini. Contoh:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    Parameter ini hanya berlaku jika Anda telah mengintegrasikan Distributed Cloud dengan Cloud Key Management Service seperti yang dijelaskan dalam Mengaktifkan dukungan untuk kunci enkripsi yang dikelola pelanggan (CMEK) untuk penyimpanan lokal.

Menghapus node pool

Untuk menghapus node pool Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters node-pools delete:

gcloud edge-cloud container clusters node-pools delete POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Ganti kode berikut:

  • POOL_NAME: nama node pool target.
  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.

API

Buat permintaan DELETE ke metode projects.locations.clusters.nodePools.delete:

DELETE /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME?requestId=REQUEST_ID

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat cluster Distributed Cloud yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster Distributed Cloud target.
  • POOL_NAME: nama node pool target.
  • REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.

Langkah berikutnya