Bermigrasi ke gateway Apigee Ingress

Gunakan prosedur ini untuk memigrasikan penginstalan Apigee hybrid v1.8 yang ada dari penggunaan Anthos Service Mesh untuk traffic masuk ke penggunaan 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 ingress untuk penginstalan hybrid Anda, gateway ingress Apigee. 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 ingress Apigee yang baru.

Dua skenario untuk 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 begitu, Anda akan memiliki waktu untuk menguji apakah gateway masuk Apigee yang baru berfungsi seperti yang diharapkan. Kemudian, alihkan traffic kembali ke cluster yang diupgrade.

  • Upgrade di tempat (tidak direkomendasikan di lingkungan produksi):

    Selama upgrade, Apigee akan memunculkan gateway ingress baru dengan alamat IP baru. Kemudian, Anda dapat menguji apakah gateway masuk Apigee yang baru berfungsi seperti yang diharapkan, lalu mengalihkan traffic ke ingress baru. Mungkin ada periode nonaktif selama upgrade ini.

Menginstal gateway traffic masuk Apigee

  1. Untuk menginstal gateway ingress Apigee, Anda perlu menambahkan 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 bisa 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.

      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.

      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):

      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.

      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.

      Lihat ingressGateways[].svcLoadBalancerIP di referensi properti Konfigurasi.
  2. 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 dalam Mengalihkan traffic dari Anthos Service Mesh ke gateway ingress Apigee dalam topik Upgrade ke Apigee Hybrid v1.8.