Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupgrade Apigee Hybrid ke versi 1.9

Prosedur ini mencakup upgrade dari Apigee Hybrid versi 1.8.x ke Apigee Hybrid versi 1.9.4 dan dari rilis Hybrid 1.9.x sebelumnya ke versi 1.9.4.

Gunakan prosedur yang sama untuk upgrade versi minor (misalnya versi 1.8 ke 1.9) dan untuk upgrade rilis patch (misalnya 1.9.0 ke 1.9.4).

Jika Anda melakukan upgrade dari Apigee Hybrid versi 1.7 atau yang lebih lama, Anda harus mengupgrade ke Hybrid versi 1.8 terlebih dahulu sebelum mengupgrade ke versi 1.9.4. Lihat petunjuk untuk Mengupgrade Apigee Hybrid ke versi 1.8.

Mulai dari versi 1.9.0, Apigee Hybrid hanya mendukung gateway ingress Apigee sebagai lapisan ingress.

Ringkasan upgrade ke versi 1.9.4

Mengupgrade ke Apigee Hybrid versi 1.9 mungkin memerlukan periode nonaktif.

Saat mengupgrade pengontrol Apigee ke versi 1.9.4, semua deployment Apigee akan mengalami mulai ulang bertahap. Untuk meminimalkan periode nonaktif di lingkungan hybrid produksi selama memulai ulang bertahap, pastikan Anda menjalankan minimal dua cluster (di region/pusat data yang sama atau berbeda). Alihkan semua traffic produksi ke satu cluster dan nonaktifkan cluster yang akan diupgrade, lalu lanjutkan proses upgrade. Ulangi proses untuk setiap cluster.

Apigee merekomendasikan agar Anda mengupgrade semua cluster sesegera mungkin untuk mengurangi kemungkinan dampak pada produksi. Tidak ada batas waktu kapan semua cluster yang tersisa harus diupgrade setelah cluster pertama diupgrade. Namun, hingga semua cluster yang tersisa diupgrade, operasi berikut akan terpengaruh:

Pencadangan dan pemulihan Cassandra tidak dapat berfungsi dengan versi campuran. Misalnya, cadangan dari Hybrid 1.8 tidak dapat digunakan untuk memulihkan instance Hybrid 1.9.
Streaming data Cassandra tidak akan berfungsi di antara versi Hybrid campuran. Oleh karena itu, cluster Cassandra Anda tidak dapat diskalakan secara horizontal.
Perluasan dan penonaktifan region akan terpengaruh, karena operasi ini bergantung pada streaming data Cassandra.

Prosedur untuk mengupgrade Apigee Hybrid diatur dalam bagian berikut:

Bersiap untuk mengupgrade.
Instal hybrid runtime versi 1.9.4.

Prasyarat

Petunjuk upgrade ini mengasumsikan Anda telah menginstal Apigee hybrid versi 1.8.x dan ingin mengupgradenya ke versi 1.9.4. Jika Anda melakukan update dari versi sebelumnya, lihat petunjuk untuk Mengupgrade Apigee Hybrid ke versi 1.8.
Di Apigee Hybrid versi 1.8, kami memperkenalkan gateway ingress Apigee sebagai lapisan ingress alternatif untuk Anthos Service Mesh. Mulai versi 1.9.0, Apigee Hybrid mengharuskan penggunaan gateway ingress Apigee dan tidak lagi mendukung penggunaan Anthos Service Mesh untuk ingress. Jika penginstalan yang Anda upgrade menggunakan Anthos Service Mesh, Anda harus bermigrasi terlebih dahulu untuk menggunakan gateway ingress Apigee sebelum mengupgrade ke versi 1.9.4.
Gateway masuk Apigee menggunakan sebagian kecil fitur Anthos Service Mesh untuk gateway masuk. Pengelolaan dan upgrade fitur tersebut ditangani secara otomatis oleh Apigee Hybrid. Oleh karena itu, Anda tidak memerlukan keahlian Anthos Service Mesh untuk menginstal, mengupgrade, dan mengelola gateway ingress hybrid Apigee.

Lihat Memigrasikan ke gateway ingress Apigee dalam dokumentasi hybrid v1.8 untuk mengetahui petunjuknya.

Bersiap untuk mengupgrade ke versi 1.9

Mencadangkan penginstalan hybrid Anda (direkomendasikan)

Petunjuk ini menggunakan variabel lingkungan APIGEECTL_HOME untuk direktori dalam sistem file tempat Anda menginstal apigeectl. Jika perlu, ubah direktori 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%
```

Buat salinan cadangan direktori $APIGEECTL_HOME/ versi 1.8 Anda. Contoh:

tar -czvf $APIGEECTL_HOME/../apigeectl-v1.8-backup.tar.gz $APIGEECTL_HOME

Cadangkan database Cassandra Anda dengan mengikuti petunjuk di Pencadangan dan pemulihan Cassandra.

Tambahkan peran Cloud Trace Agent ke akun layanan untuk runtime Apigee. (Opsional)

Opsional: Jika Anda berencana menggunakan Cloud Trace dan belum menambahkan peran Cloud Trace Agent ke penginstalan hybrid v1.8, pastikan akun layanan untuk layanan runtime Apigee Anda memiliki peran IAM Google Cloud Cloud Trace Agent (roles/cloudtrace.agent).

Untuk lingkungan produksi, akun layanan runtime adalah apigee-runtime. Untuk lingkungan non-produksi, akun layanan runtime adalah apigee-non-prod.

Anda dapat menambahkan peran di UI Cloud console > IAM & Admin > Service accounts atau dengan perintah berikut:

Dapatkan alamat email untuk akun layanan Anda dengan perintah berikut:
Produksi
```
gcloud iam service-accounts list --filter "apigee-runtime"
```
Jika alamat email cocok dengan pola apigee-runtime@$ORG_NAME.iam.gserviceaccount.com, Anda dapat menggunakan pola tersebut pada langkah berikutnya.
Non-Prod
```
gcloud iam service-accounts list --filter "apigee-non-prod"
```
Jika cocok dengan pola apigee-non-prod@$ORG_NAME.iam.gserviceaccount.com, Anda dapat menggunakan pola tersebut pada langkah berikutnya.

Tetapkan peran Cloud Trace Agent ke akun layanan:

Produksi

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-runtime@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Non-Prod

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-non-prod@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Contoh

gcloud projects add-iam-policy-binding hybrid-example-project \
    --member="serviceAccount:apigee-runtime@hybrid-example-project.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Dengan: $PROJECT_ID adalah nama project Google Cloud tempat Apigee hybrid diinstal.

Catatan:Jika penginstalan Anda menggunakan nama kustom untuk akun layanan, ganti nama tersebut dengan apigee-runtime atau apigee-non-prod dalam perintah.

Instal gateway ingress Apigee jika penginstalan Anda menggunakan Anthos Service Mesh

Mulai versi 1.9, Apigee hybrid tidak lagi mendukung penggunaan Anthos Service Mesh untuk ingress. Jika penginstalan hybrid Anda menggunakan Anthos Service Mesh, Anda harus memigrasikan penginstalan saat ini ke gateway ingress Apigee sebelum menginstal versi hybrid 1.9.

Tambahkan properti ingressGateways ke file penggantian Anda.
Sintaksis
```
  ingressGateways:
  - name: INGRESS_NAME
    replicaCountMin: REPLICAS_MIN
    replicaCountMax: REPLICAS_MAX
    resources:
      requests:
        cpu: CPU_COUNT_REQ
        memory: MEMORY_REQ
      limits:
        cpu: CPU_COUNT_LIMIT
        memory: MEMORY_LIMIT
    svcAnnotations:  # optional.
      SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional
```
Contoh
```
  ingressGateways:
  - name: prod1
    replicaCountMin: 2
    replicaCountMax: 100
    resources:
      requests:
        cpu: 1
        memory: 1Gi
      limits:
        cpu: 2
        memory: 2Gi
    svcAnnotations:  # optional. See Known issue 243599452.
      networking.gke.io/load-balancer-type: "Internal"
    svcLoadBalancerIP: 198.252.0.123 
```
- INGRESS_NAME adalah nama deployment ingress. Nama ini dapat berupa nama apa pun yang memenuhi persyaratan berikut:
  - Memiliki panjang maksimum 17 karakter
  - Hanya berisi karakter alfanumerik huruf kecil, '-', atau '.'
  - Diawali dengan karakter alfanumerik
  - Diakhiri dengan karakter alfanumerik
  Lihat ingressGateways[].name di Referensi properti konfigurasi.
- REPLICAS_MIN dan REPLICAS_MAX adalah jumlah replika minimum dan maksimum untuk gateway ingress Apigee dalam penginstalan Anda. Untuk mengetahui informasi dan setelan default selengkapnya, lihat ingressGateways[].replicaCountMin dan ingressGateways[].replicaCountMax di Referensi properti konfigurasi.
- CPU_COUNT_REQ dan MEMORY_REQ adalah permintaan CPU dan memori untuk setiap replika gateway ingress Apigee dalam penginstalan Anda.
  Tetapkan properti ini jika sebelumnya Anda telah menetapkannya untuk gateway masuk Anthos Service Mesh, misalnya di file overlay.yaml.
  
  Untuk mengetahui informasi dan setelan default selengkapnya, lihat ingressGateways[].resources.requests.cpu dan ingressGateways[].resources.requests.memory di Referensi properti konfigurasi.
- CPU_COUNT_LIMIT dan MEMORY_LIMIT adalah batas CPU dan memori maksimum untuk setiap replika gateway ingress Apigee dalam penginstalan Anda.
  Tetapkan properti ini jika sebelumnya Anda telah menetapkannya untuk gateway masuk Anthos Service Mesh, misalnya di file overlay.yaml.
  
  Untuk mengetahui informasi dan setelan default selengkapnya, lihat ingressGateways[].resources.limits.cpu dan ingressGateways[].resources.limits.memory di Referensi properti konfigurasi.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opsional):
  Catatan: Kolom ingressGateways[].svcAnnotations di overrides.yaml tidak berfungsi seperti yang diharapkan. Lihat Masalah umum 243599452
  
  Ini adalah key-value pair yang menyediakan anotasi untuk layanan ingress default Anda. Anotasi digunakan oleh platform cloud Anda untuk membantu mengonfigurasi penginstalan hybrid Anda, misalnya, menetapkan jenis load balancer ke internal atau eksternal. Contoh:
```
ingressGateways:
    svcAnnotations:
      networking.gke.io/load-balancer-type: "Internal"
```
  Anotasi bervariasi dari satu platform ke platform lainnya. Lihat dokumentasi platform Anda untuk mengetahui anotasi wajib dan yang disarankan.
  
  Catatan: Anda tidak perlu menyetel Annotations jika membuat layanan Kubernetes sendiri untuk deployment ingress seperti yang didokumentasikan dalam Mengekspos gateway ingress Apigee.
  Lihat ingressGateways[].svcAnnotations di referensi properti Konfigurasi.
- SVC_LOAD_BALANCER_IP (opsional) Memungkinkan Anda menetapkan alamat IP statis untuk load balancer. Di platform yang mendukung penentuan alamat IP load balancer, load balancer akan dibuat dengan alamat IP ini. Di platform yang tidak mengizinkan Anda menentukan alamat IP load balancer, properti ini diabaikan.
  Jika Anda tidak memiliki alamat IP statis yang dialokasikan untuk load balancer, jangan sertakan properti ini dalam file penggantian Anda.
  
  Perhatian: Pastikan untuk tidak menentukan alamat IP yang sama dengan istio-ingressgateway saat ini. Hal ini dapat menyebabkan masalah saat layanan tersebut masih ada di cluster.
  
  Catatan: Anda tidak perlu menyetel LoadBalancerIP jika membuat layanan Kubernetes sendiri untuk deployment ingress seperti yang didokumentasikan dalam Mengekspos gateway ingress Apigee.
  Lihat ingressGateways[].svcLoadBalancerIP di referensi properti Konfigurasi.
Terapkan perubahan untuk menginstal gateway ingress Apigee dengan perintah berikut:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```
Ekspos gateway masuk Apigee. Ikuti prosedur di Mengekspos gateway ingress Apigee.
Uji gateway masuk baru Anda dengan memanggil proxy. Sebaiknya, uji semua proxy penting yang saat ini Anda deploy.
Untuk mengalihkan traffic, perbarui data DNS Anda agar mengarah ke alamat IP untuk gateway ingress Apigee baru Anda. Bergantung pada penyedia DNS Anda, Anda mungkin dapat mengalihkan traffic secara bertahap ke endpoint baru.
Tips: Anda dapat menemukan alamat IP eksternal gateway ingress Apigee dengan perintah berikut:
```
kubectl get svc -n apigee -l app=apigee-ingressgateway
```
Output Anda akan terlihat seperti ini:
```
NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
```
Pastikan semua traffic runtime berfungsi dengan memantau dasbor Anda. Lanjutkan ke langkah berikutnya hanya jika semuanya berfungsi seperti yang diharapkan. Pastikan tidak ada traffic yang melewati gateway masuk lama Anda (Anthos Service Mesh), karena pembaruan DNS mungkin lambat diterapkan karena caching DNS.
Untuk menghentikan Apigee menyediakan konfigurasi ke Anthos Service Mesh, ikuti langkah-langkah di Menghentikan penyediaan konfigurasi ke ASM dalam panduan Mengelola gateway ingress Apigee.
Uji ulang dan pantau traffic proxy API.
Ikuti petunjuk dalam dokumentasi Anthos Service Mesh untuk Meng-uninstal Anthos Service Mesh dari cluster.

Menginstal runtime hybrid 1.9.4

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

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

Linux

Linux 64 bit:

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

Mac OS

Mac 64 bit:

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

Windows

Windows 64 bit:

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

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

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

Mac OS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.8

Ekstrak konten file gzip yang didownload ke direktori dasar hybrid Anda. Direktori dasar hybrid adalah direktori tempat direktori apigeectl-v1.8 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 ./
```
Konten tar secara default diekstrak ke dalam direktori dengan versi dan platform di namanya. Misalnya: ./apigeectl_1.9.4-xxxxxxx_linux_64. Ganti nama direktori tersebut menjadi apigeectl menggunakan perintah berikut:
Linux
```
mv apigeectl_1.9.4-xxxxxxx_linux_64 apigeectl
```
Mac OS
```
mv apigeectl_1.9.4-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.9.4-xxxxxxx_windows_64 apigeectl
```
Ubah ke direktori apigeectl:
```
cd ./apigeectl
```
Direktori ini adalah direktori beranda apigeectl. Di sinilah perintah yang dapat dieksekusi apigeectl berada.
Petunjuk ini menggunakan variabel lingkungan $APIGEECTL_HOME untuk direktori dalam sistem file tempat utilitas apigeectl diinstal. Jika perlu, ubah direktori 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.9.4
```
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 \*
```
Di direktori hybrid-files:
1. Perbarui link simbolis berikut ke $APIGEECTL_HOME. Dengan link ini, Anda dapat 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 memeriksa apakah symlink dibuat dengan benar, jalankan perintah berikut dan pastikan jalur link mengarah ke lokasi yang benar:
```
ls -l | grep ^l
```
Lakukan inisialisasi uji coba untuk memeriksa error:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
Dengan OVERRIDES_FILE adalah nama file penggantian Anda, misalnya ./overrides/overrides.yaml.

Tips: Anda dapat mengganti OVERRIDES_FILE dalam contoh kode di atas dengan nama dan jalur ke file penggantian Anda, dan setiap instance di halaman ini akan diganti.
Jika tidak ada error, lakukan inisialisasi hybrid 1.9.4:
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
Catatan: apigeectl menginstal dan mengonfigurasi gateway ingress Apigee saat Anda menjalankan apigeectl init.
Periksa status inisialisasi:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Jika berhasil, output-nya akan menampilkan: All containers ready.
```
kubectl describe apigeeds -n apigee
```
Di output, cari State: running.
Periksa error dengan uji coba perintah apply menggunakan flag --dry-run:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
Jika tidak ada error, terapkan penggantian Anda. Pilih dan ikuti petunjuk untuk lingkungan produksi atau lingkungan non-produksi, bergantung pada penginstalan Anda.
Produksi

Untuk lingkungan produksi, upgrade setiap komponen hybrid satu per satu, dan periksa 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_FILE --datastore
3. Penyelesaian pemeriksaan:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  Tips: Jika check-ready gagal, Anda bisa mendapatkan informasi lebih lanjut tentang pod dengan:
  kubectl -n NAMESPACE get pods
  
  Dengan NAMESPACE adalah namespace Apigee Hybrid Anda.
  Lanjutkan ke langkah berikutnya hanya jika pod sudah siap.
4. Terapkan penggantian untuk mengupgrade komponen Telemetri dan memeriksa penyelesaian:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
5. Aktifkan komponen Redis:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
6. Terapkan penggantian untuk mengupgrade komponen tingkat org. (MART, Watcher, dan Apigee Connect) dan periksa penyelesaian:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
7. Terapkan penggantian untuk mengupgrade lingkungan Anda. Anda memiliki dua pilihan:
  - Lingkungan demi 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_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    Dengan ENV_NAME adalah nama lingkungan yang Anda upgrade.
  - Semua lingkungan sekaligus: Terapkan penggantian ke semua lingkungan sekaligus dan periksa penyelesaiannya:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. Terapkan penggantian Anda untuk mengupgrade komponen virtualhosts dan periksa penyelesaiannya:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
Non-prod

Di sebagian besar lingkungan non-produksi, demo, atau eksperimental, Anda dapat menerapkan penggantian ke semua komponen sekaligus. Jika lingkungan non-produksi Anda besar dan kompleks atau sangat mirip dengan lingkungan produksi, sebaiknya gunakan petunjuk untuk mengupgrade lingkungan produksi.
1. Pastikan Anda berada di direktori hybrid-files.
2. $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
3. Periksa status:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

Instal `1.9.4-hotfix.1`

Ikuti langkah-langkah berikut untuk menginstal rilis perbaikan cepat, 1.9.4-hotfix.1:

Sebelum melakukan langkah-langkah ini, Anda harus menggunakan Apigee Hybrid versi 1.9.4 atau yang lebih baru. Jika Anda belum menggunakan versi 1.9.4 atau yang lebih baru, lakukan upgrade ke versi 1.9.4 sebelum melanjutkan.
Buka file overrides.yaml.

Di stanza istiod, ubah versi tag gambar (jika ada) ke versi 1.17.7. Contoh:

istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.7-asm.0-distroless"

Bergantung pada cara Anda memilih untuk menginstal Apigee hybrid, Anda mungkin memiliki stanza ingressGateway atau ingressGateways. Temukan stanza yang muncul di file penggantian Anda dan ubah versi tag gambar (jika ada) ke versi 1.17.7. Misalnya, jika Anda memiliki stanza ingressGateway:

ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.7-asm.0-distroless"

atau, jika Anda memiliki stanza ingressGateways:

ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...

Simpan file.

Jalankan perintah berikut untuk melakukan inisialisasi komponen istiod:

$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE

$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

Jalankan perintah berikut untuk menerapkan perubahan pada komponen ingress Apigee. Jika Anda memiliki lebih dari satu organisasi, ulangi perintah ini untuk setiap organisasi:
```
$APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```

Verifikasi status pod Anda:

kubectl get pods -n YOUR_APIGEE_NAMESPACE

Mengupgrade versi Kubernetes

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

Klik untuk meluaskan daftar platform yang didukung

	Versi Apigee Hybrid
Platform	1.6 ⁽³⁾	1.7 ⁽³⁾	1,8 ⁽³⁾	1.9	1.10
Anthos (Google Cloud - GKE)	1.19.x 1.20.x 1.21.x	1.20.x 1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.21.x ^{(≤ 1.8.3)} 1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
Anthos (AWS)	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	1.10.x 1.11.x 1.12.x 1.13.x 1.25⁽¹³⁾	1.12.x 1.13.x 1.25⁽¹³⁾	1.13.x 1.25⁽¹³⁾ 1.26⁽¹³⁾
Anthos (Azure)	1.8.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	1.10.x 1.11.x 1.12.x 1.13.x 1.14.x	1.12.x 1.13.x 1.14.x	1.13.x 1.14.x 1.15.x
Anthos (lokal - VMware)⁽¹⁾	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x
Anthos (Bare Metal)⁽¹⁾	1.7.x 1.8.2+ 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x
EKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
AKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
OpenShift⁽⁷⁾	4.6 4.7 4.8	4.7 4.8	4.8 4.9 4.10	4.10 4.11	4.11 4.12
Rancher Kubernetes Engine (RKE)⁽⁷⁾	T/A	T/A	T/A	1.3.8	v1.26.2+rke2r1
Komponen	1.6 ⁽³⁾	1.7 ⁽³⁾	1,8	1.9	1.10
Anthos Service Mesh (ASM)	1.9.x 1.10.x 1.12.x 1.13.x	1.10.x 1.11.x 1.12.x 1.13.x ^{(≥ 1.7.2)} 1.14.x 1.15.x ^{(≥ 1.7.6)}	1.11.x 1.12.x 1.13.x 1.14.x 1.15.x	1.17.x⁽¹¹⁾	1.17.x⁽¹¹⁾
JDK	JDK 11	JDK 11	JDK 11	JDK 11	JDK 11
cert-manager	1.5.4	1.7.x	1.7.x 1.8.x 1.9.x 1.10.x 1.11.x	1.10.x 1.11.x	1.10.x 1.11.x 1.12.x
Cassandra	3.11.10	3.11.10	3.11.10	3.11.10	3.11.10
⁽¹⁾ Pada Anthos versi 1.8, 1.9, dan 1.10, ikuti petunjuk dalam dokumen ini untuk menghindari konflik dengan `cert-manager`: Anthos 1.8.2+: Konflik dengan `cert-manager` saat mengupgrade ke versi 1.8.2 atau yang lebih tinggi. Anthos 1.9: Konflik dengan `cert-manager` saat mengupgrade ke versi 1.9.0 atau 1.9.1. Anthos 1.10+: Penginstalan `cert-manager` yang bertentangan. ⁽²⁾ Dukungan tersedia dengan Apigee Hybrid versi 1.7.2 dan yang lebih baru. ⁽³⁾ Tanggal EOL resmi untuk Apigee Hybrid versi 1.8 dan yang lebih lama telah tercapai. Patch bulanan reguler tidak tersedia lagi. Rilis ini tidak lagi didukung secara resmi, kecuali untuk pelanggan yang mendapatkan pengecualian eksplisit dan resmi untuk dukungan berkelanjutan. Pelanggan lain harus mengupgrade. ⁽⁴⁾Anthos on Bare Metal dan VMWare versi 1.12 dan yang lebih lama tidak lagi didukung. Lihat Kebijakan Dukungan Versi Anthos on Bare Metal dan versi cluster Anthos di VMware. ⁽⁵⁾Anthos on Bare Metal dan VMWare memerlukan ASM 1.14 atau yang lebih baru. Sebaiknya Anda mengupgrade ke hybrid v1.8 dan beralih ke gateway ingress Apigee yang tidak lagi memerlukan Anda untuk menginstal ASM di cluster hybrid. ⁽⁶⁾ Dukungan tersedia dengan Apigee Hybrid versi 1.8.4 dan yang lebih baru. ⁽⁷⁾ Cluster terlampir tidak diperlukan untuk Apigee Hybrid v1.8 dan yang lebih baru menggunakan ingressgateway Apigee.. ⁽⁸⁾ Tidak didukung dengan Apigee Hybrid versi 1.8.4 dan yang lebih baru. ⁽⁹⁾ Dukungan tersedia dengan Apigee Hybrid versi 1.7.6 dan yang lebih baru. ⁽¹⁰⁾ Tidak didukung dengan Apigee Hybrid versi 1.8.5 dan yang lebih baru. ⁽¹¹⁾ ASM diinstal secara otomatis dengan Apigee Hybrid 1.9 dan yang lebih baru. ⁽¹²⁾ Dukungan tersedia dengan Apigee Hybrid versi 1.9.2 dan yang lebih baru. ⁽¹³⁾ Nomor versi cluster Anthos di AWS (Multi-Cloud) kini mencerminkan versi Kubernetes. Lihat Dukungan upgrade dan versi Anthos untuk mengetahui detail versi dan patch yang direkomendasikan.

Tentang cluster terpasang

Untuk Apigee Hybrid versi 1.7.x dan yang lebih lama, Anda harus menggunakan cluster terlampir Anthos jika ingin menjalankan Apigee Hybrid dalam konteks multi-cloud di Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS), atau penyedia layanan Kubernetes pihak ketiga lain yang didukung. Penyambungan cluster memungkinkan Google mengukur penggunaan Anthos Service Mesh (ASM). Mendaftarkan cluster pihak ketiga bersifat opsional. Daftar hanya jika Anda ingin melihat cluster terlampir di Google Cloud console. Untuk mengetahui informasi selengkapnya, lihat Melampirkan cluster Kubernetes pihak ketiga ke Google Cloud.

Untuk Apigee Hybrid versi 1.8.x, cluster terpasang Anthos diperlukan jika Anda menggunakan Anthos Service Mesh untuk gateway ingress Anda. Jika Anda menggunakan gateway ingress Apigee, cluster Anthos yang terpasang bersifat opsional.

Me-roll back upgrade

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

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

Hapus tugas yang telah 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 root penginstalan yang ingin Anda kembalikan, jalankan apigeectl apply, periksa status pod Anda, lalu jalankan apigeectl init. Pastikan untuk menggunakan file penggantian asli untuk versi yang ingin Anda roll back:

Di direktori hybrid-files, jalankan apigeectl apply:
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
Dengan ORIGINAL_OVERRIDES_FILE adalah jalur relatif dan nama file penggantian untuk penginstalan hybrid versi sebelumnya, misalnya, ./overrides/overrides1.8.yaml.
Periksa status pod Anda:
```
kubectl -n NAMESPACE get pods
```
Dengan NAMESPACE adalah namespace Apigee Hybrid 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 jika pod apigeeds sedang berjalan.

Jalankan perintah berikut untuk mencatat nilai jumlah replika baru Anda untuk pemroses pesan setelah upgrade. Jika nilai ini tidak cocok dengan yang telah Anda tetapkan sebelumnya, ubah nilai dalam file penggantian agar cocok dengan konfigurasi sebelumnya.
```
apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2
```
Output Anda akan terlihat seperti ini:
```
      autoScaler:
        minReplicas: 2
        maxReplicas: 10
```

Jalankan apigeectl init:

$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE

Mengupgrade Apigee Hybrid ke versi 1.9 Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan upgrade ke versi 1.9.4

Prasyarat

Bersiap untuk mengupgrade ke versi 1.9

Mencadangkan penginstalan hybrid Anda (direkomendasikan)

Linux

Mac OS

Windows

Tambahkan peran Cloud Trace Agent ke akun layanan untuk runtime Apigee. (Opsional)

Produksi

Non-Prod

Produksi

Non-Prod

Contoh

Instal gateway ingress Apigee jika penginstalan Anda menggunakan Anthos Service Mesh

Sintaksis

Contoh

Menginstal runtime hybrid 1.9.4

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Produksi

Non-prod

Instal 1.9.4-hotfix.1

Mengupgrade versi Kubernetes

Klik untuk meluaskan daftar platform yang didukung

Platform

Komponen

Tentang cluster terpasang

Me-roll back upgrade

Mengupgrade Apigee Hybrid ke versi 1.9

Instal `1.9.4-hotfix.1`