Halaman ini diterjemahkan oleh Cloud Translation API.

Bermigrasi ke gateway Apigee Ingress

Gunakan prosedur ini untuk memigrasikan penginstalan Apigee hybrid v1.8 yang sudah ada dari menggunakan Anthos Service Mesh untuk traffic masuk ke gateway masuk Apigee.

Gateway masuk Apigee di Apigee Hybrid versi 1.8

Mulai versi 1.8, Apigee Hybrid menawarkan fitur baru untuk mengelola ingress gateway untuk penginstalan hybrid, yaitu Apigee ingress gateway. Anthos Service Mesh tidak lagi menjadi prasyarat untuk penginstalan hybrid dan Apigee akan berhenti menyediakan konfigurasi perutean ke Anthos Service Mesh. Setelah upgrade, Anda harus memigrasikan traffic ke gateway masuk Apigee yang baru.

Dua skenario 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. Dengan ini, Anda akan memiliki waktu untuk menguji apakah gateway masuk Apigee yang baru berfungsi sesuai harapan. Kemudian, alihkan traffic kembali ke cluster yang telah diupgrade.
Upgrade yang sudah dilakukan (tidak direkomendasikan di lingkungan produksi):
Selama upgrade, Apigee akan memunculkan gateway masuk baru dengan alamat IP baru. Selanjutnya, Anda dapat menguji apakah gateway masuk Apigee yang baru berfungsi sesuai harapan, kemudian mengalihkan traffic ke ingress baru. Kemungkinan akan ada periode nonaktif selama proses upgrade ini.

Menginstal gateway masuk Apigee

Untuk menginstal gateway masuk Apigee, Anda harus menambahkan properti ingressGateways ke file penggantian.
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. 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 dapat berupa nama apa pun yang memenuhi persyaratan berikut:
  - Memiliki panjang maksimum 17 karakter
  - Hanya berisi karakter alfanumerik huruf kecil, '-' atau '.'
  - Mulai dengan karakter alfanumerik
  - Akhiri dengan karakter alfanumerik
  Lihat 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 dan ingressGateways[].replicaCountMax dalam referensi Properti konfigurasi.
- CPU_COUNT_REQ dan MEMORY_REQ adalah permintaan CPU dan memori untuk setiap replika gateway masuk Apigee dalam penginstalan Anda.
  Tetapkan properti ini jika sebelumnya Anda telah menetapkannya untuk gateway ingress Anthos Service Mesh, misalnya dalam file overlay.yaml.
  
  Untuk informasi selengkapnya dan setelan default, lihat ingressGateways[].resources.requests.cpu dan ingressGateways[].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 dalam penginstalan Anda.
  Tetapkan properti ini jika sebelumnya Anda telah menetapkannya untuk gateway ingress Anthos Service Mesh, misalnya dalam file overlay.yaml.
  
  Untuk informasi selengkapnya dan setelan default, lihat ingressGateways[].resources.limits.cpu dan ingressGateways[].resources.limits.memory dalam 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 pasangan nilai kunci yang menyediakan anotasi untuk layanan masuk 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 lain. Lihat dokumentasi platform Anda untuk anotasi yang diperlukan dan disarankan.
  
  Catatan: Anda tidak perlu menetapkan Annotations jika membuat layanan Kubernetes sendiri untuk deployment ingress seperti yang didokumentasikan dalam Mengekspos ingress gateway Apigee.
  Lihat ingressGateways[].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. Pada 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, kosongkan properti ini dari file penggantian Anda.
  
  Perhatian: Pastikan Anda tidak menetapkan 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 menetapkan LoadBalancerIP jika akan membuat layanan Kubernetes sendiri untuk deployment ingress seperti yang didokumentasikan dalam Mengekspos ingress gateway Apigee.
  Lihat ingressGateways[].svcLoadBalancerIP di referensi Properti konfigurasi.
Terapkan perubahan untuk menginstal gateway masuk Apigee dengan perintah berikut:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```

Alihkan traffic ke gateway masuk Apigee

Untuk memigrasikan traffic dari Anthos Service Mesh ke gateway ingress Apigee, ikuti langkah-langkah di Beralih traffic dari Anthos Service Mesh ke Apigee ingress gateway dalam topik Upgrade ke Apigee Hybrid v1.8.