Mengelola gateway masuk Apigee

Saat ini Anda melihat versi 1.11 dari dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.11 

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Mengonfigurasi gateway traffic masuk Apigee

Anda dapat mengonfigurasi gateway ingress di overrides.yaml. Contoh:

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 gateway masuk. 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 Jumlah replika minimum dan maksimum untuk gateway ingress Apigee dalam penginstalan Anda. Lihat ingressGateways[].replicaCountMin dan ingressGateways[].replicaCountMax di Referensi properti konfigurasi.
• CPU_COUNT_REQ dan MEMORY_REQ Permintaan CPU dan memori untuk setiap replika gateway ingress Apigee dalam penginstalan Anda.
  Tetapkan properti ini jika sebelumnya Anda telah menetapkannya untuk gateway ingress Anthos Service Mesh di Apigee Hybrid versi 1.8 atau yang lebih lama, misalnya di file overlay.yaml.

  Lihat ingressGateways[].resources.requests.cpu dan ingressGateways[].resources.requests.memory di Referensi properti konfigurasi.

• CPU_COUNT_LIMIT dan MEMORY_LIMIT Batas CPU dan memori maksimum untuk setiap replika gateway ingress Apigee dalam penginstalan Anda.
  Tetapkan properti ini jika sebelumnya Anda telah menetapkannya untuk gateway ingress Anthos Service Mesh di Apigee Hybrid versi 1.8 atau yang lebih lama, misalnya di file overlay.yaml.

  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. Platform cloud Anda menggunakan anotasi untuk membantu mengonfigurasi penginstalan hybrid Anda, misalnya menyetel 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 yang diperlukan dan disarankan.

  Catatan: Anda tidak perlu menyetel Annotations di sini jika membuat layanan Kubernetes sendiri untuk deployment gateway ingress seperti yang didokumentasikan dalam Mengekspos gateway ingress Apigee.
  Lihat ingressGateways[].svcAnnotations di referensi properti Konfigurasi.
• SVC_LOAD_BALANCER_IP (opsional). Di platform yang mendukung penentuan alamat IP load balancer, load balancer akan dibuat dengan alamat IP ini. Di platform yang tidak memungkinkan Anda menentukan alamat IP load balancer, properti ini diabaikan.
  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 menetapkan LoadBalancerIP jika membuat layanan Kubernetes sendiri untuk deployment gateway ingress seperti yang didokumentasikan dalam Mengekspos gateway ingress Apigee.
  Lihat ingressGateways[].svcLoadBalancerIP di referensi properti Konfigurasi.

Menerapkan konfigurasi gateway masuk Apigee

Menerapkan perubahan pada cakupan organisasi:

Helm

helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

Catatan: Jika Anda melihat error yang menyatakan Error: UPGRADE FAILED: "ORG_NAME" has no deployed releases, ganti upgrade dengan install, lalu coba lagi perintahnya.

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org

Tugas pengelolaan

Beberapa tugas pengelolaan umum untuk gateway ingress Apigee:

Menskalakan gateway masuk Apigee:

Perbarui properti berikut dalam file penggantian Anda.

• ingressGateways[].replicaCountMax
• ingressGateways[].replicaCountMin

Lihat ingressGateways di Referensi properti konfigurasi untuk mengetahui detailnya.

Terapkan perubahan:

Helm

helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org

Memperbarui alokasi resource

Perbarui properti berikut dalam file penggantian Anda.

• ingressGateways[].resources.limits.cpu
• ingressGateways[].resources.limits.memory
• ingressGateways[].resources.requests.cpu
• ingressGateways[].resources.requests.memory

Lihat ingressGateways di Referensi properti konfigurasi untuk mengetahui detailnya.

Terapkan perubahan:

Helm

helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org

Memperbarui layanan gateway ingress Apigee

Perbarui properti berikut dalam file penggantian Anda.

• ingressGateways[].svcAnnotations
• ingressGateways[].svcLoadBalancerIP

Lihat ingressGateways di Referensi properti konfigurasi untuk mengetahui detailnya.

Terapkan perubahan:

Helm

helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org

Nonaktifkan load balancer untuk layanan gateway masuk Apigee default:

Jika membuat layanan Kubernetes kustom untuk deployment gateway ingress, Anda dapat menonaktifkan pembuatan load balancer di layanan Kubernetes default. Perbarui properti ingressGateways[].svcType menjadi ClusterIP di file penggantian Anda. Contoh:

ingressGateways:
  - name: my-ingress-gateway
    replicaCountMin: 2
    replicaCountMax: 10
    svcType: ClusterIP

Terapkan perubahan:

Helm

helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org

Mengonfigurasi TLS dan mTLS

Lihat Mengonfigurasi TLS dan mTLS di gateway masuk.

Mengaktifkan klien non-SNI

Lihat Mengaktifkan klien non-SNI dan HTTP.

Menginstal gateway traffic masuk Apigee tambahan

Di file overrides.yaml, Anda dapat menambahkan beberapa gateway ingress. Properti konfigurasi ingressGateways adalah array. Untuk mengetahui informasi selengkapnya, lihat ingressGateways di Referensi properti konfigurasi.

Contoh:

ingressGateways:
- name: fruit
  replicaCountMin: 2
  replicaCountMax: 10

- name: meat
  replicaCountMin: 2
  replicaCountMax: 10

Terapkan perubahan:

Helm

helm upgrade ORG_NAME apigee-org/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --org

Memetakan host virtual ke deployment gateway ingress Apigee

Anda dapat menggunakan label pemilih untuk memetakan host virtual ke deployment gateway ingress Apigee. Dalam contoh berikut, host virtual spam-vh dikonfigurasi untuk berjalan di gateway ingress berlabel meat dan dua host virtual lainnya berjalan di gateway ingress fruit. Gateway ingress harus diberi label dengan benar, seperti yang dijelaskan dalam Menginstal gateway Anthos Service Mesh tambahan.

Catatan: Anda harus menentukan kedua pemilih: selector:app dan selector:ingress_name untuk menerapkan gateway ingress dengan benar ke host virtual.

Tips: Untuk tujuan keamanan, sebaiknya gunakan pasangan kunci/sertifikat TLS terpisah untuk setiap host virtual. Jika Anda menggunakan sertifikat Subject Alternative Name (SAN), pasangan kunci/sertifikat TLS ini harus digunakan di satu host virtual yang dibagikan di seluruh domain.

virtualhosts:
- name: spam-vh
  sslCertPath: cert-spam.crt
  sslKeyPath: cert-spam.key
  selector:
    app: apigee-ingressgateway
    ingress_name: meat
- name: banana-vh
  sslCertPath: cert-banana.crt
  sslKeyPath: cert-banana.key
  selector:
    app: apigee-ingressgateway
    ingress_name: fruit
- name: plum-vh
  sslCertPath: cert-plum.crt
  sslKeyPath: cert-plum.key
  selector:
    app: apigee-ingressgateway
    ingress_name: fruit

    

Menambahkan ciphersuite kustom ke deployment gateway ingress Apigee

Anda dapat menambahkan ciphersuite kustom ke deployment gateway ingress Apigee dengan properti virtualhosts.cipherSuites dalam file penggantian.

Lihat virtualhosts.cipherSuites untuk ciphersuite default yang diaktifkan di Apigee Hybrid.

Anda dapat mengaktifkan versi TLS yang lebih lama dengan properti virtualhosts.minTLSProtocolVersion dan menambahkan ciphersuite kustom ke deployment gateway ingress Apigee dengan properti virtualhosts.cipherSuites dalam file penggantian Anda.

Misalnya, untuk mengaktifkan TLS v.1.1:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.1"
  cipherSuites:
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-CHACHA20-POLY1305"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-RSA-AES256-SHA"
  ...

Catatan: Properti ini menggantikan daftar cipher suite yang didukung oleh Envoy, dan tidak menambahkannya.

Menyesuaikan log akses Ingress

Anda dapat menyesuaikan tujuan dan format log akses gateway ingress Apigee dengan properti konfigurasi istiod.accessLogFile dan istiod.accessLogFormat. Dalam contoh berikut, output akan dikirim ke /dev/stdout, yang merupakan nilai default untuk istiod.accessLogFile:

istiod:
  accessLogFormat: '{"request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","status":"%RESPONSE_CODE%"}'

Anda dapat menonaktifkan logging akses gateway ingress Apigee dengan menetapkan istiod.accessLogFile dan nilai kosong. Contoh:

istiod:
  accessLogFile: ''

FAQ

Bagaimana cara kerjanya dengan penginstalan Anthos Service Mesh/Istio yang ada di namespace lain?

Selama Apigee diinstal di namespace khusus - gateway ingress Apigee dapat dijalankan bersama dengan penginstalan Anthos Service Mesh/Istio yang sudah ada di cluster. Gateway ingress Apigee tidak menyimpan konfigurasi apa pun di apiserver sehingga tidak akan ada konflik.

Siapa yang bertanggung jawab untuk mengupgrade komponen gateway ingress Apigee?

Apigee menangani upgrade komponen gateway ingress Apigee yang terjadi selama upgrade hybrid reguler dan rilis patch.

Bagaimana cara mengekspos port 80 di gateway masuk Apigee?

Port 80 tidak didukung oleh gateway ingress Apigee. Jika Anda bermigrasi dari Anthos Service Mesh ke gateway ingress Apigee, dan Anda mengikuti petunjuk di postingan komunitas untuk mengaktifkan Port 80, gateway tersebut tidak akan berfungsi dengan gateway Ingress Apigee.