Membuat dan mengelola kumpulan node

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

Node pool dibuat dan diisi secara otomatis saat Anda membuat cluster. Anda juga memiliki opsi untuk mengonfigurasi node pool tambahan setelah membuat cluster.

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

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 yang terhubung ke Distributed Cloud yang akan ditetapkan ke kumpulan node ini jika project tersebut berbeda dengan project Google 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 \
    --node-storage-schema=WORKER_NODE_STORAGE_SCHEMA

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 yang terhubung target untuk node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.
  • 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. Untuk cluster multi-rack, gunakan tanda ini untuk menentukan rak yang terhubung ke Distributed Cloud yang nodenya terdiri dari node pool ini. Jika tidak disertakan, semua node yang tersedia di zona akan ditambahkan 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

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

  • WORKER_NODE_STORAGE_SCHEMA (opsional): menentukan skema penyimpanan lokal untuk node pekerja yang disertakan dalam node pool ini. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi skema 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 yang terhubung target untuk node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.
  • 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 yang terhubung 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. Untuk cluster multi-rak, gunakan tanda ini untuk menentukan rak Distributed Cloud Connected yang nodenya membentuk kumpulan node ini. Jika tidak disertakan, semua node yang tersedia di zona akan ditambahkan 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 yang terhubung 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 kumpulan node Distributed Cloud yang tersedia di zona yang terhubung ke 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: region Google Cloud tempat cluster Distributed Cloud terhubung target dibuat.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.

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: region Google Cloud tempat cluster yang terhubung ke 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: region Google Cloud tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.

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: region Google Cloud tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.
  • 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 \
    --local-disk-kms-key=POOL_KMS_KEY

Ganti kode berikut:

  • POOL_NAME: nama node pool target.
  • PROJECT_ID: ID project Google Cloud target.
  • REGION: region Google Cloud tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama cluster target Distributed Cloud Connected.
  • 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. Untuk cluster multi-rack, gunakan tanda ini untuk menentukan rack yang terhubung Distributed Cloud yang nodenya terdiri dari 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 yang terhubung dengan Cloud Key Management Service seperti yang dijelaskan dalam Mengaktifkan dukungan untuk kunci enkripsi yang dikelola pelanggan (CMEK) untuk penyimpanan lokal.

    Untuk mengembalikan node pool agar menggunakan Google-owned and Google-managed encryption key, gunakan flag --use-google-managed-key.

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: region Google Cloud tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.
  • 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 yang terhubung 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. Untuk cluster multi-rak, gunakan tanda ini untuk menentukan rak Distributed Cloud Connected yang nodenya membentuk kumpulan node 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 yang terhubung 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: region Google Cloud tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.

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: region Google Cloud tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting.
  • CLUSTER_NAME: nama target cluster yang terhubung Distributed Cloud.
  • POOL_NAME: nama node pool target.
  • REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.

Langkah berikutnya