Mengupgrade Kf di Google Cloud

Dokumen ini menjelaskan cara mengupgrade penginstalan Kf yang ada beserta dependensinya.

Sebagai bagian dari prosedur upgrade, pastikan penginstalan Kf Anda menggunakan versi terbaru operator Kf:

  • Pastikan versi Kf Anda saat ini dapat diupgrade ke Kf v2.11.21.
  • Upgrade ke Kf v2.11.21.
  • Mengupgrade dependensi (jika diperlukan).

Sebelum memulai

Yang Anda butuhkan:

  • Cluster yang ada dengan Kf terinstal.
  • Akses ke komputer dengan gcloud, kf, dan kubectl terinstal.

Mempersiapkan upgrade

Menghubungkan ke cluster target

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Mengonfirmasi bahwa versi Kf CLI dan server Anda saat ini cocok

Jalankan kf debug dan validasi kecocokan versi server Kf CLI dan Kf.

  • Versi CLI tercantum di bagian Kf Client.
  • Versi server Kf tercantum di bagian kf["app.kubernetes.io/version"].
$ kf debug
...
Version:
  Kf Client:                        v2.11.20
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.11.20
...

Jika nilai klien Kf dan server Kf tidak cocok, tetapi versi server adalah v2.10.x, instal CLI Kf v2.11.21 sebelum Anda melanjutkan.

Jika nilai server Kf lebih lama dari v2.10.x, Anda harus melakukan upgrade secara bertahap ke Kf v2.10.x untuk melanjutkan.

Pastikan Kf responsif sebelum mengupgrade

Jalankan kf doctor untuk memeriksa status cluster Anda. Pastikan semua pengujian lulus sebelum Anda melanjutkan.

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

Jika Anda melihat pesan FAIL atau Error: environment failed checks, ikuti panduan dalam output kf doctor, atau lihat panduan pemecahan masalah untuk menyelesaikan masalah dan coba lagi perintah sampai berhasil.

Mengupgrade operator

Operator Kf melakukan upgrade untuk Anda.

  1. Terapkan operator yaml:

    kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.11.21/operator.yaml"

Mengupgrade dependensi Kf

  1. Upgrade Tekton:

    kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.47.1/release.yaml"

  2. Upgrade ke Anthos Service Mesh v1.17.4-asm.2+config1:

    1. Ikuti langkah-langkah di panduan upgrade Anthos Service Mesh.

  1. Upgrade/Instal Konektor Konfigurasi:

    Untuk mengupgrade dari Kf v2.11: Ikuti langkah-langkah pada langkah 'Install Config Connector' dalam Kf Install

    Untuk melakukan upgrade dari Kf v2.7:

    1. Download file tar Operator Config Connector yang diperlukan.

    2. Ekstrak file tar.

      tar zxvf release-bundle.tar.gz

    3. Instal operator Config Connector di cluster Anda.

      kubectl apply -f operator-system/configconnector-operator.yaml

Mengupgrade ke CLI Kf v2.11.21

  1. Instal CLI:

    Linux

    Perintah ini menginstal Kf CLI untuk semua pengguna di sistem. Ikuti petunjuk di tab Cloud Shell untuk menginstalnya sendiri.

    gsutil cp gs://kf-releases/v2.11.21/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    Perintah ini menginstal kf untuk semua pengguna pada sistem.

    gsutil cp gs://kf-releases/v2.11.21/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Perintah ini menginstal kf pada instance Cloud Shell jika Anda menggunakan bash, petunjuk mungkin perlu diubah untuk shell lainnya.

    mkdir -p ~/bin
gsutil cp gs://kf-releases/v2.11.21/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    Tindakan ini akan mendownload kf ke direktori saat ini. Tambahkan ke jalur jika Anda ingin memanggilnya dari mana saja selain direktori saat ini.

    gsutil cp gs://kf-releases/v2.11.21/kf-windows.exe kf.exe

  2. Validasi kecocokan versi server Kf CLI dan Kf:

    • Versi CLI tercantum di bagian Kf Client.
    • Versi server Kf tercantum di bagian kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.11.21
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.11.21
...

Verifikasi bahwa Kf berhasil diupgrade

  1. Jalankan doctor untuk memastikan versi yang baru diinstal responsif:

    kf doctor --retries=20

    Perintah ini menjalankan pemeriksaan cluster beberapa kali. Adanya beberapa upaya yang gagal saat {i>controller<i} baru dimulai.

    Jika perintah gagal dengan pesan Error: environment failed checks, ikuti panduan dalam output doctor untuk menyelesaikan masalah dan coba lagi perintah tersebut sampai berhasil.

Jika langkah verifikasi lulus, cluster Anda telah berhasil diupgrade. Jika Anda mengalami masalah, tinjau halaman dukungan untuk mendapatkan panduan.