Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupgrade Apigee Hybrid ke versi 1.6

Ringkasan upgrade ke versi 1.6.9.

Upgrade ke Apigee Hybrid versi 1.6 mungkin memerlukan periode nonaktif:

Saat mengupgrade pengontrol Apigee ke versi 1.6.9, semua deployment Apigee akan mengalami mulai ulang berkelanjutan. Untuk meminimalkan periode nonaktif di lingkungan hybrid produksi selama mulai ulang berkelanjutan, pastikan Anda menjalankan minimal dua cluster (di region/pusat data yang sama atau berbeda). Alihkan semua traffic produksi ke satu cluster dan ambil cluster yang akan diupgrade secara offline, lalu lanjutkan dengan proses upgrade. Ulangi prosesnya untuk setiap cluster.
Jika Anda mengupgrade Anthos Service Mesh (ASM) ke versi 1.12.x, dari versi sebelum ASM versi 1.9, akan terjadi periode nonaktif selama beberapa detik dalam cluster yang sedang Anda upgrade saat ingress berubah di antara kedua versi tersebut.
Jika mengubah certificate authority saat mengupgrade ASM, Anda mungkin mengalami periode nonaktif di gateway masuk Anda. Lihat Bermigrasi ke Mesh CA untuk informasi selengkapnya.

Prosedur untuk mengupgrade Apigee Hybrid diatur dalam bagian berikut:

Cadangkan penginstalan hybrid Anda.
Periksa versi Kubernetes dan upgrade sebagaimana mestinya.
Instal hybrid runtime versi 1.6.9.
Upgrade ASM.

Prasyarat

Petunjuk upgrade ini mengasumsikan bahwa Anda telah menginstal Apigee Hybrid 1.5 dan ingin mengupgradenya ke versi 1.6.9. Jika Anda melakukan update dari versi sebelumnya, lihat petunjuk untuk Mengupgrade Apigee Hybrid ke versi 1.5.

Upgrade ke versi 1.6

Petunjuk ini menggunakan variabel lingkungan $APIGEECTL_HOME untuk direktori dalam sistem file tempat utilitas apigeectl diinstal. Jika diperlukan, cd ke direktori apigeectl Anda dan tentukan variabel dengan perintah berikut:
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Mac OS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
(Direkomendasikan) Buat salinan cadangan direktori $APIGEECTL_HOME/ versi 1.5 Anda. Contoh:
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.5-backup.tar.gz $APIGEECTL_HOME
```
(Direkomendasikan) Cadangkan database Cassandra dengan mengikuti petunjuk di Pencadangan dan pemulihan Cassandra

Upgrade platform Kubernetes Anda ke versi yang didukung oleh hybrid 1.6. Ikuti dokumentasi platform Anda jika memerlukan bantuan.

Klik untuk meluaskan daftar platform yang didukung

	Versi hybrid Apigee
Platform	1,5	1.6
Anthos⁽³⁾ (Google Cloud)	1,18.x 1,19.x	1,19.x 1,20.x 1,21.x
Anthos⁽³⁾ (AWS)	1,6.x 1,7.x 1,8.x⁽¹⁾	1,7.x 1,8.x⁽¹⁾ 1,9.3+ 1,10.x
Anthos⁽³⁾ (Azure)	T/A	1,8.x
Anthos⁽³⁾ (lokal - VMware)	1,6.x 1,7.x 1,8.x⁽¹⁾	1,7.x 1,8.x⁽¹⁾ 1,9.3+ 1,10.x
Anthos⁽³⁾ (Bare Metal)	1,6.x 1,7.x	1,7.x 1,8.2+ 1,9,3+ 1,10.x
Anthos⁽³⁾ (cluster terlampir - multi-cloud) Versi Kubernetes (EKS)	1,18.x 1,19.x	1,19.x 1,20.x 1,21.x
Anthos⁽³⁾ (cluster terlampir - multi-cloud) Versi Kubernetes (AKS)	1,18.x 1,19.x	1,19.x 1,20.x 1,21.x
Anthos⁽³⁾ (cluster terlampir - multi-cloud) Versi OpenShift	4,5 4,6 4,7	4,6 4,7 4,8
Anthos⁽³⁾ (cluster terlampir - multi-cloud) Versi Konvoy	1,7.x	1,7.x
Komponen	1,5	1.6
Anthos Service Mesh (ASM)⁽²⁾	1.7.x 1.8.x 1.9.x 1.12.x (untuk Apigee hybrid 1.5 yang dimulai dengan versi 1.5.9)	1.9.x 1.10.x 1.12.x (Apigee Hybrid versi 1.6.6 dan yang lebih baru)
JDK	JDK 11	JDK 11
cert-manager	1.2.0	1.2.0 1.5.4
Cassandra	3.11.6	3.11.6
⁽¹⁾ Di versi 1.8.2 dan yang lebih baru, ikuti petunjuk dalam dokumen ini: Konflik dengan cert-manager saat mengupgrade ke versi 1.8.2 atau yang lebih baru. ⁽²⁾ Hanya instal Versi ASM yang didukung. ⁽³⁾ Hanya instal Versi yang didukung Anthos.

Jika Anda menjalankan versi cert-manager sebelum v1.5.4, Anda harus mengupgradenya ke v1.5.4.

Periksa versi cert-manager saat ini menggunakan perintah berikut:

kubectl -n cert-manager get deployment -o yaml | grep 'image:'

Sesuatu yang mirip dengan yang berikut ini ditampilkan:

image: quay.io/jetstack/cert-manager-controller:v1.5.4
image: quay.io/jetstack/cert-manager-cainjector:v1.5.4
image: quay.io/jetstack/cert-manager-webhook:v1.5.4

Hapus deployment menggunakan perintah berikut:

$ kubectl delete -n cert-manager deployment cert-manager cert-manager-cainjector cert-manager-webhook

Upgrade cert-manager ke versi v1.5.4 menggunakan perintah berikut:

$ kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v1.5.4/cert-manager.yaml

Buat akun layanan apigee-runtime yang diperlukan untuk digunakan dengan token OAUTH Google. Gunakan alat create-service-account:
1. Buat akun layanan:
```
./tools/create-service-account --env prod --profile apigee-runtime
```
2. Tambahkan akun layanan baru ke file overrides.yaml Apigee:
```
envs:
 - name: "environment-name"
   … … …
   serviceAccountPaths:
     runtime: "path-to-service-account-file"
   … … …
```
Tambahkan properti udca.serviceAccountPath di tingkat teratas di file penggantian, selain entri di bagian envs. udca harus muncul di penggantian Anda dua kali, sekali di tingkat lingkungan dan sekali di tingkat organisasi, sejajar dengan connectAgent, logger, mart, metrics, dan watcher.
Contoh:
```
… … …

metrics:
  serviceAccountPath: "metrics-service-account-file"

udca:
  serviceAccountPath: "udca-service-account-file"

watcher:
  serviceAccountPath: "watcher-service-account-file"
… … …
```
Opsional: Jika berencana menggunakan Cloud Trace, pastikan akun layanan apigee-runtime Anda memiliki peran Google Cloud Trace (roles/cloudtrace.agent). Anda dapat melakukannya di UI Cloud Console > IAM & Admin > Service accounts atau dengan perintah berikut:
1. Dapatkan alamat email untuk akun layanan apigee-runtime Anda dengan perintah berikut:
```
gcloud iam service-accounts list --filter "apigee-runtime"
```
  Jika cocok dengan pola apigee-runtime@$ORG_NAME.iam.gserviceaccount.com, Anda dapat menggunakan pola tersebut di langkah berikutnya.
2. Tetapkan peran Agen Cloud Trace untuk akun layanan:
```
gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-runtime@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"
```
  Di mana: $PROJECT_ID adalah nama project Google Cloud tempat Apigee Hybrid diinstal.

Menginstal runtime hybrid 1.6.9

Pastikan Anda berada di direktori dasar hybrid (induk direktori tempat file apigeectl yang dapat dieksekusi berada):
```
cd $APIGEECTL_HOME/..
```

Download paket rilis untuk sistem operasi Anda menggunakan perintah berikut. Pastikan untuk memilih platform Anda di tabel berikut:

Linux

Linux 64 bit:

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_linux_64.tar.gz

Mac OS

Mac 64 bit:

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_mac_64.tar.gz

Windows

Windows 64 bit:

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_windows_64.zip

Ganti nama direktori apigeectl/ Anda saat ini menjadi nama direktori cadangan. Contoh:

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.5/

Mac OS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.5/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.5

Ekstrak konten file gzip yang didownload ke direktori dasar hybrid Anda. Direktori dasar hybrid adalah direktori tempat direktori apigeectl-v1.5 yang diganti namanya berada:
Linux
```
tar xvzf filename.tar.gz -C ./
```
Mac OS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
Secara default, konten tar diperluas ke direktori dengan versi dan platform dalam namanya. Misalnya: ./apigeectl_1.6.9-d591b23_linux_64. Ganti nama direktori tersebut menjadi apigeectl menggunakan perintah berikut:
Linux
```
mv directory-name-linux apigeectl
```
Mac OS
```
mv directory-name-mac apigeectl
```
Windows
```
rename directory-name-windows apigeectl
```
Ubah ke direktori apigeectl:
```
cd ./apigeectl
```
File apigeectl yang dapat dieksekusi ada di direktori ini.
Petunjuk ini menggunakan variabel lingkungan $APIGEECTL_HOME untuk direktori dalam sistem file tempat utilitas apigeectl diinstal. Jika diperlukan, cd ke direktori apigeectl Anda dan tentukan variabel dengan perintah berikut:
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Mac OS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
Verifikasi versi apigeectl dengan perintah version:
```
./apigeectl version
```
```
Version: 1.6.9
```
Pindah ke direktori hybrid-base-directory/hybrid-files. Direktori hybrid-files adalah tempat file konfigurasi seperti file penggantian, sertifikat, dan akun layanan berada. Contoh:
```
cd $APIGEECTL_HOME/../hybrid-files
```
Pastikan kubectl disetel ke konteks yang benar menggunakan perintah berikut. Konteks saat ini harus disetel ke cluster tempat Anda mengupgrade Apigee Hybrid.
```
kubectl config get-contexts | grep \*
```
Dalam direktori hybrid-files:
1. Perbarui link simbolis berikut ke $APIGEECTL_HOME. Link ini memungkinkan Anda menjalankan perintah apigeectl yang baru diinstal dari dalam direktori hybrid-files:
```
ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
```
2. Untuk memastikan symlink telah dibuat dengan benar, jalankan perintah berikut dan pastikan jalur link mengarah ke lokasi yang benar:
```
ls -l | grep ^l
```
3. Lakukan inisialisasi uji coba untuk memeriksa error:
```
${APIGEECTL_HOME}/apigeectl init -f ./overrides/OVERRIDES.yaml --dry-run=client
```
  Dengan OVERRIDES adalah nama file penggantian Anda.
4. Jika tidak ada error, lakukan inisialisasi hybrid 1.6.9:
```
${APIGEECTL_HOME}/apigeectl init -f ./overrides/OVERRIDES.yaml
```
5. Periksa status inisialisasi:
```
${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml
```
6. Periksa apakah ada error dengan uji coba perintah apply:
```
${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --dry-run=client
```
7. Jika tidak ada error, terapkan penggantian Anda. Pilih dan ikuti petunjuk untuk lingkungan produksi atau lingkungan demo/eksperimental, bergantung pada penginstalan Anda.
  Selama proses upgrade, setiap komponen akan melakukan mulai ulang berkelanjutan. Oleh karena itu, untuk lingkungan produksi, sebaiknya terapkan upgrade ke satu komponen pada satu waktu.
  Produksi
  
  Untuk lingkungan produksi, Anda harus mengupgrade setiap komponen hybrid satu per satu, dan memeriksa status komponen yang diupgrade sebelum melanjutkan ke komponen berikutnya.
  1. Pastikan Anda berada di direktori hybrid-files.
  2. Terapkan penggantian untuk mengupgrade Cassandra:
    ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --datastore
  3. Periksa penyelesaian:
    ${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml
    
    Tips: Jika check-ready gagal, Anda bisa mendapatkan informasi lebih lanjut tentang pod Anda dengan:
    kubectl -n NAMESPACE get pods
    
    Dengan NAMESPACE sebagai namespace hybrid Apigee Anda.
    
    Lanjutkan ke langkah berikutnya hanya jika pod sudah siap.
  4. Terapkan penggantian Anda untuk mengupgrade komponen Telemetry dan memeriksa penyelesaian:
    ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --telemetry
    
    ${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml
  5. Tampilkan komponen Redis:
    ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --redis
  6. Terapkan penggantian untuk mengupgrade komponen tingkat organisasi (MART, Watcher, dan Apigee Connect) dan periksa penyelesaian:
    ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --org
    
    ${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml
  7. Terapkan penggantian untuk mengupgrade lingkungan. Anda memiliki dua pilihan:
    
    Lingkungan menurut lingkungan: Terapkan penggantian Anda ke satu lingkungan dalam satu waktu dan periksa penyelesaiannya. Ulangi langkah ini untuk setiap lingkungan:
    ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --env ENV_NAME
    
    ${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml
    
    Dengan ENV_NAME adalah nama lingkungan yang Anda upgrade.
    
    Semua lingkungan sekaligus: Terapkan penggantian ke semua lingkungan sekaligus dan periksa penyelesaian:
    ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml --all-envs
    
    ${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml
  Demo/Eksperimental
  
  Di sebagian besar lingkungan demo atau eksperimental, Anda dapat menerapkan penggantian ke semua komponen sekaligus. Jika lingkungan demo/eksperimental Anda besar dan kompleks atau sangat meniru lingkungan produksi, Anda dapat menggunakan petunjuk untuk mengupgrade lingkungan produksi
  1. Pastikan Anda berada di direktori hybrid-files.
  2. ${APIGEECTL_HOME}/apigeectl apply -f ./overrides/OVERRIDES.yaml
  3. Periksa status:
    ${APIGEECTL_HOME}/apigeectl check-ready -f ./overrides/OVERRIDES.yaml

Upgrade ASM ke versi 1.12

Lakukan upgrade menggunakan dokumentasi ASM yang sesuai untuk platform Anda:

Petunjuk untuk menginstal dan mengonfigurasi ASM berbeda-beda bergantung pada platform Anda. Platform ini dibagi ke dalam kategori berikut:

GKE: Cluster Google Kubernetes Engine yang berjalan di Google Cloud.
Di luar Google Cloud: Cluster Anthos berjalan di:
- Cluster Anthos di VMware (GKE lokal)
- Anthos on bare metal
- Cluster Anthos di AWS
- Amazon EKS
Platform Kubernetes Lainnya: Cluster sesuai yang dibuat dan dijalankan di:
- AKS
- EKS
- OpenShift

GKE

Urutan upgrade ke versi ASM 1.12.9 untuk penginstalan hybrid Anda adalah sebagai berikut:

Bersiaplah untuk upgrade.
Instal ASM versi baru.
Hapus deployment, layanan, dan webhook versi ASM sebelumnya dari penginstalan Anda saat ini.
Upgrade gateway Anda dan konfigurasi webhook baru.

Untuk melakukan upgrade ke versi ASM 1.12.9 untuk hybrid di GKE:

Tinjau persyaratan di Upgrade Anthos Service Mesh, tetapi jangan lakukan upgrade terlebih dahulu.
Sebelum menginstal versi baru, tentukan revisi saat ini. Anda memerlukan informasi ini untuk menghapus deployment, layanan, dan webhook versi ASM sebelumnya dari penginstalan saat ini. Gunakan perintah berikut untuk menyimpan revisi istiod saat ini ke variabel lingkungan:
```
export DELETE_REV=$(kubectl get deploy -n istio-system -l app=istiod -o jsonpath={.items[].metadata.labels.'istio\.io\/rev'}'{"\n"}')
echo ${DELETE_REV}
```

Buat file overlay.yaml baru atau verifikasi bahwa overlay.yaml yang ada berisi konten berikut:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  revision: asm-1129-3
  components:
    ingressGateways:
      - name: istio-ingressgateway
        enabled: true
        k8s:
          nodeSelector:
            # default node selector, if different or not using node selectors, change accordingly.
            cloud.google.com/gke-nodepool: apigee-runtime
          resources:
            requests:
              cpu: 1000m
          service:
            type: LoadBalancer
            loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
            ports:
              - name: http-status-port
                port: 15021
              - name: http2
                port: 80
                targetPort: 8080
              - name: https
                port: 443
                targetPort: 8443
  meshConfig:
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

Ikuti petunjuk di bagian berikut dalam dokumentasi ASM:
Penting: Pastikan Anda mengikuti petunjuk untuk mengupgrade ASM dengan fitur opsional, dan untuk menyertakan overlay.yaml Anda.
1. Download asmcli
2. Memberikan izin admin cluster
3. Memvalidasi project dan cluster
4. Upgrade dengan fitur opsional. Berhenti sebelum memulai "bagian Upgrade Gateway"

Hapus webhook yang berubah dan validasi webhook:

cd ke direktori tempat Anda menginstal asmcli.
Simpan revisi baru saat ini dalam variabel lingkungan untuk digunakan dalam skrip guna menghapus webhook:
```
UPGRADE_REV="asm-1129-3"
```

buat skrip shell yang berisi perintah berikut:

#!/bin/bash

set -ex

PROJECT_ID="YOUR_PROJECT_ID"
CLUSTER_NAME="YOUR_CLUSTER_NAME"
CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

kubectl label namespace istio-system istio.io/rev=${UPGRADE_REV} istio-injection- --overwrite
kubectl rollout restart deployment -n istio-system
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAYistio-ingressgateway
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAY/istio-ingressgateway-connectors

if [[ "${DELETE_REV}" != "${UPGRADE_REV}" ]]; then
  kubectl apply -f out/asm/istio/istiod-service.yaml
  kubectl delete deploy -l app=istio-ingressgateway,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete deploy -l app=istio-ingressgateway-connectors,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete ValidatingWebhookConfiguration -l app=istiod,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete MutatingWebhookConfiguration -l app=sidecar-injector,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete IstioOperator installed-state-${DELETE_REV} -n istio-system --ignore-not-found=true
fi

Jalankan skrip untuk menghapus webhook saat ini.

Ikuti langkah-langkah di bagian Mengupgrade gateway untuk membuat webhook baru dan mengalihkan traffic ke gateway baru.

Di luar Google Cloud

Petunjuk ini mencakup upgrade ASM pada:

Cluster Anthos di VMware (GKE lokal)
Anthos on bare metal
Cluster Anthos di AWS
Amazon EKS

Urutan upgrade ke versi ASM 1.12.9 untuk penginstalan hybrid Anda adalah sebagai berikut:

Bersiaplah untuk upgrade.
Instal ASM versi baru.
Hapus webhook yang berubah dan validasi webhook dari penginstalan Anda saat ini.
Upgrade gateway Anda dan konfigurasi webhook baru.

Tinjau persyaratan di Upgrade Anthos Service Mesh, tetapi jangan lakukan upgrade terlebih dahulu.
Sebelum menginstal versi baru, tentukan revisi saat ini. Anda memerlukan informasi ini untuk menghapus memvalidasi webhook dan mengubah webhook dari penginstalan ASM saat ini. Gunakan perintah berikut untuk menyimpan revisi istiod saat ini ke variabel lingkungan:
```
export DELETE_REV=$(kubectl get deploy -n istio-system -l app=istiod -o jsonpath={.items[].metadata.labels.'istio\.io\/rev'}'{"\n"}')
echo ${DELETE_REV}
```

Buat file overlay.yaml baru atau verifikasi bahwa overlay.yaml yang ada berisi konten berikut:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  revision: asm-1129-3
  components:
    ingressGateways:
      - name: istio-ingressgateway
        enabled: true
        k8s:
          nodeSelector:
            # default node selector, if different or not using node selectors, change accordingly.
            cloud.google.com/gke-nodepool: apigee-runtime
          resources:
            requests:
              cpu: 1000m
          service:
            type: LoadBalancer
            loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
            ports:
              - name: http-status-port
                port: 15021
              - name: http2
                port: 80
                targetPort: 8080
              - name: https
                port: 443
                targetPort: 8443
  values:
    gateways:
      istio-ingressgateway:
        runAsRoot: true

  meshConfig:
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

Ikuti petunjuk di bagian berikut dalam dokumentasi ASM:
Penting: Pastikan Anda mengikuti petunjuk untuk mengupgrade ASM dengan fitur opsional, dan untuk menyertakan overlay.yaml Anda.
1. Download asmcli
2. Memberikan izin admin cluster
3. Memvalidasi project dan cluster
4. Upgrade dengan fitur opsional. Berhenti sebelum memulai "bagian Upgrade Gateway"

Hapus webhook yang berubah dan validasi webhook:

cd ke direktori tempat Anda menginstal asmcli.
Simpan revisi baru saat ini dalam variabel lingkungan untuk digunakan dalam skrip guna menghapus webhook:
```
UPGRADE_REV="asm-1129-3"
```

buat skrip shell yang berisi perintah berikut:

#!/bin/bash

set -ex

PROJECT_ID="YOUR_PROJECT_ID"
CLUSTER_NAME="YOUR_CLUSTER_NAME"
CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"


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


kubectl label namespace istio-system istio.io/rev=${UPGRADE_REV} istio-injection- --overwrite
kubectl rollout restart deployment -n istio-system
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAYistio-ingressgateway
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAY/istio-ingressgateway-connectors

if [[ "${DELETE_REV}" != "${UPGRADE_REV}" ]]; then
  kubectl apply -f out/asm/istio/istiod-service.yaml
  kubectl delete deploy -l app=istio-ingressgateway,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete deploy -l app=istio-ingressgateway-connectors,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete ValidatingWebhookConfiguration -l app=istiod,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete MutatingWebhookConfiguration -l app=sidecar-injector,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete IstioOperator installed-state-${DELETE_REV} -n istio-system --ignore-not-found=true
fi

Jalankan skrip untuk menghapus webhook saat ini.

Ikuti langkah-langkah di bagian Mengupgrade gateway untuk membuat webhook baru dan mengalihkan traffic ke gateway baru.

AKS / EKS

Dalam petunjuk ini, proses mengupgrade versi Anthos Service Mesh (ASM) istio-1.12.9-asm.3 di cluster Anthos yang terpasang sama dengan melakukan penginstalan baru.

Bersiap menginstal Anthos Service Mesh

Hapus webhook yang berubah dan validasi webhook:

cd ke direktori tempat Anda menginstal asmcli.
Simpan revisi baru saat ini dalam variabel lingkungan untuk digunakan dalam skrip guna menghapus webhook:
```
UPGRADE_REV="asm-1129-3"
```

buat skrip shell yang berisi perintah berikut:

#!/bin/bash

set -ex

kubectl label namespace istio-system istio.io/rev=${UPGRADE_REV} istio-injection- --overwrite
kubectl rollout restart deployment -n istio-system

if [[ "${DELETE_REV}" != "${UPGRADE_REV}" ]]; then
  kubectl apply -f out/asm/istio/istiod-service.yaml
  kubectl apply -f ASMCLI_OUTPUT_DIR/asm/istio/istiod-service.yaml ASMCLI_OUTPUT_DIR/istioctl tag set default --revision ${UPGRADE_REV}


  kubectl delete deploy -l app=istio-ingressgateway,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete ValidatingWebhookConfiguration -l app=istiod,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete MutatingWebhookConfiguration -l app=sidecar-injector,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete IstioOperator installed-state-${DELETE_REV} -n istio-system --ignore-not-found=true
fi

Jalankan skrip untuk menghapus webhook saat ini.

Linux

Download file penginstalan Anthos Service Mesh ke direktori kerja Anda saat ini:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-linux-amd64.tar.gz

Download file tanda tangan dan gunakan openssl untuk memverifikasi tanda tangan:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-linux-amd64.tar.gz.1.sig

openssl dgst -verify /dev/stdin -signature istio-1.12.9-asm.3-linux-amd64.tar.gz.1.sig istio-1.12.9-asm.3.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF

Ekstrak konten file ke lokasi mana pun di sistem file Anda. Misalnya, untuk mengekstrak konten ke direktori kerja saat ini:

tar xzf istio-1.12.9-asm.3-linux-amd64.tar.gz

Perintah ini membuat direktori penginstalan dalam direktori kerja Anda saat ini bernama istio-1.12.9-asm.3 yang berisi:

Contoh aplikasi di direktori samples.
Alat command line istioctl yang Anda gunakan untuk menginstal Anthos Service Mesh berada di direktori bin.
Profil konfigurasi Anthos Service Mesh ada di direktori manifests/profiles.

Pastikan Anda berada di direktori utama penginstalan Anthos Service Mesh:

cd istio-1.12.9-asm.3

Untuk memudahkan, tambahkan alat dalam direktori /bin ke PATH Anda:

export PATH=$PWD/bin:$PATH

Mac OS

Download file penginstalan Anthos Service Mesh ke direktori kerja Anda saat ini:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-osx.tar.gz

Download file tanda tangan dan gunakan openssl untuk memverifikasi tanda tangan:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-osx.tar.gz.1.sig

openssl dgst -sha256 -verify /dev/stdin -signature istio-1.12.9-asm.3-osx.tar.gz.1.sig istio-1.12.9-asm.3.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF

Ekstrak konten file ke lokasi mana pun di sistem file Anda. Misalnya, untuk mengekstrak konten ke direktori kerja saat ini:

tar xzf istio-1.12.9-asm.3-osx.tar.gz

Perintah ini membuat direktori penginstalan dalam direktori kerja Anda saat ini bernama istio-1.12.9-asm.3 yang berisi:

Contoh aplikasi di direktori samples.
Alat command line istioctl yang Anda gunakan untuk menginstal Anthos Service Mesh berada di direktori bin.
Profil konfigurasi Anthos Service Mesh ada di direktori manifests/profiles.

Pastikan Anda berada di direktori utama penginstalan Anthos Service Mesh:

cd istio-1.12.9-asm.3

Untuk memudahkan, tambahkan alat dalam direktori /bin ke PATH Anda:

export PATH=$PWD/bin:$PATH

Windows

Download file penginstalan Anthos Service Mesh ke direktori kerja Anda saat ini:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-win.zip

Download file tanda tangan dan gunakan openssl untuk memverifikasi tanda tangan:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-win.zip.1.sig

openssl dgst -verify - -signature istio-1.12.9-asm.3-win.zip.1.sig istio-1.12.9-asm.3.win.zip <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF

Ekstrak konten file ke lokasi mana pun di sistem file Anda. Misalnya, untuk mengekstrak konten ke direktori kerja saat ini:

tar xzf istio-1.12.9-asm.3-win.zip

Perintah ini membuat direktori penginstalan dalam direktori kerja Anda saat ini bernama istio-1.12.9-asm.3 yang berisi:

Contoh aplikasi di direktori samples.
Alat command line istioctl yang Anda gunakan untuk menginstal Anthos Service Mesh berada di direktori bin.
Profil konfigurasi Anthos Service Mesh ada di direktori manifests\profiles.

Pastikan Anda berada di direktori utama penginstalan Anthos Service Mesh:

cd istio-1.12.9-asm.3

Untuk memudahkan, tambahkan alat dalam direktori \bin ke PATH Anda:

set PATH=%CD%\bin:%PATH%

Setelah ASM Istio terinstal, periksa versi istioctl:
```
istioctl version
```
Buat namespace yang disebut istio-system untuk komponen bidang kontrol:
```
kubectl create namespace istio-system
```

Menginstal Anthos Service Mesh

Edit file overlay.yaml Anda atau buat yang baru dengan konten berikut:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    accessLogFile: /dev/stdout
    enableTracing: true
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
  components:
  - enabled: true
    name: istio-ingressgateway
    k8s:
      service:
        type: LoadBalancer
        ports:
        - name: status-port
          port: 15021
          targetPort: 15021
        - name: http2
          port: 80
          targetPort: 8080
        - name: https
          port: 443
          targetPort: 8443

Instal Anthos Service Mesh dengan istioctl menggunakan profil asm-multicloud:

istioctl install \
    --set profile=asm-multicloud \
    --set revision="asm-1129-3" \
    --filename overlayfile.yaml

Output Anda akan terlihat seperti ini:

kubectl get pods -n istio-system
NAME                                   READY   STATUS    RESTARTS   AGE
istio-ingressgateway-88b6fd976-flgp2   1/1     Running   0          3m13s
istio-ingressgateway-88b6fd976-p5dl9   1/1     Running   0          2m57s
istiod-asm-1129-3-798ffb964-2ls88       1/1     Running   0          3m21s
istiod-asm-1129-3-798ffb964-fnj8c       1/1     Running   1          3m21s

Argumen --set revision menambahkan label revisi dalam format istio.io/rev=asm-1129-3 ke istiod. Label revisi digunakan oleh webhook injektor file bantuan otomatis untuk mengaitkan file sespan yang diinjeksikan dengan revisi lokasi tertentu. Untuk mengaktifkan injeksi otomatis file bantuan untuk namespace, Anda harus melabelinya dengan revisi yang cocok dengan label pada istiod.

Pastikan bahwa penginstalan Anda selesai:

kubectl get svc -n istio-system

Output Anda akan terlihat seperti ini:

NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                                                                      AGE
istio-ingressgateway   LoadBalancer   172.200.48.52    34.74.177.168   15021:30479/TCP,80:30030/TCP,443:32200/TCP,15012:32297/TCP,15443:30244/TCP   3m35s
istiod                 ClusterIP      172.200.18.133   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        4m46s
istiod-asm-1129-3       ClusterIP      172.200.63.220   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        3m43s

OpenShift

Dalam petunjuk ini, proses mengupgrade versi Anthos Service Mesh (ASM) istio-1.12.9-asm.3 di cluster Anthos yang terpasang sama dengan melakukan penginstalan baru.

Bersiap menginstal Anthos Service Mesh

Hapus webhook yang berubah dan validasi webhook:

cd ke direktori tempat Anda menginstal asmcli.
Simpan revisi baru saat ini dalam variabel lingkungan untuk digunakan dalam skrip guna menghapus webhook:
```
UPGRADE_REV="asm-1129-3"
```

buat skrip shell yang berisi perintah berikut:

#!/bin/bash

set -ex

kubectl label namespace istio-system istio.io/rev=${UPGRADE_REV} istio-injection- --overwrite
kubectl rollout restart deployment -n istio-system
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAYistio-ingressgateway

if [[ "${DELETE_REV}" != "${UPGRADE_REV}" ]]; then
  kubectl apply -f out/asm/istio/istiod-service.yaml
  kubectl delete deploy -l app=istio-ingressgateway,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete deploy -l app=istio-ingressgateway-connectors,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete ValidatingWebhookConfiguration -l app=istiod,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete MutatingWebhookConfiguration -l app=sidecar-injector,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete IstioOperator installed-state-${DELETE_REV} -n istio-system --ignore-not-found=true
fi

Jalankan skrip untuk menghapus webhook saat ini.

Linux

Berikan batasan konteks keamanan (SCC) anyuid ke istio-system dengan perintah OpenShift CLI (oc) berikut:

oc adm policy add-scc-to-group anyuid system:serviceaccounts:istio-system

Download file penginstalan Anthos Service Mesh ke direktori kerja Anda saat ini:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-linux-amd64.tar.gz

Download file tanda tangan dan gunakan openssl untuk memverifikasi tanda tangan:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-linux-amd64.tar.gz.1.sig

openssl dgst -verify /dev/stdin -signature istio-1.12.9-asm.3-linux-amd64.tar.gz.1.sig istio-1.12.9-asm.3.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF

Ekstrak konten file ke lokasi mana pun di sistem file Anda. Misalnya, untuk mengekstrak konten ke direktori kerja saat ini:

tar xzf istio-1.12.9-asm.3-linux-amd64.tar.gz

Perintah ini membuat direktori penginstalan dalam direktori kerja Anda saat ini bernama istio-1.12.9-asm.3 yang berisi:

Contoh aplikasi di direktori samples.
Alat command line istioctl yang Anda gunakan untuk menginstal Anthos Service Mesh berada di direktori bin.
Profil konfigurasi Anthos Service Mesh ada di direktori manifests/profiles.

Pastikan Anda berada di direktori utama penginstalan Anthos Service Mesh:

cd istio-1.12.9-asm.3

Untuk memudahkan, tambahkan alat dalam direktori /bin ke PATH Anda:

export PATH=$PWD/bin:$PATH

Mac OS

Berikan batasan konteks keamanan (SCC) anyuid ke istio-system dengan perintah OpenShift CLI (oc) berikut:

oc adm policy add-scc-to-group anyuid system:serviceaccounts:istio-system

Download file penginstalan Anthos Service Mesh ke direktori kerja Anda saat ini:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-osx.tar.gz

Download file tanda tangan dan gunakan openssl untuk memverifikasi tanda tangan:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-osx.tar.gz.1.sig

openssl dgst -sha256 -verify /dev/stdin -signature istio-1.12.9-asm.3-osx.tar.gz.1.sig istio-1.12.9-asm.3.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF

Ekstrak konten file ke lokasi mana pun di sistem file Anda. Misalnya, untuk mengekstrak konten ke direktori kerja saat ini:

tar xzf istio-1.12.9-asm.3-osx.tar.gz

Perintah ini membuat direktori penginstalan dalam direktori kerja Anda saat ini bernama istio-1.12.9-asm.3 yang berisi:

Contoh aplikasi di direktori samples.
Alat command line istioctl yang Anda gunakan untuk menginstal Anthos Service Mesh berada di direktori bin.
Profil konfigurasi Anthos Service Mesh ada di direktori manifests/profiles.

Pastikan Anda berada di direktori utama penginstalan Anthos Service Mesh:

cd istio-1.12.9-asm.3

Untuk memudahkan, tambahkan alat dalam direktori /bin ke PATH Anda:

export PATH=$PWD/bin:$PATH

Windows

Berikan batasan konteks keamanan (SCC) anyuid ke istio-system dengan perintah OpenShift CLI (oc) berikut:

oc adm policy add-scc-to-group anyuid system:serviceaccounts:istio-system

Download file penginstalan Anthos Service Mesh ke direktori kerja Anda saat ini:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-win.zip

Download file tanda tangan dan gunakan openssl untuk memverifikasi tanda tangan:

curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.12.9-asm.3-win.zip.1.sig

openssl dgst -verify - -signature istio-1.12.9-asm.3-win.zip.1.sig istio-1.12.9-asm.3.win.zip <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF

Ekstrak konten file ke lokasi mana pun di sistem file Anda. Misalnya, untuk mengekstrak konten ke direktori kerja saat ini:

tar xzf istio-1.12.9-asm.3-win.zip

Perintah ini membuat direktori penginstalan dalam direktori kerja Anda saat ini bernama istio-1.12.9-asm.3 yang berisi:

Contoh aplikasi di direktori samples.
Alat command line istioctl yang Anda gunakan untuk menginstal Anthos Service Mesh berada di direktori bin.
Profil konfigurasi Anthos Service Mesh ada di direktori manifests\profiles.

Pastikan Anda berada di direktori utama penginstalan Anthos Service Mesh:

cd istio-1.12.9-asm.3

Untuk memudahkan, tambahkan alat dalam direktori \bin ke PATH Anda:

set PATH=%CD%\bin:%PATH%

Setelah ASM Istio terinstal, periksa versi istioctl:
```
istioctl version
```
Buat namespace yang disebut istio-system untuk komponen bidang kontrol:
```
kubectl create namespace istio-system
```

Menginstal Anthos Service Mesh

Edit file overlay.yaml Anda atau buat yang baru dengan konten berikut:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    accessLogFile: /dev/stdout
    enableTracing: true
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
  components:
  - enabled: true
    name: istio-ingressgateway
    k8s:
      service:
        type: LoadBalancer
        ports:
        - name: status-port
          port: 15021
          targetPort: 15021
        - name: http2
          port: 80
          targetPort: 8080
        - name: https
          port: 443
          targetPort: 8443

Instal Anthos Service Mesh dengan istioctl menggunakan profil asm-multicloud:

istioctl install \
    --set profile=asm-multicloud \
    --set revision="asm-1129-3" \
    --filename overlayfile.yaml

Output Anda akan terlihat seperti ini:

kubectl get pods -n istio-system
NAME                                   READY   STATUS    RESTARTS   AGE
istio-ingressgateway-88b6fd976-flgp2   1/1     Running   0          3m13s
istio-ingressgateway-88b6fd976-p5dl9   1/1     Running   0          2m57s
istiod-asm-1129-3-798ffb964-2ls88       1/1     Running   0          3m21s
istiod-asm-1129-3-798ffb964-fnj8c       1/1     Running   1          3m21s

Argumen --set revision menambahkan label revisi dalam format istio.io/rev=1.6.11-asm.1 ke istiod. Label revisi digunakan oleh webhook injektor file bantuan otomatis untuk mengaitkan file sespan yang diinjeksikan dengan revisi lokasi tertentu. Untuk mengaktifkan injeksi otomatis file bantuan untuk namespace, Anda harus melabelinya dengan revisi yang cocok dengan label pada istiod.

Pastikan bahwa penginstalan Anda selesai:

kubectl get svc -n istio-system

Output Anda akan terlihat seperti ini:

NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                                                                      AGE
istio-ingressgateway   LoadBalancer   172.200.48.52    34.74.177.168   15021:30479/TCP,80:30030/TCP,443:32200/TCP,15012:32297/TCP,15443:30244/TCP   3m35s
istiod                 ClusterIP      172.200.18.133   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        4m46s
istiod-asm-1129-3       ClusterIP      172.200.63.220   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        3m43s

Me-roll back upgrade

Ikuti langkah-langkah berikut untuk me-roll back upgrade sebelumnya:

Bersihkan tugas yang sudah selesai untuk namespace runtime hybrid, dengan NAMESPACE adalah namespace yang ditentukan dalam file penggantian Anda, jika Anda menentukan namespace. Jika tidak, namespace default-nya adalah apigee:
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Membersihkan tugas yang sudah selesai untuk namespace apigee-system:

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

Ubah variabel APIGEECTL_HOME agar mengarah ke direktori yang berisi apigeectl versi sebelumnya. Contoh:
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```

Di direktori utama penginstalan yang ingin Anda roll back, jalankan ${APIGEECTL_HOME}/apigeectl apply, periksa status pod Anda, lalu jalankan ${APIGEECTL_HOME}/apigeectl init. Pastikan untuk menggunakan file penggantian asli untuk versi yang ingin Anda roll back:

Dalam direktori hybrid-files, jalankan ${APIGEECTL_HOME}/apigeectl apply:

${APIGEECTL_HOME}/apigeectl apply -f ./overrides/ORIGINAL_OVERRIDES.yaml

Periksa status pod Anda:
```
kubectl -n NAMESPACE get pods
```
Dengan NAMESPACE sebagai namespace hybrid Apigee Anda.

Periksa status apigeeds:

kubectl describe apigeeds -n apigee

Output Anda akan terlihat seperti ini:

Status:
  Cassandra Data Replication:
  Cassandra Pod Ips:
    10.8.2.204
  Cassandra Ready Replicas:  1
  Components:
    Cassandra:
      Last Successfully Released Version:
        Revision:  v1-f8aa9a82b9f69613
        Version:   v1
      Replicas:
        Available:  1
        Ready:      1
        Total:      1
        Updated:    1
      State:        running
  Scaling:
    In Progress:         false
    Operation:
    Requested Replicas:  0
  State:                 running

Lanjutkan ke langkah berikutnya hanya saat ßpod apigeeds berjalan.

Jalankan apigeectl init:

${APIGEECTL_HOME}/apigeectl init -f ./overrides/ORIGINAL_OVERRIDES.yaml

Mengupgrade Apigee Hybrid ke versi 1.6

Ringkasan upgrade ke versi 1.6.9.

Prasyarat

Upgrade ke versi 1.6

Linux

Mac OS

Windows

Klik untuk meluaskan daftar platform yang didukung

Platform

Komponen

Menginstal runtime hybrid 1.6.9

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Produksi

Demo/Eksperimental

Upgrade ASM ke versi 1.12

GKE

Di luar Google Cloud

AKS / EKS

Bersiap menginstal Anthos Service Mesh

Linux

Mac OS

Windows

Menginstal Anthos Service Mesh

OpenShift

Bersiap menginstal Anthos Service Mesh

Linux

Mac OS

Windows

Menginstal Anthos Service Mesh

Me-roll back upgrade