Alibaba Cloud Service Mesh:Migrasi konfigurasi NGINX umum ke gerbang ASM

Perbedaan konfigurasi gerbang ASM dengan NGINX

NGINX mengonsolidasikan semua pengaturan dalam satu ConfigMap, sedangkan ASM membagi konfigurasi ke dalam tiga jenis resource Istio:

Untuk menerapkan pengaturan yang telah dipetakan, buat atau perbarui resource Istio yang sesuai di kluster Anda.

Parameter koneksi dan keepalive

Parameter ini mengontrol pooling koneksi, perilaku keepalive, dan batas koneksi. Di ASM, sebagian besar dipetakan ke bagian connectionPool dalam DestinationRule.

apiVersion: networking.istio.io/v1
kind: DestinationRule
metadata:
  name: my-service-pool
spec:
  host: my-service.prod.svc.cluster.local
  trafficPolicy:
    connectionPool:
      tcp:
        maxConnections: 100
      http:
        maxRequestsPerConnection: 1000
        idleTimeout: 60s

Parameter timeout

apiVersion: networking.istio.io/v1
kind: DestinationRule
metadata:
  name: my-service-timeout
spec:
  host: my-service.prod.svc.cluster.local
  trafficPolicy:
    connectionPool:
      http:
        connectTimeout: 30s

Parameter penanganan header

Parameter ini mengontrol cara header diproses, dihasilkan, dan divalidasi.

Parameter NGINX	Perilaku NGINX	Padanan ASM
allow-backend-server-header	Mengizinkan backend mengembalikan header Server miliknya sendiri alih-alih string default NGINX.	Diaktifkan secara default pada gerbang ASM. Default: true.
enable-underscores-in-headers	Mengizinkan garis bawah dalam nama header HTTP.	Dipetakan ke parameter Envoy headers_with_underscores_action. Default: true.
ignore-invalid-headers	Mengabaikan header dengan nama tidak valid. Nama yang valid terdiri dari huruf, angka, dan tanda hubung. Dukungan garis bawah bergantung pada pengaturan underscores_in_headers.	Envoy menggunakan Header Validator. Tanpa konfigurasi eksplisit, Envoy menerapkan validasi default dan mengembalikan respons 400 Bad Request untuk header yang tidak valid.
generate-request-id	Menghasilkan nilai acak untuk header X-Request-ID jika header tersebut tidak ada dalam permintaan masuk.	Dipetakan ke parameter Envoy generate_request_id. Default: true. Ubah melalui plugin ASM.
server-tokens	Mengontrol apakah NGINX mengirimkan versinya dalam header respons Server dan pada halaman kesalahan. Default: dinonaktifkan.	Gerbang ASM menetapkan header Server ke header Envoy secara default. Halaman kesalahan tidak menampilkan informasi versi.

Header forwarding dan proxy

Tiga parameter NGINX mengontrol perilaku header X-Forwarded-For. Di Istio, ketiganya dipetakan ke konfigurasi topologi jaringan gerbang.

Parameter TLS dan pengalihan

apiVersion: networking.istio.io/v1
kind: Gateway
metadata:
  name: my-gateway
spec:
  servers:
  - port:
      number: 80
      name: http
      protocol: HTTP
    hosts:
    - "example.com"
    tls:
      httpsRedirect: true  # Mengembalikan respons 301 untuk permintaan HTTP

Pencatatan log dan observabilitas

Batas ukuran badan permintaan

Parameter worker dan proses

Ekstensibilitas konfigurasi

Referensi

• Referensi ConfigMap Ingress NGINX – Daftar lengkap parameter ConfigMap NGINX Ingress Controller

• Referensi API Istio DestinationRule – Pengaturan pooling koneksi, load balancing, dan pemutus sirkuit

• Referensi API Istio Gateway – Listener port, terminasi TLS, dan pengalihan HTTPS

• Mengonfigurasi topologi jaringan gerbang – Pemrosesan X-Forwarded-For dan konfigurasi proxy tepercaya

• Header Validator Envoy – Aturan validasi header

• Mengonfigurasi pengaturan observabilitas – Penyesuaian log akses di Konsol ASM