Sebagai bagian dari prosedur upgrade, pastikan penginstalan Kf Anda menggunakan operator Kf versi terbaru:
- Pastikan versi Kf Anda saat ini dapat diupgrade ke Kf v2.7.3.
- Upgrade ke Kf v2.7.3.
- Mengupgrade dependensi (jika diperlukan).
Sebelum memulai
Anda memerlukan:
- Cluster yang ada dengan Kf terinstal.
- Akses ke komputer yang menginstal
gcloud
,kf
, dankubectl
.
Mempersiapkan upgrade
Menghubungkan ke cluster target
gcloud container clusters get-credentials CLUSTER_NAME \
--zone CLUSTER_ZONE \
--project CLUSTER_PROJECT_ID
Pastikan versi server dan Kf CLI Anda saat ini cocok
Jalankan kf debug
dan validasikan kecocokan versi server Kf dan Kf CLI.
- 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
...
Jika nilai klien Kf dan server Kf tidak cocok, tetapi versi servernya adalah v2.6.x, instal CLI Kf v2.7.3 sebelum melanjutkan.
Jika nilai server Kf lebih lama dari v2.6.x, Anda harus mengupgrade secara bertahap ke Kf v2.6.x terlebih dahulu untuk melanjutkan.
Pastikan Kf berfungsi dengan 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 menyelesaikan masalah dan coba lagi perintah tersebut
hingga berhasil.
Mengupgrade operator
Operator Kf melakukan upgrade untuk Anda.
Terapkan yaml operator:
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.7.3/operator.yaml"
Mengupgrade dependensi Kf
Mengupgrade Tekton:
kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.29.0/release.yaml"
Mengupgrade ke Cloud Service Mesh v1.12:
- Ikuti langkah-langkah dalam panduan upgrade Cloud Service Mesh.
Mengupgrade Config Connector.
Download file tar Operator Config Connector yang diperlukan.
Ekstrak file tar.
tar zxvf release-bundle.tar.gz
Instal operator Config Connector di cluster Anda.
kubectl apply -f operator-system/configconnector-operator.yaml
Mengupgrade ke CLI Kf v2.7.3
Instal CLI:
Linux
Perintah ini menginstal Kf CLI untuk semua pengguna di sistem. Ikuti petunjuk di tab Cloud Shell untuk menginstalnya hanya untuk Anda.
gcloud storage cp gs://kf-releases/v2.7.3/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.7.3/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 menggunakanbash
, petunjuk mungkin perlu diubah untuk shell lain.mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.7.3/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.gcloud storage cp gs://kf-releases/v2.7.3/kf-windows.exe kf.exe
Validasi kecocokan versi server Kf dan CLI 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.7.3 Server version: v1.21.3-gke.2001 kf["app.kubernetes.io/version"]: v2.7.3 ...
- Versi CLI tercantum di bagian
Memverifikasi bahwa Kf berhasil diupgrade
Jalankan
doctor
untuk memastikan versi yang baru diinstal berfungsi dengan baik:kf doctor --retries=20
Perintah ini menjalankan pemeriksaan cluster beberapa kali. Wajar jika beberapa upaya gagal saat pengontrol baru dimulai.
Jika perintah gagal dengan pesan
Error: environment failed checks
, ikuti panduan dalam outputdoctor
untuk menyelesaikan masalah dan coba lagi perintah hingga berhasil.
Jika langkah-langkah verifikasi berhasil, cluster Anda telah berhasil diupgrade. Jika Anda mengalami masalah, tinjau halaman dukungan untuk mendapatkan panduan.