Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Create and use an NGINX Ingress

Son Güncelleme:Oct 06, 2026

NGINX Ingress Controller, Alibaba Cloud Container Service for Kubernetes (ACK) yönetilen kümeleri için giriş ağ geçidi olarak hizmet verir ve esnek yönlendirme kurallarıyla harici trafiği dahili hizmetlere iletir. Açıklamalar (annotations) aracılığıyla HTTPS şifreleme, canary sürümleri ve özel yapılandırmalar gibi özellikleri destekleyerek güvenli, yüksek kullanılabilirliğe sahip ve ölçeklenebilir Katman 7 (L7) ağ erişimi sağlar.

Önemli

Kullanım notları

  • NGINX Ingress Controller tarafından kullanılan varsayılan hizmeti silmeyin. Eklenti yüklendikten sonra, kube-system ad alanında nginx-ingress-lb adında varsayılan bir hizmet oluşturulur. Bu hizmetin silinmesi eklentiyi kararsız hale getirir ve çökmesine neden olabilir.

  • Eklenti için özel parametreleri yapılandırmak üzere Eklentiler veya OpenAPI kullanın. Yapılandırmayı başka yöntemlerle değiştirmek eklentinin hatalı çalışmasına ve gelecekteki yükseltmelerin engellenmesine neden olabilir.

  • Özel yapılandırmalar için NGINX Ingress ConfigMap kullanın. Teknik destek, snippet'ler veya Lua kodu gibi ek yapılandırmalardan kaynaklanan sorunları kapsamaz.

  • Kaynak topluluk sürümündeki hatalar veya güvenlik açıkları nedeniyle iş kesintilerini önlemek için NGINX Ingress Controller eklentisini zamanında yükseltin.

NGINX Ingress Controller eklentisini yükleme

Küme oluşturma sırasında

1. Eklentiyi seçin

  1. ACK konsolu üzerinde oturum açın ve Create Kubernetes Cluster seçeneğine tıklayın.

  2. Component Configurations adımında, Ingress bölümünde NGINX Ingress seçeneğini belirleyin.

2. Server Load Balancer (SLB) kaynağını seçin

  • New: Kümenin VPC'sinde çok alanlı genel veya özel bir CLB örneğini otomatik olarak oluşturur. Örnek, teknik özelliklere göre ödeme faturalandırma yöntemini kullanır ve belirtilmiş bir örnek türüne sahiptir.

  • Use Existing: Kümeyle aynı bölgedeki mevcut bir genel CLB örneğini veya aynı VPC'deki özel bir CLB örneğini seçin. CLB örneğinin başka bir kümeyle ilişkilendirilmemiş olduğundan emin olun.

Eklentiler sayfasından yükleme

Eklentiyi Eklentiler sayfasından yüklemek, teknik özelliklere göre ödeme faturalandırma yöntemini kullanan ve Small I (slb.s1.small) örnek türüne sahip olan herkese açık bir CLB örneğini otomatik olarak oluşturur. Bu örnek, NGINX Ingress için trafik giriş noktası olarak hizmet eder.

  1. ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde Components and Add-ons seçeneğine tıklayın. .

  3. Network sekmesinde veya arama çubuğunu kullanarak NGINX Ingress Controller eklentisini bulun. Eklenti kartının sağ alt köşesinde Install seçeneğine tıklayın.

  4. Install Comment NGINX Ingress Controller iletişim kutusunda parametreleri yapılandırın ve OK seçeneğine tıklayın.

Örnek bir uygulama oluşturun

Örnek uygulama, coffee ve tea adlı iki durum bilgisi içermeyen iş yükü (Dağıtımlar) ve bunlara karşılık gelen coffee-svc ile tea-svc adlı Hizmetleri dağıtır.

Konsol

1. Kaynakları oluşturun

  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Workloads > Deployments.

  3. Create from YAML seçeneğine tıklayın. Sample Template açılır listesinden Custom seçeneğini belirleyin. Aşağıdaki içeriği şablon düzenleyicisine kopyalayın ve Create seçeneğine tıklayın.

    Örnek uygulama YAML dosyası

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: coffee
      namespace: default
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: coffee
      template:
        metadata:
          labels:
            app: coffee
        spec:
          containers:
          - name: coffee
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
            ports:
            - containerPort: 80
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: coffee-svc
      namespace: default
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: coffee
      type: ClusterIP
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: tea
      namespace: default
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: tea
      template:
        metadata:
          labels:
            app: tea
        spec:
          containers:
          - name: tea
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
            ports:
            - containerPort: 80
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: tea-svc
      namespace: default
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: tea
      type: ClusterIP

2. Sonucu görüntüleyin

YAML Resource Creation Result iletişim kutusunda, bir kaynağın oluşturulduğunu onaylamak için Actions sütunundaki View seçeneğine tıklayın. 

kubectl

  1. Kümeniz için KubeConfig dosyasını edinin ve kubectl kullanarak kümeye bağlanın.

  2. Aşağıdaki içeriğe sahip test-deployment-service.yaml adlı bir dosya oluşturun.

    Örnek YAML dosyası

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: coffee
      namespace: default
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: coffee
      template:
        metadata:
          labels:
            app: coffee
        spec:
          containers:
          - name: coffee
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
            ports:
            - containerPort: 80
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: coffee-svc
      namespace: default
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: coffee
      type: ClusterIP
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: tea
      namespace: default
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: tea
      template:
        metadata:
          labels:
            app: tea
        spec:
          containers:
          - name: tea
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
            ports:
            - containerPort: 80
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: tea-svc
      namespace: default
    spec:
      ports:
      - port: 80
        targetPort: 80
        protocol: TCP
      selector:
        app: tea
      type: ClusterIP
  3. Dağıtımı ve Hizmeti oluşturmak için yapılandırmayı uygulayın.

    kubectl apply -f test-deployment-service.yaml
  4. coffee ve tea Dağıtımlarının durumunu doğrulayın.

    kubectl get deployment coffee tea

    Beklenen çıktı:

    NAME     READY   UP-TO-DATE   AVAILABLE   AGE
    coffee   2/2     2            2           14m
    tea      2/2     2            2           14m
  5. coffee-svc ve tea-svc Hizmetlerinin durumunu doğrulayın.

    kubectl get service coffee-svc tea-svc

    Beklenen çıktı:

    NAME         TYPE        CLUSTER-IP        EXTERNAL-IP   PORT(S)   AGE
    coffee-svc   ClusterIP   192.168.xxx.xxx   <none>        80/TCP    15m
    tea-svc      ClusterIP   192.168.xxx.xxx   <none>        80/TCP    15m

NGINX Ingress oluşturun

Bu örnekte alan adı (ana bilgisayar) olarak test-nginx-ingress.com kullanılmaktadır. Bunu kendi kayıtlı alan adınızla değiştirin. Yol eşlemesi (yollar), Örnek bir uygulama oluşturun örneğinden alınmıştır. Bu yolları uygulamanızın yapılandırmasına uyacak şekilde değiştirin.

Konsol

1. Ingress oluşturun

  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. Clusters sayfasında hedef kümenin adına tıklayın. Sol gezinme bölmesinde Network > Ingresses seçeneğini belirleyin. default ad alanını seçin, Create Ingress seçeneğine tıklayın ve Ingress'i aşağıdaki gibi yapılandırın.

    • Gateway Type: Nginx Ingress

    • Name: test-nginx-ingress

    • Domain Name: test-nginx-ingress.com (Kayıtlı alan adınızla değiştirin)

    • Mappings:

      • Path: /coffee

      • Rule: Varsayılan (ImplementationSpecific)

      • Service: coffee-svc

      • Port: 80

  3. tea-svc hizmeti için bir yol yapılandırmak üzere +Add seçeneğine tıklayın.

    • Mappings:

      • Path: /tea

      • Rule: Varsayılan (ImplementationSpecific)

      • Service: tea-svc

      • Port: 80

  4. www.test-nginx-ingress.com alan adını (kendi kayıtlı alan adınızla değiştirin) eklemek ve yol eşlemelerini yapılandırmak için +Add Rule seçeneğine tıklayın. İşiniz bittiğinde OK seçeneğine tıklayın.

2. Uç noktayı edinin

Yaklaşık bir dakika sonra sayfayı yenileyin. Endpoint sütununda bir Elastik IP (EIP) göründüğünde Nginx Ingress başarıyla oluşturulmuş demektir. Bu EIP, ilişkili Cloud Load Balancer (CLB) örneğinin genel hizmet adresidir.

Birkaç dakika sonra uç nokta bilgileri görünmezse Ingress adına tıklayın ve sorun giderme için Events sekmesini kontrol edin.

kubectl

  1. Aşağıdaki içeriğe sahip test-ingress.yaml adlı bir dosya oluşturun.

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: test-nginx-ingress
      namespace: default
    spec:
      ingressClassName: nginx
      rules:
      - host: test-nginx-ingress.com # Replace with your registered domain name
        http:
          paths:
          - path: /coffee
            backend:
              service: 
                name: coffee-svc
                port:
                  number: 80
            pathType: ImplementationSpecific
          - path: /tea
            backend:
              service: 
                name: tea-svc
                port:
                  number: 80
            pathType: ImplementationSpecific
      - host: www.test-nginx-ingress.com # Replace with your registered domain name
        http:
          paths:
          - path: /coffee
            backend:
              service: 
                name: coffee-svc
                port:
                  number: 80
            pathType: ImplementationSpecific
          - path: /tea
            backend:
              service: 
                name: tea-svc
                port:
                  number: 80
            pathType: ImplementationSpecific

    Parametre açıklamaları:

    • name: Ingress'in adı. Bu örnekte ad test-nginx-ingress olarak belirtilmiştir.

    • host: Hizmete erişmek için kullanılan alan adı. Bu örnekte alan adı test-nginx-ingress.com olarak belirtilmiştir. Bunu kendi kayıtlı alan adınızla değiştirin.

    • path: Kural için URL yolu. Bir isteğin arka uca yönlendirilmesi için belirtilen ana bilgisayara ve yola eşleşmesi gerekir. Bu örnekte yollar /coffee ve /tea şeklindedir.

    • backend: Bir hizmet adı ve bir hizmet bağlantı noktasından oluşur.

      • Hizmet adı: Ingress'in trafiği ilettiği arka uç hizmetinin adı. Örneğin, coffee-svc ve tea-svc.

      • Hizmet bağlantı noktası: Arka uç Hizmetindeki hedef bağlantı noktası. Bu örnekte bağlantı noktası 80 şeklindedir.

  2. Ingress'i oluşturun.

    kubectl apply -f test-ingress.yaml
  3. Ingress'i görüntüleyin ve 8.xxx.xxx.117 gibi bir Elastik IP (EIP) adresini edinin.

    kubectl get ingress

    Beklenen çıktı:

    NAME                 CLASS   HOSTS                                               ADDRESS         PORTS   AGE
    test-nginx-ingress   nginx   test-nginx-ingress.com,www.test-nginx-ingress.com   8.xxx.xxx.117   80      2m39s
  4. Nginx Ingress'in doğru çalıştığını doğrulamak için EIP'yi kullanın.

    curl http://8.xxx.xxx.117/coffee -H "Host: test-nginx-ingress.com"

    Beklenen çıktı:

    ...
    <title>Hello World</title>
    ...
    <p><span>Server&nbsp;address:</span> <span>10.xxx.xxx.19:80</span></p>
    <p><span>Server&nbsp;name:</span> <span>coffee-96d4bc87-l29dh</span></p>
    <p class="smaller"><span>Date:</span> <span>08/Aug/2025:02:21:02 +0000</span></p>
    <p class="smaller"><span>URI:</span> <span>/coffee</span></p>
    ...
        <div id="footer">
            <div id="center" align="center">
                Request ID: 42e2d73c85b16b55b6ab52deb7d995d4<br/>
                &copy; NGINX, Inc. 2018
            </div>
        </div>
    ...

DNS çözümlemesini yapılandırma

Bir etki alanı adı kaydedin. Etki alanı adı yalnızca üçüncü taraf bir sağlayıcı üzerinden kaydedildiyse eklenmelidir. Alibaba Cloud, platformu üzerinden satın alınan etki alanı adlarını Alibaba Cloud DNS içindeki genel yetkili bölgelere otomatik olarak ekler; bu sayede doğrudan DNS kayıtları ekleyebilirsiniz.

1. Bir etki alanı adı ekleyin

  1. Go to Alibaba Cloud DNS - Public Zone.

    On the Public Zone tab, click Add Zone.

  2. Enter the domain name you want to add, and select the Public Zone instance you created. For more information about the parameters, see Purchase and bind a domain name.

2. Bir DNS kaydı ekleyin

  1. Hedef etki alanı adını bulun ve Actions sütunundaki Settings öğesine tıklayın. Ardından Add Record seçeneğine tıklayın. Kayıt türü A ve ana bilgisayar kaydı @ olan bir DNS kaydı ekleyin. Record Value, NGINX Ingress erişim adresidir.

  2. Ana bilgisayar kaydını www olarak ayarlayarak başka bir DNS kaydı eklemek için aynı adımları izleyin.

  3. Yeni DNS kaydının yanındaki Probing seçeneğine tıklayarak çözümleme durumunu kontrol edin.

Daha fazla bilgi için bkz. Bir web sitesi çözümleme kaydı ekleme.

3. Etki alanı adını ve yolu doğrulayın

Tarayıcınızda http://test-nginx-ingress.com/coffee adresini ziyaret edin; test-nginx-ingress.com yerine gerçek etki alanı adınızı yazın. Bu işlem, hizmet yolunun erişilebilir olduğunu doğrular.

İstek başarılı olursa sayfa, NGINX arka uç pod'undan gelen bilgileri döndürür. Bu bilgiler arasında server address, server name, Date ve URI alanları yer alır.

Sonucu onaylamak için ayrıca DNS çözümlemesini test etme yöntemleri konusuna bakabilirsiniz. Bir DNS kaydı etkili olmazsa DNS çözümleme hatalarını hızlıca giderme konusuna bakın.

HTTPS güvenliğini yapılandırma

Bir ticari sertifika ve sertifikayı talep edin. Sertifikasının Issued durumunda olduğundan emin olun. Ardından sertifikayı indirmek ve bir TLS yapılandırması eklemek için aşağıdaki adımları izleyin. Bu işlem, etki alanınıza şifreli HTTPS erişimi sağlar.

Konsol

1. Sertifikayı indirin

  1. Log on to the Certificate Management Service console. In the left-side navigation pane, choose Certificate Management > SSL Certificate Management.

  2. On the Commercial Certificates tab, select the certificate you want to download, and click Download in the bottom-left corner of the certificate list.

  3. In the dialog box that appears, select Nginx as the server type, download the certificate package, and decompress it.

For more details, see Download an SSL certificate.

2. Secret oluşturun

  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Configurations > Secrets.

  3. On the Secrets page, select the default namespace, click Create in the upper-left corner, configure a new Secret in the panel that appears, and then click OK.

    • Name: nginx-ingress-tls

    • Type: Ingress TLS Certificate

    • Certificates: The full contents of the downloaded and decompressed certificate file (.pem).

    • Key: The full contents of the downloaded and decompressed private key file (.key).

3. TLS yapılandırması ekleyin

  1. In the left-side navigation pane, choose Network > Ingresses. In the Actions column of your target Ingress, click Update.

  2. On the Modify Ingress page, add the following TLS configuration and then click OK.

    • TLS Settings: Enabled

    • Domain Name: test-nginx-ingress.com (Replace this with your actual registered domain name.)

    • Secrets: nginx-ingress-tls

4. HTTPS erişimini doğrulayın

Web tarayıcınızda https://test-nginx-ingress.com/coffee adresine gidin (gerçek kayıtlı etki alanı adınızla değiştirin) ve hizmet yoluna şifreli HTTPS erişimini doğrulayın.

Kubectl

  1. Log on to the Certificate Management Service console. In the left-side navigation pane, choose Certificate Management > SSL Certificate Management.

  2. On the Commercial Certificates tab, select the certificate you want to download, and click Download in the bottom-left corner of the certificate list.

  3. In the dialog box that appears, select Nginx as the server type, download the certificate package, and decompress it.

  4. Use the downloaded certificate file (.pem) and private key file (.key) to create a Secret.

    kubectl create secret tls nginx-ingress-tls --cert test-nginx-ingress.com.pem --key test-nginx-ingress.com.key -n default
  5. Add a TLS configuration to the test-nginx-ingress Ingress. Replace test-nginx-ingress.com in the command with your actual registered domain name.

    kubectl patch ingress test-nginx-ingress -p '{"spec":{"tls":[{"hosts":["test-nginx-ingress.com"],"secretName":"nginx-ingress-tls"}]}}'
  6. Verify encrypted HTTPS access to the service path by running the following command with your actual Elastic IP Address.

    curl -v -k https://8.xxx.xxx.117/coffee -H "Host: test-nginx-ingress.com"
    • Parameters:

      • -v: Displays verbose output, including the TLS handshake.

      • -k (or --insecure): Skips certificate verification. Use this option if you are using a self-signed certificate.

    • Expected output:

      ...
      *   Trying 8.xxx.xxx.117:443...
      * Connected to 8.xxx.xxx.117 (8.xxx.xxx.117) port 443
      * ALPN: curl offers h2,http/1.1
      * (304) (OUT), TLS handshake, Client hello (1):
      * (304) (IN), TLS handshake, Server hello (2):
      * (304) (IN), TLS handshake, Unknown (8):
      * (304) (IN), TLS handshake, Certificate (11):
      * (304) (IN), TLS handshake, CERT verify (15):
      * (304) (IN), TLS handshake, Finished (20):
      * (304) (OUT), TLS handshake, Finished (20):
      ...
      <title>Hello World</title>
      ...
      <p><span>Server&nbsp;address:</span> <span>10.xxx.xxx.159:80</span></p>
      <p><span>Server&nbsp;name:</span> <span>coffee-96d4bc87-6cstv</span></p>
      <p class="smaller"><span>Date:</span> <span>14/Aug/2025:09:27:42 +0000</span></p>
      <p class="smaller"><span>URI:</span> <span>/coffee</span></p>
      ...
          <div id="footer">
              <div id="center" align="center">
                  Request ID: fee5fe107106748a35d99a2dbbbc6652<br/>
                  &copy; NGINX, Inc. 2018
              </div>
          </div>
      ...

Ek yapılandırmalar

Canary sürümü

Hizmetleri yükseltmek için kademeli güncellemeler, aşamalı sürümler, mavi-yeşil dağıtımlar ve canary sürümleri gibi çeşitli dağıtım stratejilerini kullanabilirsiniz. Ayrıntılı talimatlar için NGINX Ingress kullanarak aşamalı sürümler ve mavi-yeşil dağıtımlar uygulama konusuna bakın.

Arka uç hizmet protokolü

Bir arka uç hizmetinin protokolünü belirtmek için nginx.ingress.kubernetes.io/backend-protocol ek açıklamasını ekleyin. Desteklenen protokoller HTTP, HTTPS, gRPC ve gRPCS'dir. Yapılandırma örneği için NGINX Ingress için gRPC hizmeti yapılandırma konusuna bakın.

URL yeniden yazma

NGINX Ingress denetleyicisini kullandığınızda istekler tam yola göre iletilir. Örneğin, /service1/api adresine yapılan bir istek, arka uç pod'unun /service1/api yoluna iletilir. Arka uç hizmetinizin yolu /api ise yol uyumsuzluğu oluşur ve 404 hatası alırsınız. Bu sorunu çözmek için istek yolunu doğru dizine yeniden yazmak amacıyla nginx.ingress.kubernetes.io/rewrite-target ek açıklamasını ekleyebilirsiniz.

Ayrıntılı talimatlar için URL yönlendirmesini yapılandırma konusuna bakın.

Ek açıklamalar

NGINX Ingress, ek açıklamalarla etkinleştirebileceğiniz geniş bir özellik yelpazesini destekler. Daha fazla bilgi için NGINX Ingress yapılandırma sözlüğü ve Gelişmiş NGINX Ingress yapılandırmaları konularına bakın.

Gözlemlenebilirlik

Kapsamlı NGINX Ingress erişim günlüğü analiz raporlarına ve gerçek zamanlı izleme panolarına erişmek için küme oluşturma sırasında Simple Log Service'i (SLS) etkinleştirin. Ayrıntılar için NGINX Ingress erişim günlüklerini analiz etme ve izleme konusuna bakın.

Yüksek yük senaryoları

Yüksek yük senaryolarında NGINX Ingress Denetleyicisinin performansını ve kararlılığını artırmak için Yüksek yük senaryoları için NGINX Ingress Denetleyicisi yapılandırma ve NGINX Ingress Denetleyicisi kullanımıyla ilgili öneriler konularına bakın.

SSS

Küme içinden harici IP'ye ulaşılamıyor

Belirti

Kümedeki bazı Pod'lar, NGINX Ingress Denetleyicisinin harici adresini (yük dengeleyici örneğinin IP adresi) kullanarak arka uç Pod'larına erişemezken diğerleri erişebilir.

Neden

Bu sorun, denetleyicinin Hizmetindeki externalTrafficPolicy ayarından kaynaklanır; bu ayar, harici trafiğin nasıl işleneceğini belirler. Ayar local olarak yapılandırıldığında yalnızca denetleyici Pod'u ile aynı düğümdeki arka uç Pod'ları istekleri alabilir. Ayar Cluster olarak yapılandırıldığında erişim beklendiği gibi çalışır. Küme içindeki bir kaynak, yük dengeleyicinin harici IP adresini kullanarak Hizmete eriştiğinde istek de harici trafik olarak değerlendirilir.

Çözüm

  • (Önerilen) Kubernetes kümesi içinden NGINX Ingress'e ClusterIP veya hizmet adı kullanarak erişin. NGINX Ingress'in hizmet adı nginx-ingress-lb.kube-system şeklindedir.

  • NGINX Ingress Hizmetini değiştirmek için kubectl edit svc nginx-ingress-lb -n kube-system komutunu çalıştırın. LoadBalancer Hizmetinin externalTrafficPolicy değerini Cluster olarak değiştirin. Kümenin konteyner ağ eklentisi Flannel ise istekler istemci kaynak IP'sini kaybeder. Terway kullanıyorsanız istemci kaynak IP'si korunur.

    Örnek:

    apiVersion: v1
    kind: Service
    metadata:
      annotations:
        service.beta.kubernetes.io/backend-type: eni   # Passes traffic directly to the Elastic Network Interface (ENI).
      labels:
        app: nginx-ingress-lb
      name: nginx-ingress-lb
      namespace: kube-system
    spec:
      externalTrafficPolicy: Cluster

Hizmet ek açıklamaları hakkında daha fazla bilgi için Ek açıklamalar kullanarak Klasik Yük Dengeleyiciyi (CLB) yapılandırma konusuna bakın.

Büyük üstbilgiler veya çerezler

Bir istemci isteği büyük istek üstbilgileri veya çerezler içeriyorsa NGINX Ingress, "400 Request Header Or Cookie Too Large /Bad request" gibi bir hata döndürebilir. Bu sorunu çözmek için aşağıdaki ayarları değiştirerek arabellek boyutlarını artırın:

  • client-header-buffer-size: İstemci istek üstbilgileri için arabellek boyutu. Varsayılan değer 1k şeklindedir.

  • large-client-header-buffers: Büyük istemci istek üstbilgilerini okumak için kullanılan maksimum arabellek sayısı ve boyutu. Varsayılan değer 4 8k şeklindedir.

ConfigMap'i düzenlemek ve bu ayarları değiştirmek için kubectl edit cm -n kube-system nginx-configuration komutunu çalıştırın. Örnek:

client-header-buffer-size: "16k"
large-client-header-buffers: "4 32k" 

Ayarları güncelledikten sonra NGINX veri düzleminin değişiklikleri yansıttığını doğrulayın. kubectl exec <nginx-ingress-pod> -n kube-system -- cat /etc/nginx/nginx.conf | vim - komutunu çalıştırarak nginx.conf dosyasını görüntüleyin ve ConfigMap değişikliklerinin eşitlendiğini onaylayın.

CORS yapılandırması

Ingress kaynağınızın metadata.annotations bölümüne belirli ek açıklamalar ekleyerek Cross-Origin Resource Sharing (CORS) özelliğini etkinleştirin. Daha fazla bilgi için NGINX Ingress için CORS yapılandırma konusuna bakın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  namespace: default
  annotations:
    nginx.ingress.kubernetes.io/enable-cors: "true"     # Enables CORS.
    nginx.ingress.kubernetes.io/cors-allow-origin: "*"  # Allows access from all domains.
    nginx.ingress.kubernetes.io/cors-allow-methods: "GET, PUT, POST, DELETE, PATCH, OPTIONS"  # Allowed HTTP methods.
    nginx.ingress.kubernetes.io/cors-allow-headers: "DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range" # Allowed custom request headers.
    nginx.ingress.kubernetes.io/cors-expose-headers: "Content-Length,Content-Range"  # Exposed response headers.
    nginx.ingress.kubernetes.io/cors-max-age: "86400"  # Preflight request cache duration.
spec:
  ingressClassName: nginx
  rules:
  - host: example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: example-service
            port:
              number: 80

İstemci IP geçişi

Varsayılan olarak NGINX Ingress, istemci IP adresini iletmek için X-Forwarded-For ve X-Real-IP üstbilgilerini kullanır. Ancak, bir istemci bu üstbilgileri istekte açıkça ayarlarsa arka uç sunucusu gerçek istemci IP adresini alamayabilir.

Ingress için Katman 7 istemci IP geçişini etkinleştirmek üzere kubectl edit cm -n kube-system nginx-configuration komutunu çalıştırın ve aşağıdaki ayarları ConfigMap'e ekleyin.

compute-full-forwarded-for: "true"
forwarded-for-header: "X-Forwarded-For"
use-forwarded-headers: "true"

NGINX Ingress birden çok proxy katmanının arkasındaysa proxy-real-ip-cidr parametresine bağlı olarak yapılandırmayı ayarlayın. Yukarı akış proxy'lerinin IP adreslerini CIDR biçiminde proxy-real-ip-cidr değerine ekleyin; birden fazla CIDR bloğunu virgülle ayırın. Daha fazla bilgi için WAF kullanma konusuna bakın.

proxy-real-ip-cidr:  "0.0.0.0/0,::/0"  

Yukarı akışta Klasik Yük Dengeleyici (CLB) bulunan bir IPv6 senaryosunda, NGINX Ingress tarafından alınan X-Forwarded-For üstbilgisi boşsa istemci IP adresini almak için CLB'de Proxy Protocol'ü etkinleştirin. Proxy Protocol hakkında daha fazla bilgi için CLB örneğinin Katman 4 dinleyicisi aracılığıyla gerçek istemci IP adreslerini alma konusuna bakın.

Referanslar