Versi 2.4

Versi yang tersedia

2.11 - Versi terbaru
2.10
2.9
2.8 - EOL/Tidak Didukung
2.7 - EOL/Tidak Didukung
2.6 - EOL/Tidak Didukung
2.5 - EOL/Tidak Didukung
2.4 - EOL/Tidak Didukung
2.3 - EOL/Tidak Didukung
2.2 - EOL/Tidak Didukung
2.1 - EOL/Tidak Didukung

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Melakukan Upgrade Kf

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

Sebagai bagian dari prosedur upgrade, Anda harus memastikan bahwa penginstalan Kf menggunakan operator Kf versi terbaru:

Konfirmasi bahwa versi Kf Anda saat ini dapat diupgrade ke Kf v2.4.1.
Upgrade ke Kf v2.4.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.3.2
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.3.2
...

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

Jika nilai server Kf lebih lama dari v2.3.x, Anda harus mengupgrade ke Kf v2.3.x secara bertahap 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 tersebut dan coba lagi perintah hingga berhasil.

Opsional: mencadangkan configmap Kf jika Anda telah melakukan penyesuaian

Buat cadangan configmap config-defaults dengan menjalankan:

kubectl get configmap config-defaults -o yaml -n kf > config-defaults-backup.yaml

Buat cadangan configmap config-secrets dengan menjalankan:
```
kubectl get configmap config-secrets -o yaml -n kf > config-secrets-backup.yaml
```
Catatan: Cadangan ini hanya untuk referensi dan tidak boleh diterapkan secara langsung.

Mengupgrade operator Kf

Operator Kf pertama kali dirilis sebagai bagian dari versi 2.4.0:

Jika Anda telah menginstal operator Kf sebagai bagian dari penginstalan 2.4.0, Anda hanya perlu mengupgradenya sebagai bagian dari upgrade ke 2.4.1.

Lihat Mengupgrade operator Kf.
Jika Anda mengupgrade dari 2.3.2, Anda harus menginstal operator Kf versi 2.4.1 untuk mengupgrade ke Kf yang dikelola operator.

Lihat Menginstal operator Kf.

Mengupgrade operator Kf saat ini

Operator Kf melakukan upgrade untuk Anda.

Terapkan yaml operator:

Catatan: Operasi ini segera dimulai, dan tidak dapat dibatalkan.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.4.1/operator.yaml"
```

Menginstal operator Kf untuk pertama kalinya

Lakukan langkah-langkah berikut untuk mengupgrade ke Kf yang dikelola operator.

Terapkan yaml operator:

Catatan: Operasi ini segera dimulai, dan tidak dapat dibatalkan.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.4.1/operator.yaml"
```
Pilih antara menggunakan nilai default atau mempertahankan penyesuaian:

Catatan: Pilih salah satu. Jangan selesaikan keduanya.
1. Siapkan kfsystem.yaml untuk upgrade menggunakan nilai default:
  
  Catatan: Ikuti langkah-langkah ini jika Anda belum melakukan penyesuaian apa pun pada config-defaults atau config-secrets.
  
  Unduh file kfsystem.yaml, isi variabel di bawah, lalu jalankan perintah di direktori yang sama dengan file untuk menyiapkan kfsystem.yaml secara otomatis untuk upgrade.
```
export CLUSTER_PROJECT_ID=YOUR_PROJECT_ID
export CLUSTER_NAME=YOUR_CLUSTER_NAME
export CONTAINER_REGISTRY=YOUR_CLUSTER_COMPUTE_REGION-docker.pkg.dev/${CLUSTER_PROJECT_ID}/${CLUSTER_NAME}

kubectl apply -f kfsystem.yaml

kubectl patch \
kfsystem kfsystem \
--type='json' \
-p="[{'op': 'replace', 'path': '/spec/kf', 'value': {'enabled': true, 'config': {'spaceContainerRegistry': '${CONTAINER_REGISTRY}', 'secrets':{'workloadidentity':{'googleserviceaccount':'${CLUSTER_NAME}-sa', 'googleprojectid':'${CLUSTER_PROJECT_ID}'}}}}}]"
```
2. Siapkan kfsystem.yaml untuk upgrade sambil mempertahankan penyesuaian:
  
  Catatan: Ikuti langkah-langkah ini jika Anda telah melakukan penyesuaian pada config-defaults atau config-secrets, Anda harus menyalinnya secara manual ke kolom yang sesuai di kfsystem.yaml.
  1. Download file kfsystem.yaml.
  2. Buat cadangan configmap config-defaults dengan menjalankan:
```
kubectl get configmap config-defaults -o yaml -n kf > config-defaults-backup.yaml
```
  3. Buat cadangan configmap config-secrets dengan menjalankan:
```
kubectl get configmap config-secrets -o yaml -n kf > config-secrets-backup.yaml
```
  4. Periksa configmap config-defaults dan config-secrets saat ini, lalu temukan setelan yang sesuai di kfsystem.yaml.
  5. Salin setelan yang ada dari config-secrets dan config-defaults. Semua setelan di config-secrets dan config-defaults dapat ditemukan di kfsystem.yaml. Kolom googleProjectId kini wajib diisi.
  6. Kolom wi.googleServiceAccount adalah Akun Layanan lengkap di config-secrets, tetapi untuk kfsystem, akhiran harus dihapus. Misalnya, ${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com akan menjadi ${CLUSTER_NAME}-sa di kfsystem.yaml.
  7. Setelah setelan disalin, ubah kolom enabled di kfsystem menjadi true.
  8. Simpan perubahan Anda ke kfsystem.yaml.
  9. Konfigurasikan operator untuk Kf:
```
kubectl apply -f kfsystem.yaml
```

Mengupgrade dependensi Kf

Upgrade Tekton:

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

Upgrade Cloud Service Mesh:

**Catatan:** Jika Anda menjalankan Cloud Service Mesh versi yang lebih lama dari 1.9, selesaikan langkah ini.
1. Ikuti langkah-langkah dalam panduan upgrade Cloud Service Mesh 1.9.
Upgrade Config Connector.

Catatan: Config Connector diperlukan mulai Kf v2.4.0.
Peringatan: Jangan gunakan metode add-on GKE untuk menginstal Config Connector karena tidak didukung oleh Kf. Gunakan langkah-langkah penginstalan kustom ini.
1. Download file tar Config Connector Operator yang diperlukan.
  
  Catatan: Simpan salinan paket penginstalan karena Anda memerlukan paket ini untuk meng-uninstal Config Connector.
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
```
4. Konfigurasikan operator Config Connector jika menginstal Config Connector untuk pertama kalinya.
  1. Salin YAML berikut ke dalam file bernama configconnector.yaml:
    
    Peringatan: Ganti variabel KF_SERVICE_ACCOUNT_NAME dalam YAML di bawah dengan akun layanan lengkap yang di-resolve dari ${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com
```
# configconnector.yaml
apiVersion: core.cnrm.cloud.google.com/v1beta1
kind: ConfigConnector
metadata:
# the name is restricted to ensure that there is only one
# ConfigConnector resource installed in your cluster
name: configconnector.core.cnrm.cloud.google.com
spec:
mode: cluster
googleServiceAccount: "KF_SERVICE_ACCOUNT_NAME" # Replace with the full service account resolved from ${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com
```
  2. Terapkan konfigurasi ke cluster Anda.
```
kubectl apply -f configconnector.yaml
```
5. Pastikan Config Connector terinstal sepenuhnya sebelum melanjutkan.
  - Config Connector menjalankan semua komponennya dalam namespace bernama cnrm-system. Verifikasi bahwa Pod sudah siap dengan menjalankan perintah berikut:
```
kubectl wait -n cnrm-system --for=condition=Ready pod --all
```
  - Jika Config Connector diinstal dengan benar, outputnya akan mirip dengan berikut:
```
pod/cnrm-controller-manager-0 condition met
```
    Catatan: Pod pengontrol dapat memerlukan waktu beberapa menit untuk dimulai.
6. Siapkan Workload Identity jika menginstal Config Connector untuk pertama kalinya.
```
kubectl annotate serviceaccount \
--namespace cnrm-system \
--overwrite \
cnrm-controller-manager \
iam.gke.io/gcp-service-account=${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com
```

Mengupgrade ke Kf v2.4.1 CLI

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.4.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.4.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 lain.
mkdir -p ~/bin gcloud storage cp gs://kf-releases/v2.4.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.4.1/kf-windows.exe kf.exe

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.4.1
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.4.1
...

Memverifikasi bahwa Kf berhasil diupgrade

Jika menginstal operator Kf untuk pertama kalinya, konfirmasi bahwa operator telah diinstal:
```
kubectl get deployment -n appdevexperience appdevexperience-operator
```
Jika Anda tidak melihat operator seperti dalam output contoh di bawah, tinjau langkah-langkah Menginstal operator Kf untuk pertama kalinya.
```
NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
appdevexperience-operator   1/1     1            1           1h
```
Jalankan doctor untuk memastikan versi yang baru diinstal dalam kondisi baik:
```
kf doctor --retries=20
```
Perintah ini akan menjalankan pemeriksaan cluster beberapa kali. Beberapa upaya akan gagal saat pengontrol baru dimulai.

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

Jika Anda telah melakukan penyesuaian pada config-defaults atau config-secrets, verifikasi bahwa penyesuaian tersebut telah diterapkan:

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 mempertahankan semua perubahan dari versi Kf lama, dan menyetujui penggunaan buildpack baru yang disertakan dengan versi Kf 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

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