Membuat dan mengelola label node pool dan cluster

Halaman ini menyediakan ringkasan label cluster dan label node pool di Google Kubernetes Engine (GKE).

Label node pool dan cluster GKE serta label Kubernetes

Label cluster GKE dan node pool berbeda dengan label di Kubernetes. Kedua sistem pelabelan bekerja secara independen dan tidak mewarisi atau berbagi label.

Label cluster GKE dan node pool adalah metadata arbitrer yang dilampirkan ke resource Anda, yang dapat digunakan untuk melacak informasi penggunaan dan penagihan.

Secara terpisah, di Kubernetes, sistem menggunakan label secara internal untuk mengaitkan komponen cluster dan resource (misalnya, Pod dan node) satu sama lain dan mengelola siklus proses resource. Anda dapat mengedit label Kubernetes dengan Kubernetes API. Anda juga dapat menggunakan GKE API untuk mengedit label Kubernetes pada node Anda dengan pembuatan cluster atau dengan update cluster.

Apa itu label cluster?

Label cluster adalah pasangan nilai kunci yang dapat Anda tetapkan ke cluster Google Cloud. Label membantu Anda mengatur resource ini dan mengelola biaya dalam skala besar, dengan perincian yang Anda butuhkan. Anda dapat melampirkan label ke setiap resource, lalu memfilter resource berdasarkan labelnya. Informasi tentang label diteruskan ke sistem penagihan, yang memungkinkan Anda mengelompokkan tagihan menurut label. Dengan laporan penagihan bawaan, Anda dapat memfilter dan mengelompokkan biaya berdasarkan label resource. Anda juga dapat menggunakan label untuk membuat kueri ekspor data penagihan.

Persyaratan untuk label cluster

Label cluster yang diterapkan ke resource harus memenuhi persyaratan berikut:

• Setiap resource dapat memiliki hingga 64 label cluster.
• Setiap label cluster harus berupa pasangan nilai kunci.
• Kunci memiliki panjang minimum 1 karakter dan panjang maksimum 63 karakter, serta tidak boleh kosong. Nilai boleh kosong dan memiliki panjang maksimum 63 karakter.
• Kunci dan nilai hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda pisah. Semua karakter harus menggunakan encoding UTF-8, dan boleh menggunakan karakter internasional. Kunci harus diawali dengan huruf kecil atau karakter internasional.
• Bagian kunci dari label cluster harus unik dalam satu resource. Namun, Anda dapat menggunakan kunci yang sama dengan beberapa resource.

Batasan ini berlaku untuk kunci dan nilai untuk setiap label cluster, serta untuk setiap resource Google Cloud yang memiliki label cluster. Tidak ada batasan jumlah label cluster yang dapat Anda terapkan di semua resource dalam sebuah project.

Penggunaan umum label cluster

Berikut adalah beberapa kasus penggunaan umum untuk label cluster:

• Label cluster pusat biaya atau tim: Tambahkan label berdasarkan tim atau pusat biaya untuk membedakan cluster yang dimiliki oleh tim yang berbeda (misalnya, team:research dan team:analytics). Anda dapat menggunakan jenis label ini untuk akuntansi atau penganggaran biaya.

• Label cluster komponen: Misalnya, component:redis, component:frontend, component:ingest, dan component:dashboard.

• Label cluster lingkungan atau tahap: Misalnya, environment:production dan environment:test.

• Label cluster status: Misalnya, state:active, state:readytodelete, dan state:archive.

• Label cluster kepemilikan: Digunakan untuk mengidentifikasi tim yang bertanggung jawab atas operasi, misalnya: team:shopping-cart.

• Perincian penagihan: Gunakan label node pool untuk mengelompokkan biaya yang ditagih berdasarkan node pool. Untuk informasi lebih lanjut, baca bagian Melihat perincian mendetail tentang biaya cluster.

Sebaiknya jangan membuat label unik dalam jumlah besar, seperti untuk stempel waktu atau nilai individual untuk setiap panggilan API. Masalah dari pendekatan ini adalah ketika nilai sering berubah atau dengan kunci yang mengacaukan katalog, ini akan menyulitkan pemfilteran dan pelaporan resource secara efektif.

Label dan tag

Label dapat digunakan sebagai anotasi yang dapat dikueri untuk resource, tetapi tidak dapat digunakan untuk menetapkan kondisi pada kebijakan. Tag menyediakan cara untuk mengizinkan atau menolak kebijakan secara bersyarat berdasarkan apakah resource memiliki tag tertentu, dengan memberikan kontrol terperinci atas kebijakan. Untuk informasi selengkapnya, lihat Ringkasan tag.

Label yang diterapkan secara otomatis

GKE secara otomatis menerapkan beberapa label ke resource cluster.

Misalnya, GKE menerapkan label ke instance Compute Engine, persistent disk, dan akselerator (TPU).

Tabel berikut mencantumkan label yang otomatis diterapkan GKE ke resource:

Jangan mengedit atau menghapus label yang dicadangkan. Setiap perubahan yang Anda buat pada label yang dicadangkan akan direkonsiliasi secara otomatis.

Penyebaran label

Di GKE, Anda dapat menerapkan label ke cluster dan ke node pool Mode standar. Saat Anda memberi label pada sebuah cluster, label tersebut akan diterapkan ke semua resource individual cluster seperti node, instance, dan persistent disk. Saat Anda memberi label pada node pool, label akan diterapkan ke semua resource individual node pool seperti instance dan persistent disk. Di cluster Standar, jika label cluster bertentangan dengan label node pool, seperti saat kunci label sama tetapi nilainya berbeda, label node pool akan menggantikan label cluster.

Setiap label yang Anda terapkan ke cluster atau node pool akan disebarkan melalui proses latar belakang yang berjalan setiap jam. Diperlukan waktu hingga satu jam agar label muncul di semua resource yang terkait dengan cluster tertentu. Selain itu, label hanya disebarkan ke instance Compute Engine dan Persistent Disk yang terpasang ke instance Compute Engine. Resource lain seperti beban kerja, aturan penerusan, alamat IP, dan Persistent Disk yang tidak terpasang tidak diberi label.

Untuk cluster Standar, saat label cluster dan node pool diterapkan ke resource Compute Engine, Anda dapat mengubah label resource secara manual tanpa merekonsiliasi perubahan tersebut oleh GKE. Dalam cluster Autopilot, Anda tidak dapat mengubah label secara manual pada resource Compute Engine karena GKE mengelola node untuk Anda. Namun, sebaiknya kelola label ini melalui GKE. Label yang sudah ada di resource Compute Engine tersebut tidak akan dihapus oleh GKE kecuali jika label tersebut bertentangan dengan label yang diterapkan secara otomatis.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menjalankan tugas berikut:

• Aktifkan Google Kubernetes Engine API.
Aktifkan Google Kubernetes Engine API
• Jika ingin menggunakan Google Cloud CLI untuk tugas ini, instal lalu initialize gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan gcloud components update.

Mendapatkan sidik jari label untuk permintaan API

Langkah ini dapat dilewati jika Anda menggunakan Google Cloud Console atau gcloud CLI.

Saat mengupdate atau menambahkan label cluster menggunakan GKE API, Anda harus memberikan sidik jari label cluster terbaru dengan permintaan Anda untuk mencegah konflik dengan permintaan lainnya.

Untuk mendapatkan sidik jari label cluster terbaru, jalankan permintaan GET untuk cluster yang sesuai. Contoh:

GET https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster

Outputnya mirip dengan hal berikut ini:

200 OK

{

 "name": "mycluster",
 "description": "production-cluster",
 "initialNodeCount": 3,
 ...
 "resourceLabels": {
    "environment": "production",
    ...
  },
  "labelFingerprint": "p1ty_9HoBk0="
}

Dalam output ini, properti labelFingerprint adalah sidik jari label cluster.

Membuat cluster dengan label

Anda dapat membuat cluster Autopilot dan Standard dengan label menggunakan gcloud CLI, konsol Google Cloud, GKE API, atau Terraform.

gcloud container clusters create-auto CLUSTER_NAME \
    --labels=KEY=VALUE

gcloud container clusters create CLUSTER_NAME \
    --labels=KEY=VALUE

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-labels"
  location = "us-central1"

  enable_autopilot = true

  resource_labels = {
    foo = "bar"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-labels"
  location           = "us-west1"
  initial_node_count = 2

  resource_labels = {
    foo = "bar"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Menambahkan atau memperbarui label untuk cluster yang ada

Anda dapat menambahkan atau memperbarui label untuk cluster Autopilot dan Standar yang ada menggunakan gcloud CLI, konsol Google Cloud, atau GKE API.

gcloud container clusters update CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --update-labels=KEY=VALUE

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": {
  "environment": "production",
  "an-existing-tag": ""
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Menghapus label cluster

Anda dapat menghapus label dari cluster Autopilot dan Standar menggunakan gcloud CLI, Google Cloud Console, atau GKE API.

gcloud container clusters update CLUSTER_NAME \
    --remove-labels=KEYS

Request

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

Membuat node pool Standar dengan label

Anda dapat membuat node pool dengan label dalam cluster Standar menggunakan gcloud CLI, Google Cloud Console, atau GKE API.

gcloud container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --labels=KEY=VALUE

Menambahkan atau memperbarui label untuk node pool yang ada

Anda dapat menambahkan atau memperbarui label untuk node pool yang ada menggunakan gcloud CLI, Google Cloud Console, atau GKE API.

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --labels=KEY=VALUE

Menghapus label node pool

Anda dapat menghapus label dari node pool menggunakan gcloud CLI, Google Cloud Console, atau GKE API.

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --labels=KEY=VALUE

Langkah selanjutnya

Baca ringkasan GKE.