Alibaba Cloud Service Mesh:Yaygın Nginx yapılandırmalarını bir ASM ağ geçidine taşıma

Nginx yapılandırması

Açıklama

ASM ağ geçidi eşdeğeri

allow-backend-server-header

Arka ucun, genel bir Nginx dizesi yerine Server üst bilgisini döndürmesine olanak tanır.

ASM ağ geçidi bu davranışı varsayılan olarak etkinleştirir.

allow-snippet-annotations

Nginx yapılandırmasını değiştirmek amacıyla Ingress ek açıklamasında özel kod parçacıklarının kullanılmasına izin verir.

ASM ağ geçidi bu ayarı desteklemez. ASM ağ geçidinde yapılandırmayı değiştirmek için IstioGateway YAML dosyasını düzenlemeniz gerekir.

compute-full-forwarded-for

X-Forwarded-For üst bilgisini değiştirmek yerine uzak adresi bu üst bilgiye ekler.

Bu davranış, varsayılan değeri true olan Envoy use_remote_address ayarına bağlıdır. Istio'nun X-Forwarded-For üst bilgisini nasıl işlediği hakkında daha fazla bilgi için bkz. Ağ Geçidi Ağ Topolojisini Yapılandırma.

enable-underscores-inheaders

Üst bilgi adlarında alt çizgi kullanılmasına izin verir.

Bu ayar, varsayılan olarak alt çizgilere izin veren Envoy headers_with_underscores_action ayarına karşılık gelir.

forwarded-for-header

İstemcinin orijinal IP adresini belirlemek için kullanılan üst bilgi alanını belirtir.

ASM ağ geçidi bu amaçla özel bir üst bilgiyi desteklemez. Varsayılan olarak X-Forwarded-For kullanılır.

generate-request-id

İstekte bulunmuyorsa rastgele bir X-Request-ID oluşturur.

Bu ayar, varsayılan olarak etkin olan Envoy generate_request_id ayarına karşılık gelir. Bu ayarı bir ASM eklentisi kullanarak değiştirebilirsiniz.

ignore-invalid-headers

Geçersiz ada sahip üst bilgilerin yoksayılıp yoksayılmayacağını belirler. Geçerli bir üst bilgi adı alfasayısal karakterlerden ve tirelerden (-) oluşur. Alt çizgi (_) de içerebilir.

Envoy bir Üst Bilgi Doğrulayıcı sağlar. Üst Bilgi Doğrulayıcıyı yapılandırmazsanız Envoy varsayılan doğrulayıcıyı kullanır. Envoy, geçersiz üst bilgileri içeren istekleri Bad Request hatasıyla reddeder.

~ $ curl httpbin:8000/headers -H "test-@@@:test" -I
HTTP/1.1 400 Bad Request
content-length: 11
content-type: text/plain
date: Tue, 01 Aug 2023 06:14:20 GMT
server: istio-envoy
connection: close

keep-alive-requests

Tek bir keepalive bağlantısı üzerinden sunulabilecek maksimum istek sayısını ayarlar. Maksimum sayıya ulaşıldığında bağlantı kapatılır.

Bunu yapılandırmak için bir DestinationRule içindeki connectionPool.maxRequestsPerConnection alanına bakın.

log-format-upstream

Günlük biçimini özelleştirir.

ASM ağ geçidi özel günlük biçimlerini destekler. Biçimi ASM konsolundaki Gözlemlenebilirlik ayarları sayfasından yapılandırabilirsiniz. Daha fazla bilgi için bkz. Gözlemlenebilirlik ayarları.

max-worker-connections

Tek bir worker işleminin açabileceği maksimum bağlantı sayısını ayarlar.

ASM doğrudan bir eşdeğer sunmaz. Ancak, tek bir ana bilgisayara yapılan maksimum bağlantı sayısını yapılandırmak için bir DestinationRule içindeki connectionPool.tcp.maxConnections alanını kullanabilirsiniz.

proxy-body-size

İstemci istek gövdesinin izin verilen maksimum boyutunu ayarlar. İstek gövdesi bu boyutu aşarsa sunucu 413 hatası döndürür.

Bu ayarı doğrudan yapılandıramazsınız. Büyük gövdeler için parçalı aktarım kodlamasını kullanın.

proxy-connect-timeout

Bir proxy sunucusuyla bağlantı kurmak için zaman aşımını tanımlar. Bu süre 75 saniyeyi aşamaz.

Bunu yapılandırmak için bir DestinationRule içindeki connectionPool.http.connectTimeout alanına bakın.

reuse-port

Her worker işlemi için ayrı bir dinleme soketi oluşturur (SO_REUSEPORT soket seçeneğini kullanarak). Bu sayede çekirdek, gelen bağlantıları worker işlemleri arasında yük dengeler. Bu özellik varsayılan olarak etkindir.

ASM ağ geçidi bu özelliği varsayılan olarak etkinleştirir.

server-tokens

Yanıtlarda Nginx sunucu üst bilgisini gönderir ve hata sayfalarında Nginx sürümünü görüntüler. Bu özellik varsayılan olarak devre dışı bırakılmıştır.

ASM ağ geçidi sunucu üst bilgisini varsayılan olarak Envoy olarak ayarlar ancak Envoy sürümü hata sayfalarında görüntülenmez.

ssl-redirect

Bir sunucu TLS sertifikası ile güvence altına alındığında bu ayar HTTP trafiğini otomatik olarak HTTPS'ye yönlendirir.

Bunu yapılandırmak için bir Gateway içindeki tls.httpsRedirect alanına bakın.

upstream-keepalive-connections

Her worker işleminin önbelleğinde korunan, yukarı akış sunucularına yönelik maksimum boşta kalan keepalive bağlantı sayısını ayarlar.

ASM doğrudan bir eşdeğer sunmaz. DestinationRule, benzer bir amaca hizmet eden connectionPool.tcp.maxConnections alanını sağlar. Ancak Istio ayarı tüm bağlantılara uygulanırken Nginx ayarı yalnızca boşta kalan bağlantılara uygulanır.

upstream-keepalive-timeout

Sistemin yukarı akış sunucusuna yönelik boşta kalan bir keepalive bağlantısını kapatacağı zaman aşımını ayarlar.

Bunu yapılandırmak için bir DestinationRule içindeki connectionPool.http.idleTimeout alanına bakın.

use-forwarded-headers

• true ise Nginx, gelen X-Forwarded-* üst bilgilerini yukarı akış sunucusuna iletir. Bu durum genellikle Nginx başka bir L7 proxy'nin arkasında olduğunda kullanılır.

• false ise Nginx gelen üst bilgileri yoksayar ve kendi üst bilgilerini oluşturur.

Istio'nun X-Forwarded-For üst bilgisini nasıl işlediği hakkında daha fazla bilgi için bkz. Ağ Geçidi Ağ Topolojisini Yapılandırma.

worker-cpu-affinity

Worker işlemlerini belirli CPU kümelerine bağlar.

Konteyner ortamında bu seçeneğin yapılandırılmasını önermiyoruz. Varsayılan ayarı kullanmanız yeterlidir.