Dokumentasi ini adalah untuk penayangan Knative versi Terbaru, yang menggunakan fleet dan Anthos Service Mesh. Pelajari lebih lanjut.

Versi sebelumnya (Cloud Run for Anthos) telah diarsipkan, tetapi dokumentasinya tetap tersedia untuk pengguna yang sudah ada.

Versi yang tersedia

Terbaru
Mengarsipkan

Penyiapan dan persiapan lingkungan untuk upgrade

Persiapkan untuk mengupgrade penginstalan Knative Anda sebelumnya dan migrasikan workload Anda dengan menyiapkan lingkungan command line, membuat variabel lingkungan, dan mendownload skrip migrasi.

Sebelum memulai

Anda harus meninjau dan memastikan bahwa Anda memenuhi persyaratan terlebih dahulu sebelum melakukan upgrade.
Secara default, Cloud Shell menyertakan versi terbaru dari perintah gcloud dan kubectl. Jika memilih untuk menggunakan lingkungan command line mesin lokal, Anda harus memastikan bahwa Anda memenuhi persyaratan minimum berikut:
- gcloud versi 346.0.0 atau yang lebih baru
- kubectl klien versi 1.21 atau yang lebih baru
Pelajari lebih lanjut cara menyiapkan alat command line
Langkah-langkah persiapan di halaman ini diperlukan selama proses upgrade dan migrasi.

Penting: Semua perintah yang digunakan selama proses bergantung pada variabel lingkungan yang Anda tetapkan di bawah. Misalnya, jika Anda menutup Cloud Shell atau waktu tunggu sesi habis, Anda harus memastikan bahwa variabel lingkungan yang diperlukan telah direset.

Menyiapkan lingkungan Anda

Untuk menggunakan Cloud Shell, buka Cloud Shell di Konsol Google Cloud:

Aktifkan Cloud Shell

Penting: Cloud Shell memiliki batas penggunaan dan dapat habis waktu tunggu. Jika waktu tunggu sesi habis, Anda harus memastikan variabel lingkungan yang diperlukan direset.
Buat variabel lingkungan yang diperlukan berikut ini:
1. Tetapkan variabel untuk detail cluster dan project Google Cloud Anda:
```
export PROJECT_ID=PROJECT_ID
export CLUSTER_NAME=CLUSTER_NAME
export CLUSTER_LOCATION=CLUSTER_LOCATION
```
  Ganti kode berikut:
  - PROJECT_ID dengan ID project Google Cloud Anda.
  - CLUSTER_NAME dengan ID cluster Anda atau ID yang sepenuhnya memenuhi syarat untuk cluster.
  - CLUSTER_LOCATION dengan region atau zona tempat cluster Anda berada.
2. Bergantung pada konfigurasinya, Anda harus mengidentifikasi gateway masuk yang menangani traffic di cluster Anda. Penting untuk mengidentifikasi versi Istio mana yang benar-benar dikonfigurasi dan menyalurkan traffic.
  - Jika Anda menggunakan versi paket Istio, pastikan nama layanan masuk adalah istio-ingress di namespace gke-system:
```
kubectl get svc istio-ingress -n gke-system
```
    Hasil: Detail konfigurasi Anda ditampilkan.
  - Jika menginstal "add-on Istio", Anda harus menentukan gateway masuk yang dikonfigurasi dan menangani traffic secara aktif dengan memperoleh alamat IP layanan dan mengidentifikasi layanan mana yang dikonfigurasi ke domain Anda.
    1. Dapatkan alamat EXTERNAL-IP untuk setiap layanan masuk:
      
      Jalankan perintah berikut untuk mendapatkan detail konfigurasi layanan ingress "versi paket" (istio-ingress) dan "add-on Istio" (istio-ingressgateway):
```
kubectl get svc istio-ingress -n gke-system
kubectl get svc istio-ingressgateway -n istio-system
```
      Contoh output:
      
      Catat nilai EXTERNAL-IP untuk setiap layanan.
```
 NAME                 TYPE         CLUSTER-IP  EXTERNAL-IP    PORT(S)                                     AGE
 istio-ingress        LoadBalancer 11.11.1.111 12.345.678.910 15020:31265/TCP,80:30059/TCP,443:32004/TCP  8d

 NAME                 TYPE         CLUSTER-IP  EXTERNAL-IP    PORT(S)                                                                     AGE
 istio-ingressgateway LoadBalancer 22.22.2.222 10.987.654.321 15021:32747/TCP,80:30695/TCP,443:32695/TCP,15012:32369/TCP,15443:30909/TCP  88d
```
    2. Identifikasi alamat IP eksternal yang dikonfigurasi untuk menangani traffic melalui data DNS domain kustom Anda:
      1. Buka halaman pemetaan domain penayangan Knative:
        
        Buka Pemetaan domain
      2. Klik ikon elips vertikal 3 titik di sebelah kanan layanan Anda, lalu klik DATA DNS untuk menampilkan semua data DNS:
        
        Dengan menggunakan contoh di atas, gateway masuk add-on Istio sedang digunakan dan menyalurkan traffic jika konfigurasi data DNS ditetapkan ke alamat IP 10.987.654.321 dari layanan istio-ingressgateway.
3. Tetapkan variabel untuk nama dan namespace layanan ingress yang menyalurkan traffic untuk cluster Anda:
```
export INGRESS_NAME=INGRESS_NAME
export INGRESS_NAMESPACE=INGRESS_NAMESPACE
```
  Ganti kode berikut:
  - INGRESS_NAME dengan nama layanan ingress yang Anda identifikasi pada langkah sebelumnya.
  - INGRESS_NAMESPACE dengan namespace layanan ingress yang Anda identifikasi pada langkah sebelumnya.

Konfigurasikan Google Cloud CLI:

gcloud config set project ${PROJECT_ID}
gcloud container clusters get-credentials ${CLUSTER_NAME} --region ${CLUSTER_LOCATION}

Untuk cluster pribadi:
- Jika sudah memiliki akses ke cluster pribadi dari klien tempat Anda akan menjalankan skrip migrasi, Anda dapat langsung ke langkah berikutnya.
- Jika cluster pribadi telah mengaktifkan master-authorized-network, Anda dapat mengaktifkan akses dari klien tempat Anda akan menjalankan skrip migrasi dengan menambahkan alamat IP klien ke daftar master-authorized-networks yang diizinkan:
```
gcloud container clusters update ${CLUSTER_NAME} \
    --region=${CLUSTER_LOCATION} \
    --enable-master-authorized-networks \
    --master-authorized-networks $(curl ifconfig.me)/32
```

Download skrip migrasi penayangan Knative:

TMP_DIR=$(mktemp -d)
gsutil cp gs://crfa-to-hub-upgrade/migration-addon.sh $TMP_DIR
cd $TMP_DIR
chmod +x ./migration-addon.sh

Jalankan perintah berikut untuk menonaktifkan "scaling to zero", jika tidak, penskalaan akan gagal dan menyebabkan error saat node master diupdate:
```
kubectl patch cm config-autoscaler -n knative-serving -p '{"data":{"enable-scale-to-zero": "false"}}'
```
Perhatikan bahwa langkah terakhir dalam proses upgrade dan migrasi ini adalah mengaktifkan kembali "penskalaan ke nol".

Langkah selanjutnya

Uninstal add-on GKE.