Mengupgrade Kf di Google Cloud

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

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

  • Konfirmasi bahwa versi Kf Anda saat ini dapat diupgrade ke Kf v2.6.1.
  • Upgrade ke Kf v2.6.1.
  • Upgrade dependensi (jika diperlukan).

Sebelum memulai

Anda akan memerlukan:

  • Cluster yang ada dengan Kf terinstal.
  • Akses ke mesin 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 server dan Kf CLI Anda saat ini cocok

Jalankan kf debug dan validasi bahwa versi server Kf dan Kf CLI cocok.

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

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

Jika nilai server Kf lebih lama dari v2.5.x, Anda harus mengupgrade secara bertahap ke Kf v2.5.x terlebih dahulu untuk melanjutkan.

Mengonfirmasi bahwa Kf dalam kondisi baik 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 mengatasi masalah dan mencoba kembali perintah hingga berhasil.

Mengupgrade operator

Operator Kf melakukan upgrade untuk Anda.

  1. Terapkan yaml operator:

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

Mengupgrade dependensi Kf

  1. Upgrade Tekton:

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

  2. Upgrade ke Cloud Service Mesh terbaru:

    1. Ikuti langkah-langkah dalam panduan upgrade Cloud Service Mesh.

  1. Upgrade Config Connector.

    1. Download file tar Config Connector Operator 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 Kf v2.6.1 CLI

  1. Instal CLI:

    Linux

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

    gcloud storage cp gs://kf-releases/v2.6.1/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 di sistem.

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

    Cloud Shell

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

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/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 dari direktori saat ini.

    gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe

  2. Validasi bahwa versi server Kf dan Kf CLI cocok:

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

Memastikan bahwa Kf berhasil diupgrade

  1. Jalankan doctor untuk memastikan versi yang baru diinstal dalam kondisi baik:

    kf doctor --retries=20

    Perintah ini menjalankan pemeriksaan cluster beberapa kali. Beberapa upaya akan gagal saat pengendali baru dimulai.

    Jika perintah gagal dengan pesan Error: environment failed checks, ikuti panduan dalam output doctor untuk mengatasi masalah dan mencoba kembali perintah hingga berhasil.

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