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 penggunaan gateway masuk Apigee.

Gateway masuk Apigee di Apigee Hybrid versi 1.8

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

Dua skenario untuk melakukan migrasi adalah:

  • Migrasi multi-cluster atau multi-region (direkomendasikan):

    Sebelum beralih ke Ingress baru untuk Apigee, pindahkan semua traffic ke cluster lain atau dari cluster yang akan Anda migrasikan. Ini akan memberi Anda waktu untuk menguji apakah Gateway masuk Apigee berfungsi sesuai harapan. Kemudian, alihkan traffic kembali ke versi yang telah diupgrade .

  • Upgrade yang sudah ada (tidak direkomendasikan di lingkungan produksi):

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

Menginstal gateway masuk Apigee

  1. Untuk menginstal gateway masuk Apigee, Anda perlu menambahkan ingressGateways ke file penggantian Anda.

    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 masuk. Ini dapat berupa nama apa pun yang memenuhi persyaratan berikut:
      • Memiliki panjang maksimum 17 karakter
      • Hanya berisi karakter alfanumerik huruf kecil, '-' atau '.'
      • Awali 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 masuk Apigee di 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 masing-masing instance gateway masuk Apigee di dalam penginstalan Anda.

      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 maksimum CPU dan memori untuk setiap replika gateway masuk Apigee dalam penginstalan.

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

      Ini adalah pasangan nilai kunci yang memberikan pada anotasi layanan masuk default Anda. Anotasi digunakan oleh platform {i>cloud<i} Anda untuk membantu mengkonfigurasi instalasi hybrid, misalnya mengatur jenis load balancer internal atau eksternal. Contoh:

      ingressGateways:
        svcAnnotations:
          networking.gke.io/load-balancer-type: "Internal"

      Anotasi bervariasi dari satu platform ke platform yang lain. Lihat platform Anda untuk anotasi yang diperlukan dan disarankan.

      Lihat ingressGateways[].svcAnnotations di referensi properti Konfigurasi.
    • SVC_LOAD_BALANCER_IP (opsional) Memungkinkan Anda menetapkan alamat IP statis untuk dengan load balancer Jaringan Passthrough Eksternal Regional. 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, tinggalkan properti ini dari file penggantian.

      Lihat ingressGateways[].svcLoadBalancerIP di referensi properti Konfigurasi.
  2. Terapkan perubahan untuk menginstal gateway masuk 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 masuk Apigee, ikuti langkah-langkah dalam Mengalihkan traffic dari Anthos Service Mesh ke gateway masuk Apigee di topik Mengupgrade ke Apigee Hybrid v1.8.