Membuat dan mengelola kumpulan node

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

Di server Distributed Cloud terhubung, 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 Anda:

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

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

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

Konsol

Jika menggunakan Google Cloud konsol, Anda hanya dapat membuat node pool saat Anda 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung target untuk node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung target.
  • ZONE_NAME: nama zona Distributed Cloud target. 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 di 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-rak, gunakan flag ini untuk menentukan rak Distributed Cloud terhubung yang nodenya terdiri dari node pool ini. Jika dihilangkan, 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 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung target untuk node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung target.
  • NODEPOOL_ID: ID programatik unik yang mengidentifikasi resource node pool ini.
  • REQUEST_ID: ID programatik 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 zona Distributed Cloud terhubung target. 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 di node pool.
  • MACHINE_FILTER (opsional): menentukan kriteria pemfilteran untuk pemilihan mesin. Hanya mesin yang cocok dengan filter ini yang diizinkan untuk bergabung dengan node pool ini. Untuk cluster multi-rak, gunakan flag ini untuk menentukan rak Distributed Cloud terhubung yang nodenya terdiri dari node pool ini. Jika dihilangkan, 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 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 node pool Distributed Cloud yang tersedia di zona Distributed Cloud terhubung, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di Google Cloud project 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung target telah dibuat. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung target telah dibuat. Google Cloud
  • 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 node pool

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

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di Google Cloud project 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung 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 Edge Container Admin (roles/edgecontainer.admin) di Google Cloud project 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung 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. Untuk cluster multi-rak, gunakan flag ini untuk menentukan rak Distributed Cloud terhubung 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 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung target.
  • NODEPOOL_ID: ID programatik unik yang mengidentifikasi node pool ini.
  • REQUEST_ID: ID programatik 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 zona Distributed Cloud terhubung target. 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 dengan node pool ini. Untuk cluster multi-rak, gunakan flag ini untuk menentukan rak Distributed Cloud terhubung yang nodenya terdiri dari 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 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 Edge Container Admin (roles/edgecontainer.admin) di Google Cloud project 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung 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 target Google Cloud .
  • REGION: region tempat cluster Distributed Cloud terhubung yang terkait dengan node pool ini dihosting. Google Cloud
  • CLUSTER_NAME: nama cluster Distributed Cloud terhubung target.
  • POOL_NAME: nama node pool target.
  • REQUEST_ID: ID programatik unik yang mengidentifikasi permintaan ini.

Langkah berikutnya