Memperbarui workload stateful

Dokumen ini menjelaskan cara mengupdate workload stateful yang ada dan berjalan di cluster Kubernetes yang terisolasi dari jaringan Google Distributed Cloud (GDC). Saat aplikasi Anda berkembang berdasarkan penggunaan resource dan pengoptimalan konfigurasi, Anda harus mengupdate spesifikasi pod yang mendasarinya di cluster Kubernetes untuk mencerminkan perubahan workload tersebut. Untuk mengetahui informasi selengkapnya tentang perencanaan update untuk workload stateful, lihat dokumentasi Kubernetes untuk Strategi update.

Dokumen ini ditujukan untuk developer dalam grup operator aplikasi, yang bertanggung jawab untuk mengupdate workload aplikasi untuk organisasi mereka. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Sebelum memulai

Untuk menyelesaikan tugas dalam dokumen ini, Anda harus meminta izin yang diperlukan dan menyiapkan lingkungan Anda.

Meminta peran IAM

Anda harus memiliki peran tertentu untuk mendapatkan izin yang diperlukan untuk mengupdate workload stateful. Peran yang Anda perlukan bergantung pada apakah Anda bekerja dalam cluster bersama yang memiliki cakupan organisasi atau cluster standar yang memiliki cakupan project. Untuk mengetahui informasi selengkapnya, lihat Konfigurasi cluster Kubernetes.

Peran cluster bersama

Untuk membuat, menghapus, mengedit, atau melihat workload di cluster bersama, minta Admin IAM Project Anda untuk memberi Anda peran Admin Namespace (namespace-admin). Peran ini terikat ke namespace project Anda.

Peran cluster standar

Untuk membuat, menghapus, mengedit, atau melihat workload di cluster standar, minta Admin IAM Project Anda untuk memberi Anda peran Developer Cluster (cluster-developer). Peran ini terikat ke namespace project Anda.

Menyiapkan lingkungan Anda

Untuk menjalankan perintah terhadap a cluster Kubernetes menggunakan API, pastikan Anda memiliki resource berikut:

  • Temukan nama cluster Kubernetes, atau tanyakan kepada anggota grup administrator platform nama cluster tersebut.

  • Login dan buat file kubeconfig untuk cluster Kubernetes.

  • Gunakan jalur kubeconfig cluster Kubernetes untuk mengganti KUBERNETES_CLUSTER_KUBECONFIG dalam petunjuk ini.

Mengupdate resource StatefulSet

Untuk mengupdate StatefulSet, terapkan file manifes baru atau yang telah diupdate. Hal ini berguna untuk membuat berbagai perubahan pada StatefulSet Anda saat melakukan penskalaan atau untuk menentukan versi baru aplikasi Anda.

Untuk mengupdate objek StatefulSet, jalankan:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    apply -f STATEFULSET_FILE

Ganti kode berikut:

  • KUBERNETES_CLUSTER_KUBECONFIG: file kubeconfig untuk cluster yang menjalankan workload stateful.

  • NAMESPACE: namespace. Untuk cluster bersama, ini harus berupa namespace project. Untuk cluster standar, dapat berupa namespace apa pun.

  • STATEFULSET_FILE: nama file manifes StatefulSet yang diupdate.

Perintah kubectl apply menerapkan file manifes ke resource. Jika resource yang ditentukan tidak ada, resource tersebut akan dibuat oleh perintah.

Memeriksa peluncuran update resource StatefulSet

Anda dapat melihat informasi mendetail terkait status peluncuran update dan histori objek StatefulSet. Anda juga dapat mengurungkan peluncuran objek StatefulSet.

Memeriksa peluncuran

Untuk memeriksa peluncuran resource StatefulSet, jalankan:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout status statefulset STATEFULSET_NAME

  • KUBERNETES_CLUSTER_KUBECONFIG: file kubeconfig untuk cluster yang menjalankan workload stateful.

  • NAMESPACE: namespace. Untuk cluster bersama, ini harus berupa namespace project. Untuk cluster standar, dapat berupa namespace apa pun.

  • STATEFULSET_NAME: nama objek StatefulSet yang diupdate.

Mendapatkan histori peluncuran

Untuk melihat histori peluncuran resource StatefulSet, jalankan:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout history statefulset STATEFULSET_NAME

  • KUBERNETES_CLUSTER_KUBECONFIG: file kubeconfig untuk cluster yang menjalankan workload stateful.

  • NAMESPACE: namespace. Untuk cluster bersama, ini harus berupa namespace project. Untuk cluster standar, dapat berupa namespace apa pun.

  • STATEFULSET_NAME: nama objek StatefulSet yang diupdate.

Mengurungkan peluncuran

Untuk mengurungkan peluncuran, jalankan:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout undo statefulset STATEFULSET_NAME

Ganti kode berikut:

  • KUBERNETES_CLUSTER_KUBECONFIG: file kubeconfig untuk cluster yang menjalankan workload stateful.

  • NAMESPACE: namespace. Untuk cluster bersama, ini harus berupa namespace project. Untuk cluster standar, dapat berupa namespace apa pun.

  • STATEFULSET_NAME: nama objek StatefulSet.

Langkah berikutnya