Gunakan prosedur ini untuk memigrasikan penginstalan Apigee hybrid v1.8 yang ada dari menggunakan Anthos Service Mesh untuk traffic masuk ke menggunakan gateway traffic masuk Apigee.
Gateway ingress Apigee di Apigee hybrid versi 1.8
Mulai versi 1.8, Apigee hybrid menawarkan fitur baru untuk mengelola gateway masuk untuk penginstalan hybrid Anda, gateway masuk Apigee. Anthos Service Mesh tidak lagi menjadi prasyarat untuk penginstalan hybrid dan Apigee akan berhenti menyediakan konfigurasi pemilihan rute ke Anthos Service Mesh. Setelah upgrade, Anda harus memigrasikan traffic ke gateway gateway gateway Apigee yang baru.
Dua skenario untuk melakukan migrasi adalah:
- Migrasi multi-cluster atau multi-region (direkomendasikan):
Sebelum beralih ke Ingress baru untuk Apigee, kosongkan semua traffic ke cluster atau region lain dari cluster yang Anda migrasikan. Tindakan ini akan memberi Anda waktu untuk menguji apakah gateway gateway masuk Apigee yang baru berfungsi seperti yang diharapkan. Kemudian, alihkan traffic kembali ke cluster yang diupgrade.
- Upgrade langsung (tidak direkomendasikan di lingkungan produksi):
Selama upgrade, Apigee akan menampilkan gateway masuk baru dengan alamat IP baru. Kemudian, Anda dapat menguji apakah gateway masuk Apigee yang baru berfungsi seperti yang diharapkan, lalu mengalihkan traffic ke masuk yang baru. Mungkin ada periode nonaktif selama upgrade ini.
Menginstal gateway traffic masuk Apigee
-
Untuk menginstal gateway ingress Apigee, Anda perlu menambahkan properti
ingressGateways
ke file penggantian.Sintaks
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. See Known issue 243599452. 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 '.'
- Dimulai dengan karakter alfanumerik
- Diakhiri dengan karakter alfanumerik
ingressGateways[].name
di referensi Properti konfigurasi. - REPLICAS_MIN dan REPLICAS_MAX adalah jumlah replika minimum dan maksimum untuk gateway masuk Apigee dalam penginstalan Anda. Untuk informasi selengkapnya dan setelan default, lihat
ingressGateways[].replicaCountMin
daningressGateways[].replicaCountMax
di referensi Properti konfigurasi. - CPU_COUNT_REQ dan MEMORY_REQ adalah permintaan CPU dan memori untuk setiap replika gateway masuk Apigee dalam penginstalan Anda.
Untuk informasi selengkapnya dan setelan default, lihat
ingressGateways[].resources.requests.cpu
daningressGateways[].resources.requests.memory
dalam referensi Properti konfigurasi. - CPU_COUNT_LIMIT dan MEMORY_LIMIT adalah batas CPU dan memori maksimum untuk setiap replika gateway masuk Apigee di penginstalan Anda.
Untuk informasi selengkapnya dan setelan default, lihat
ingressGateways[].resources.limits.cpu
daningressGateways[].resources.limits.memory
dalam referensi Properti konfigurasi. - SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opsional):
Ini adalah key-value pair yang menyediakan anotasi untuk layanan ingress default Anda. Anotasi digunakan oleh platform cloud Anda untuk membantu mengonfigurasi penginstalan hybrid, 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 yang lain. Lihat dokumentasi platform Anda untuk mengetahui anotasi yang diperlukan dan disarankan.
LihatingressGateways[].svcAnnotations
di referensi Properti konfigurasi. - SVC_LOAD_BALANCER_IP (opsional) Memungkinkan Anda menetapkan alamat IP statis untuk load balancer. Pada 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 akan diabaikan.
Jika Anda tidak memiliki alamat IP statis yang dialokasikan untuk load balancer, hapus properti ini dari file penggantian.
LihatingressGateways[].svcLoadBalancerIP
di referensi Properti konfigurasi.
- INGRESS_NAME adalah nama deployment ingress. Nama ini dapat berupa nama apa pun
yang memenuhi persyaratan berikut:
- Terapkan perubahan untuk menginstal gateway ingress Apigee dengan perintah berikut:
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
Mengalihkan traffic ke gateway masuk Apigee
Untuk memigrasikan traffic dari Anthos Service Mesh ke gateway ingress Apigee, ikuti langkah-langkah di artikel Beralih traffic dari Anthos Service Mesh ke gateway ingress Apigee dalam topik Mengupgrade ke Apigee Hybrid v1.8.