Upgrade Kf

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

Sebelum memulai

Yang Anda butuhkan:

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

Memvalidasi penginstalan Kf yang ada

Dapatkan kredensial autentikasi untuk berinteraksi dengan cluster:

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

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.0.0
  Server version:                   v1.17.13-gke.1401
  kf["app.kubernetes.io/version"]:  v2.0.0
...
```
Jika nilai klien Kf dan server Kf tidak cocok, download dan instal versi Kf CLI yang cocok dengan versi server, lalu ulangi pemeriksaan dengan CLI baru. Versi CLI harus cocok dengan versi server sebelum Anda melanjutkan.
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 Error: environment failed checks, ikuti panduan dalam output doctor untuk menyelesaikan masalah dan coba lagi perintah sampai berhasil.

Upgrade

Untuk mengupgrade Kf, lakukan langkah-langkah berikut:

Siapkan lingkungan lokal dan upgrade.
Upgrade dependensi Kf.
Upgrade Kf dan verifikasi bahwa upgrade tersebut berhasil.

Menyiapkan upgrade

Jalankan kf version untuk mendapatkan Kf versi terbaru.
```
$ kf version
kf version v2.0.0 linux
```
Temukan versi Kf terbaru berikutnya dari halaman download.

Peringatan: Kf saat ini hanya mendukung upgrade satu versi minor dalam satu waktu. Misalnya v2.0.0 hingga v2.1.0.
1. Download file YAML rilis Kf dan simpan sebagai kf-release.yaml.
2. Download versi Kf untuk OS Anda dan beri nama kf-next.
3. Jalankan chmod agar kf-next dapat dieksekusi:
```
chmod +x kf-next
```
4. Jalankan kf-next version untuk memastikan versi yang didownload cocok dengan versi Kf yang ingin Anda instal:
```
$ kf-next version
kf version v2.1.0 linux
```
Buat cadangan configmap config-defaults dengan menjalankan:
```
kubectl get configmap config-defaults -o yaml -n kf > config-defaults-backup.yaml
```
Catatan: Cadangan ini hanya untuk referensi dan tidak boleh diterapkan secara langsung.
Jalankan kubectl diff -f kf-release.yaml dan periksa perubahan yang akan dibuat oleh upgrade pada cluster Anda.

Catatan: Perhatikan configmap config-defaults dengan cermat. Kf menggunakan configmap tersebut untuk menyimpan penyesuaian di seluruh cluster seperti domain, flag fitur, dan registry container.
Edit kf-release.yaml dan ubah untuk mempertahankan perubahan yang ingin Anda pertahankan.

Misalnya, jika Anda menetapkan properti configmap config-defaults spaceDefaultToV3Stack ke salah dalam v2.0.0 dari Kf, rilis v2.1.0 akan memiliki nilai default true.
Jalankan kubectl diff -f kf-release.yaml lagi untuk memastikan setiap perubahan yang Anda buat menghasilkan output yang diharapkan.

Mengupgrade dependensi Kf

Buka halaman download dan temukan matriks dependensi untuk versi Kf yang Anda upgrade.
Upgrade Tekton:
1. Buka halaman Rilis Tekton.
2. Temukan versi Tekton yang tercantum dalam matriks dependensi Kf.
3. Jalankan perintah di bawah judul "Installation one-liner" untuk mengupgrade Tekton.
Upgrade Anthos Service Mesh:
1. Buka panduan upgrade Anthos Service Mesh.
2. Di menu dropdown versi, pilih versi Anthos Service Mesh yang tercantum dalam matriks dependensi Kf.
3. Ikuti panduan untuk mengupgrade ASM.

Upgrade dan verifikasi Kf

Instal komponen Kf yang diupgrade menggunakan konfigurasi rilis yang dimodifikasi:
```
kubectl apply -f kf-release.yaml
```
Jalankan doctor untuk memastikan versi yang baru diinstal responsif:
```
kf-next doctor --retries=12 --delay=5s
```
Perintah ini akan 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.
Ganti CLI kf yang ada di sistem Anda dengan kf-next CLI.
```
chmod +x kf-next
mv kf-next $(which kf)
```
Catatan: Anda mungkin harus menjalankan perintah ini sebagai super user menggunakan sudo jika Kf diinstal secara global.

Bandingkan file config-defaults-backup.yaml dengan kubectl diff -f config-defaults-backup.yaml untuk memastikan cluster Anda masih dikonfigurasi dengan benar.

Misalnya, jika Anda menyimpan semua perubahan dari versi Kf lama, dan menyetujui penggunaan buildpack baru yang dipaketkan dengan Kf versi berikutnya:

$ kubectl diff -f config-defaults-backup.yaml
diff -u -N /tmp/LIVE/v1.ConfigMap.kf.config-defaults /tmp/MERGED/v1.ConfigMap.kf.config-defaults
--- /tmp/LIVE/v1.ConfigMap.kf.config-defaults
+++ /tmp/MERGED/v1.ConfigMap.kf.config-defaults
@@ -131,6 +131,8 @@
     enable_route_services: false
   spaceBuildpacksV2: |
-    - name: new_buildpack
-      url: https://github.com/cloudfoundry/new-buildpack
     - name: staticfile_buildpack
       url: https://github.com/cloudfoundry/staticfile-buildpack
     - name: java_buildpack
exit status 1