Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Advanced NGINX Ingress

Son Güncelleme:Oct 23, 2026

Kubernetes kümesinde NGINX Ingress, Hizmetlere yönelik harici erişimi yönetmek için 7. Katman yük dengeleme sağlayan bir API nesnesidir. NGINX Ingress kullanarak harici olarak erişilebilir URL'leri, yeniden yazma kurallarını, HTTPS hizmetlerini ve canary sürümlerini yapılandırabilirsiniz. Bu konuda güvenli yönlendirme hizmetlerinin nasıl yapılandırılacağı, karşılıklı TLS kimlik doğrulaması, düzenli ifadeler ve joker karakterleri destekleyen alan adlarının nasıl ayarlanacağı ile ücretsiz HTTPS sertifikalarının nasıl alınacağı açıklanmaktadır.

Önemli

Açık kaynaklı Ingress-NGINX projesinin bakımı Mart 2026'dan sonra sona erecektir. Buna bağlı olarak, Container Service for Kubernetes da NGINX Ingress denetleyicisi bileşeninin bakımını durduracaktır. İlgili risklerin farkında olun. Daha fazla bilgi için bkz. [[Ürün Duyurusu] NGINX Ingress Denetleyicisi Bileşeni Bakımının Durdurulması Hakkında Duyuru](t3212739.xdita#).

Ön Koşullar

Yapılandırma

ACK'deki NGINX Ingress denetleyicisi yapılandırma yöntemleri, topluluk sürümüyle tamamen uyumludur. Yapılandırma seçeneklerinin tam listesi için bkz. NGINX Yapılandırması.

Aşağıdaki yapılandırma yöntemleri desteklenir:

  • Ek açıklama kullanma: Bir NGINX Ingress'in YAML dosyasına ek açıklama ekleyebilirsiniz. Ek açıklama yalnızca o belirli Ingress üzerinde etkili olur. Daha fazla bilgi için bkz. Ek Açıklamalar.

  • ConfigMap kullanma: kube-system/nginx-configuration ConfigMap'ini değiştirebilirsiniz. Bu, tüm NGINX Ingress'ler için geçerli olan genel bir yapılandırmadır. Daha fazla bilgi için bkz. ConfigMap'ler.

  • Özel NGINX şablonu kullanma: Ek açıklamalar veya ConfigMap, NGINX Ingress denetleyicisinin NGINX şablonu için özel gereksinimlerinizi karşılamıyorsa bu yöntemi kullanabilirsiniz. Daha fazla bilgi için bkz. Özel NGINX şablonu.

URL yönlendirmesini yapılandırma

NGINX Ingress denetleyicisini kullanırken istekleri tam yola göre iletir. Örneğin, /service1/api yoluna yapılan bir istek, arka uç pod'unun /service1/api yoluna iletilir. Arka uç hizmetinizin yolu /api ise yol uyuşmazlığı oluşur ve bu durum 404 hatasına neden olur. Bu sorunu çözmek için istek yolunu doğru dizine yeniden yazmak üzere nginx.ingress.kubernetes.io/rewrite-target ek açıklamasını ekleyebilirsiniz.

Kümenizin Kubernetes sürümüne göre bir NGINX Ingress oluşturun.

Kubernetes 1.19 ve üzeri

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: foo.bar.com
  namespace: default
  annotations:
    # URL redirection.
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
  - host: foo.bar.com
    http:
      paths:
    # For Ingress controller versions 0.22.0 and later, you must define the path by using a regular expression and use capture groups in the rewrite-target annotation.
      - path: /svc(/|$)(.*)
        backend:
          service: 
            name: web1-service
            port: 
              number: 80
        pathType: ImplementationSpecific

Kubernetes 1.19'dan önceki sürümler

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: foo.bar.com
  namespace: default
  annotations:
    # URL redirection.
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
  - host: foo.bar.com
    http:
      paths:
      # For Ingress controller versions 0.22.0 and later, you must define the path by using a regular expression and use capture groups in the rewrite-target annotation.
      - path: /svc(/|$)(.*)
        backend:
          serviceName: web1-service
          servicePort: 80
  1. NGINX hizmetine erişin.

    1. ADDRESS değerini almak için aşağıdaki komutu çalıştırın.

      kubectl  get  ingress

      Beklenen çıktı:

      NAME           CLASS   HOSTS                ADDRESS          PORTS   AGE
      foo.bar.com    nginx   foo.bar.com        172.16.XX.XX       80      46m
    2. Aşağıdaki komutu çalıştırın. <ADDRESS> yerine Ingress'in IP adresini yazın.

      curl -k -H "Host: foo.bar.com"  http://<ADDRESS>/svc/foo

      Beklenen çıktı:

      web1: /foo

Yeniden yazma kuralları

Temel yeniden yazma yapılandırmaları için nginx.ingress.kubernetes.io/rewrite-target ek açıklamasını kullanabilirsiniz. Daha fazla bilgi için bkz. URL yönlendirmesini yapılandırma.

Karmaşık veya gelişmiş yeniden yazma gereksinimleri için aşağıdaki ek açıklamaları kullanabilirsiniz:

  • nginx.ingress.kubernetes.io/server-snippet: server bloğuna özel yapılandırmalar ekler.

  • nginx.ingress.kubernetes.io/configuration-snippet: location bloğuna özel yapılandırmalar ekler.

Bu ek açıklamalar, özel kod parçacıkları ekleyerek çeşitli kullanım durumları için NGINX yapılandırmasını özelleştirme esnekliği sağlar.

Aşağıda bir yapılandırma örneği verilmiştir:

annotations:
     nginx.ingress.kubernetes.io/server-snippet: |
         rewrite ^/v4/(.*)/card/query http://foo.bar.com/v5/#!/card/query permanent;
     nginx.ingress.kubernetes.io/configuration-snippet: |
         rewrite ^/v6/(.*)/card/query http://foo.bar.com/v7/#!/card/query permanent;

NGINX Ingress denetleyicisi pod'undaki NGINX yapılandırma dosyasını görüntülemek için aşağıdaki komutu çalıştırın:

kubectl exec nginx-ingress-controller-xxxxx --namespace kube-system -- cat /etc/nginx/nginx.conf   # Replace the pod name with the actual one from your environment.

Oluşturulan nginx.conf dosyası aşağıdakileri içerir:

# start server foo.bar.com
    server {
        server_name foo.bar.com ;
        listen 80;
        listen [::]:80;
        set $proxy_upstream_name "-";
    # server-snippet configuration.
        rewrite ^/v4/(.*)/card/query http://foo.bar.com/v5/#!/card/query permanent;
        ...
    # configuration-snippet configuration.
      rewrite ^/v6/(.*)/card/query http://foo.bar.com/v7/#!/card/query permanent;
      ...
    }
    # end server foo.bar.com

snippet ek açıklamaları genel yapılandırmaları da destekler. Daha fazla bilgi için bkz. server-snippet.

rewrite yönergesinin nasıl kullanılacağı hakkında daha fazla bilgi için bkz. bu yönerge için resmi NGINX belgeleri.

Ingress HTTPS sertifikalarını yapılandırma

Bir web sitesi için HTTPS sertifikasını doğrudan Ingress kaynağında yapılandırabilirsiniz.

  1. Hizmet sertifikanızı hazırlayın.

    Not

    Sertifikadaki alan adı, Ingress'te belirttiğiniz ana bilgisayar adıyla eşleşmelidir. Aksi takdirde NGINX Ingress denetleyicisi sertifikayı yükleyemez.

    1. tls.crt adlı bir sertifika dosyası ve tls.key adlı bir özel anahtar dosyası oluşturmak için aşağıdaki komutu çalıştırın.

      openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout tls.key -out tls.crt -subj "/CN=foo.bar.com/O=foo.bar.com"
    2. Bir Secret oluşturmak için aşağıdaki komutu çalıştırın.

      Sertifika ve özel anahtarı kullanarak tls-test-ingress adlı bir Kubernetes Secret oluşturun. Ingress'i oluştururken bu Secret'a başvuracaksınız.

      kubectl create secret tls tls-test-ingress --key tls.key --cert tls.crt
  2. Bir Ingress kaynağı oluşturmak için aşağıdaki şablonu dağıtın. tls alanı, önceki adımda oluşturduğunuz Secret'a başvurur.

    Kubernetes 1.19 ve üzeri

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: test-test-ingress
    spec:
      # Reference the TLS certificate.
      tls:
      - hosts:
        - foo.bar.com # The domain name associated with the certificate. 
        secretName: tls-test-ingress
      rules:
      - host: foo.bar.com
        http:
          paths:
          - path: /foo
            backend:
              service:
                name: web1-svc
                port:
                  number: 80
            pathType: ImplementationSpecific

    Kubernetes 1.19'dan önceki sürümler

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: test-test-ingress
    spec:
      # Reference the TLS certificate.
      tls:
      - hosts:
        - foo.bar.com # The domain name associated with the certificate.
        secretName: tls-test-ingress
      rules:
      - host: foo.bar.com
        http:
          paths:
          - path: /foo
            backend:
              serviceName: web1-svc
              servicePort: 80
  3. TLS hizmetine erişmek için hosts dosyanızı veya DNS kayıtlarınızı yapılandırın.

    web1-svc Hizmetine https://foo.bar.com/foo adresinden erişebilirsiniz.

Karşılıklı TLS kimlik doğrulamasını yapılandırma

Bazı senaryolarda güvenliği artırmak için karşılıklı TLS kimlik doğrulamasını yapılandırmanız gerekebilir. NGINX Ingress denetleyicisi, bu özelliği ek açıklamalar kullanarak yapılandırmanıza olanak tanır.

  1. Kendinden imzalı bir sertifika yetkilisi (CA) sertifikası oluşturmak için aşağıdaki komutu çalıştırın:

    openssl req -x509 -sha256 -newkey rsa:4096 -keyout ca.key -out ca.crt -days 356 -nodes -subj '/CN=Fern Cert Authority'

    Beklenen çıktı:

    Generating a 4096 bit RSA private key
    .............................................................................................................++
    .....................................................................................++
    writing new private key to 'ca.key'
  2. Sunucu sertifikası oluşturun.

    1. Sunucu sertifikası için bir sertifika imzalama isteği (CSR) oluşturmak için aşağıdaki komutu çalıştırın:

      openssl req -new -newkey rsa:4096 -keyout server.key -out server.csr -nodes -subj '/CN=foo.bar.com'

      Beklenen çıktı:

      Generating a 4096 bit RSA private key
      ................................................................................................................................++
      .................................................................++
      writing new private key to 'server.key'
    2. Kök sertifikayı kullanarak sunucu CSR'sini imzalamak ve sunucu sertifikasını oluşturmak için aşağıdaki komutu çalıştırın:

      openssl x509 -req -sha256 -days 365 -in server.csr -CA ca.crt -CAkey ca.key -set_serial 01 -out server.crt

      Beklenen çıktı:

      Signature ok
      subject=/CN=foo.bar.com
      Getting CA Private Key
  3. İstemci sertifikası oluşturun.

    1. İstemci sertifikası için bir CSR oluşturun.

      openssl req -new -newkey rsa:4096 -keyout client.key -out client.csr -nodes -subj '/CN=Fern'

      Beklenen çıktı:

      Generating a 4096 bit RSA private key
      .......................................................................................................................................................................................++
      ..............................................++
      writing new private key to 'client.key'
      -----
    2. Kök sertifikayı kullanarak istemci CSR'sini imzalamak ve istemci sertifikasını oluşturmak için aşağıdaki komutu çalıştırın:

      openssl x509 -req -sha256 -days 365 -in client.csr -CA ca.crt -CAkey ca.key -set_serial 02 -out client.crt

      Beklenen çıktı:

      Signature ok
      subject=/CN=Fern
      Getting CA Private Key
  4. Oluşturulan sertifika dosyalarını kontrol etmek için aşağıdaki komutu çalıştırın:

    ls

    Beklenen çıktı:

    ca.crt  ca.key  client.crt  client.csr  client.key  server.crt  server.csr  server.key
  5. CA sertifikası için bir Secret oluşturmak için aşağıdaki komutu çalıştırın:

    kubectl create secret generic ca-secret --from-file=ca.crt=ca.crt

    Beklenen çıktı:

    secret/ca-secret created
  6. Sunucu sertifikası için bir Secret oluşturmak için aşağıdaki komutu çalıştırın:

    kubectl create secret generic tls-secret --from-file=tls.crt=server.crt --from-file=tls.key=server.key

    Beklenen çıktı:

    secret/tls-secret created
  7. Test amacıyla örnek bir NGINX Ingress oluşturmak için aşağıdaki şablonu dağıtın.

    Kubernetes 1.19 ve üzeri

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        nginx.ingress.kubernetes.io/auth-tls-verify-client: "on"
        nginx.ingress.kubernetes.io/auth-tls-secret: "default/ca-secret"
        nginx.ingress.kubernetes.io/auth-tls-verify-depth: "1"
        nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream: "true"
      name: nginx-test
      namespace: default
    spec:
      rules:
      - host: foo.bar.com
        http:
          paths:
          - backend:
              service:
                name: http-svc
                port: 
                  number: 80
            path: /
            pathType: ImplementationSpecific
      tls:
      - hosts:
        - foo.bar.com
        secretName: tls-secret

    Kubernetes 1.19'dan önceki sürümler

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      annotations:
        nginx.ingress.kubernetes.io/auth-tls-verify-client: "on"
        nginx.ingress.kubernetes.io/auth-tls-secret: "default/ca-secret"
        nginx.ingress.kubernetes.io/auth-tls-verify-depth: "1"
        nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream: "true"
      name: nginx-test
      namespace: default
    spec:
      rules:
      - host: foo.bar.com
        http:
          paths:
          - backend:
              serviceName: http-svc
              servicePort: 80
            path: /
      tls:
      - hosts:
        - foo.bar.com
        secretName: tls-secret

    Beklenen çıktı:

    ingress.networking.k8s.io/nginx-test configured
  8. Ingress'in IP adresini görüntülemek için aşağıdaki komutu çalıştırın.

    kubectl get ing

    ADDRESS sütunundaki IP adresi, Ingress'in IP adresidir.

    NAME         HOSTS                    ADDRESS         PORTS     AGE
    nginx-test   foo.bar.com              39.102.XX.XX    80, 443   4h42m
  9. Ana bilgisayarlar dosyanızı güncellemek için aşağıdaki komutu çalıştırın. IP adresini Ingress'inizin gerçek IP adresiyle değiştirin.

    echo "39.102.XX.XX  foo.bar.com" | sudo tee -a /etc/hosts

    Yapılandırmayı doğrulayın:

    • İstemci sertifikası olmadan hizmete erişin:

      curl --cacert ./ca.crt  https://foo.bar.com

      Beklenen çıktı:

      <html>
      <head><title>400 No required SSL certificate was sent</title></head>
      <body>
      <center><h1>400 Bad Request</h1></center>
      <center>No required SSL certificate was sent</center>
      <hr><center>nginx/1.19.0</center>
      </body>
      </html>
    • İstemci sertifikasıyla hizmete erişin:

      curl --cacert ./ca.crt --cert ./client.crt --key ./client.key https://foo.bar.com

      Beklenen çıktı:

      <!DOCTYPE html>
      <html>
      <head>
      <title>Welcome to nginx!</title>
      <style>
          body {
              width: 35em;
              margin: 0 auto;
              font-family: Tahoma, Verdana, Arial, sans-serif;
          }
      </style>
      </head>
      <body>
      <h1>Welcome to nginx!</h1>
      <p>If you see this page, the nginx web server is successfully installed and
      working. Further configuration is required.</p>
      
      <p>For online documentation and support please refer to
      <a href="http://nginx.org/">nginx.org</a>.<br/>
      Commercial support is available at
      <a href="http://nginx.com/">nginx.com</a>.</p>
      
      <p><em>Thank you for using nginx.</em></p>
      </body>
      </html>

İstekleri HTTPS arka uçlara iletme

Varsayılan olarak NGINX Ingress denetleyicisi istekleri arka uç pod'larına HTTP kullanarak iletir. Arka uç hizmetiniz HTTPS kullanıyorsa denetleyiciyi arka uç bağlantıları için HTTPS kullanacak şekilde yapılandırmak üzere nginx.ingress.kubernetes.io/backend-protocol: "HTTPS" ek açıklamasını ekleyebilirsiniz.

Aşağıda örnek bir NGINX Ingress yapılandırması verilmiştir:

Kubernetes 1.19 ve üzeri

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: backend-https
  annotations:
    # Note: You must specify that the backend service uses HTTPS.
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
spec:
  tls:
  - hosts:
    - <YOUR-HOST-NAME>
    secretName: <YOUR-SECRET-CERT-NAME>
  rules:
  - host: <YOUR-HOST-NAME>
    http:
      paths:
      - path: /
        backend:
          service:
            name: <YOUR-SERVICE-NAME>
            port: 
              number: <YOUR-SERVICE-PORT>
        pathType: ImplementationSpecific

Kubernetes 1.19'dan önceki sürümler

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: backend-https
  annotations:
    # Note: You must specify that the backend service uses HTTPS.
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
spec:
  tls:
  - hosts:
    - <YOUR-HOST-NAME>
    secretName: <YOUR-SECRET-CERT-NAME>
  rules:
  - host: <YOUR-HOST-NAME>
    http:
      paths:
      - path: /
        backend:
          serviceName: <YOUR-SERVICE-NAME>
          servicePort: <YOUR-SERVICE-PORT>

Alan adlarında düzenli ifadeler kullanma

Varsayılan olarak Kubernetes Ingress kaynakları ana bilgisayar adlarında düzenli ifadeleri desteklemez. Ancak bu özelliği nginx.ingress.kubernetes.io/server-alias ek açıklamasını kullanarak etkinleştirebilirsiniz.

  1. Aşağıdaki şablonu dağıtın. Bu örnekte ~^www\.\d+\.example\.com düzenli ifadesi kullanılmıştır.

    Kubernetes 1.19 ve üzeri

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: ingress-regex
      namespace: default
      annotations:
        nginx.ingress.kubernetes.io/server-alias: '~^www\.\d+\.example\.com$, abc.example.com'
    spec:
      rules:
      - host: foo.bar.com
        http:
          paths:
          - path: /foo
            backend:
              service:
                name: http-svc1
                port:
                  number: 80
            pathType: ImplementationSpecific

    Kubernetes 1.19'dan önceki sürümler

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: ingress-regex
      namespace: default
      annotations:
        nginx.ingress.kubernetes.io/server-alias: '~^www\.\d+\.example\.com$, abc.example.com'
    spec:
      rules:
      - host: foo.bar.com
        http:
          paths:
          - path: /foo
            backend:
              serviceName: http-svc1
              servicePort: 80
  2. NGINX Ingress denetleyicisinin yapılandırmasını kontrol edin.

    1. NGINX Ingress denetleyicisinin pod'larını görüntülemek için aşağıdaki komutu çalıştırın:

      kubectl get pods -n kube-system | grep nginx-ingress-controller

      Beklenen çıktı:

      nginx-ingress-controller-77cd987c4c-c****         1/1     Running   0          1h
      nginx-ingress-controller-77cd987c4c-x****         1/1     Running   0          1h
    2. NGINX Ingress denetleyicisinin yapılandırmasını görüntülemek için aşağıdaki komutu çalıştırın. Çıktı, server_name alanının güncellendiğini gösterir.

      kubectl exec -n kube-system nginx-ingress-controller-77cd987c4c-c**** cat /etc/nginx/nginx.conf | grep -C3 "foo.bar.com"

      Beklenen çıktı:

        # start server foo.bar.com
        server {
      --
        server {
          server_name foo.bar.com abc.example.com ~^www\.\d+\.example\.com$ ;
          listen 80  ;
          listen 443  ssl http2 ;
      --
      --
          }
        }
        # end server foo.bar.com
  3. Ingress'in IP adresini almak için aşağıdaki komutu çalıştırın:

    kubectl get ing

    Beklenen çıktı:

    NAME            HOSTS         ADDRESS          PORTS     AGE
    ingress-regex   foo.bar.com   101.37.XX.XX     80        11s
  4. Farklı kurallarla hizmet erişimini test etmek için aşağıdaki komutları çalıştırın.

    <IP_ADDRESS> yerine önceki adımda aldığınız IP adresini yazın.

    • Host: foo.bar.com kullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:

      curl -H "Host: foo.bar.com" <IP_ADDRESS>/foo

      Beklenen çıktı:

      /foo
    • Host: www.123.example.com kullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:

      curl -H "Host: www.123.example.com" <IP_ADDRESS>/foo

      Beklenen çıktı:

      /foo
    • Host: www.321.example.com kullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:

      curl -H "Host: www.321.example.com" <IP_ADDRESS>/foo

      Beklenen çıktı:

      /foo

Joker karakterli alan adları kullanma

Kubernetes kümelerindeki NGINX Ingress kaynakları joker karakterli alan adlarını destekler. Örneğin, *.ingress-regex.com gibi bir ana bilgisayar adı yapılandırabilirsiniz.

  1. Bir NGINX Ingress oluşturmak için aşağıdaki şablonu dağıtın.

    Kubernetes 1.19 ve üzeri

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: ingress-regex
      namespace: default
    spec:
      rules:
      - host: *.ingress-regex.com
        http:
          paths:
          - path: /foo
            backend:
              service:
                name: http-svc1
                port:
                  number: 80
            pathType: ImplementationSpecific

    Kubernetes 1.19'dan önceki sürümler

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: ingress-regex
      namespace: default
    spec:
      rules:
      - host: *.ingress-regex.com
        http:
          paths:
          - path: /foo
            backend:
              serviceName: http-svc1
              servicePort: 80
  2. NGINX Ingress denetleyicisinin yapılandırmasını kontrol etmek için aşağıdaki komutu çalıştırın. Çıktı, server_name alanının güncellendiğini gösterir.

    kubectl exec -n kube-system <nginx-ingress-pod-name> cat /etc/nginx/nginx.conf | grep -C3 "*.ingress-regex.com"
    Not

    nginx-ingress-pod-name yerine NGINX Ingress denetleyicisi pod'unuzun gerçek adını yazın.

    Beklenen çıktı:

    # start server *.ingress-regex.com
      server {
        server_name *.ingress-regex.com ;
        listen 80;
        listen [::]:80;
    ...
      }
      # end server *.ingress-regex.com

    NGINX Ingress denetleyicisinin daha yeni sürümleri için beklenen çıktı:

    ## start server *.ingress-regex.com
      server {
        server_name ~^(?<subdomain>[\w-]+)\.ingress-regex\.com$ ;
        listen 80;
        listen [::]:80;
    ...
      }
      ## end server *.ingress-regex.com
  3. Ingress'in IP adresini almak için aşağıdaki komutu çalıştırın:

    kubectl get ing

    Beklenen çıktı:

    NAME            HOSTS                 ADDRESS           PORTS     AGE
    ingress-regex   *.ingress-regex.com   101.37.XX.XX      80        11s
  4. Farklı kurallarla hizmet erişimini test etmek için aşağıdaki komutları çalıştırın.

    <IP_ADDRESS> yerine önceki adımda aldığınız IP adresini yazın.

    • Host: abc.ingress-regex.com kullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:

      curl -H "Host: abc.ingress-regex.com" <IP_ADDRESS>/foo

      Beklenen çıktı:

      /foo
    • Host: 123.ingress-regex.com kullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:

      curl -H "Host: 123.ingress-regex.com" <IP_ADDRESS>/foo

      Beklenen çıktı:

      /foo
    • Host: a1b1.ingress-regex.com kullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:

      curl -H "Host: a1b1.ingress-regex.com" <IP_ADDRESS>/foo

      Beklenen çıktı:

      /foo

Ek açıklamalarla canary sürümleri

Ek açıklamalar kullanarak canary sürümü uygulayabilirsiniz. Canary özelliğini etkinleştirmek için nginx.ingress.kubernetes.io/canary: "true" ek açıklamasını ayarlamanız gerekir. Ardından trafiği kontrol etmek için farklı ek açıklamalar kullanabilirsiniz:

  • nginx.ingress.kubernetes.io/canary-weight: Canary hizmetine yönlendirilecek trafik yüzdesini (0 ile 100 arasında bir tamsayı) belirtir.

  • nginx.ingress.kubernetes.io/canary-by-header: Trafiği bir istek üstbilgisine göre böler. Yapılandırılan header değeri always ise istekler canary hizmetine yönlendirilir. header değeri never ise istekler canary hizmetine yönlendirilmez. Diğer header değerleri yok sayılır ve istekler canary önceliğine göre diğer kurallarla tanımlanan canary hizmetlerine yönlendirilir.

  • nginx.ingress.kubernetes.io/canary-by-header-value ve nginx.ingress.kubernetes.io/canary-by-header: Bir istekteki header ve header-value belirtilen değerlerle eşleştiğinde trafik canary hizmetine yönlendirilir. Diğer header değerleri yok sayılır ve trafik canary önceliğine göre diğer kurallarda belirtilen canary hizmetlerine yönlendirilir.

  • nginx.ingress.kubernetes.io/canary-by-cookie: Trafiği bir tanımlama bilgisine göre böler. Belirtilen cookie değeri always ise istek trafiği canary hizmetine yönlendirilir. Belirtilen cookie değeri never ise istek trafiği canary hizmetine yönlendirilmez.

Aşağıdaki örneklerde bu ek açıklamaların bazıları nasıl yapılandırılacağı gösterilmektedir. Daha fazla bilgi için bkz. Canary sürümleri ve mavi-yeşil dağıtımları uygulamak için NGINX Ingress denetleyicisini kullanma.

  • Ağırlık tabanlı canary sürümü: Canary hizmetinin ağırlığını %20 olarak ayarlayın.

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        kubernetes.io/ingress.class: nginx
        nginx.ingress.kubernetes.io/canary: "true"
        nginx.ingress.kubernetes.io/canary-weight: "20"
  • Üstbilgi tabanlı canary sürümü: İstek üstbilgisi ack:always ise istek canary hizmetine yönlendirilir. İstek üstbilgisi ack:never ise istek canary hizmetine yönlendirilmez. ack üstbilgisinin diğer değerleri için trafik canary ağırlığına göre canary hizmetine yönlendirilir.

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        kubernetes.io/ingress.class: nginx
        nginx.ingress.kubernetes.io/canary: "true"
        nginx.ingress.kubernetes.io/canary-weight: "50"
        nginx.ingress.kubernetes.io/canary-by-header: "ack"
  • Üstbilgi tabanlı canary sürümü (özel üstbilgi değeri): İstek üstbilgisi ack:alibaba ise istek canary hizmetine yönlendirilir. ack üstbilgisinin diğer değerleri için trafik canary ağırlığına göre canary hizmetine yönlendirilir.

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        kubernetes.io/ingress.class: nginx
        nginx.ingress.kubernetes.io/canary: "true"
        nginx.ingress.kubernetes.io/canary-weight: "20"
        nginx.ingress.kubernetes.io/canary-by-header: "ack"
        nginx.ingress.kubernetes.io/canary-by-header-value: "alibaba"
  • Tanımlama bilgisi tabanlı canary sürümü: Üstbilgi eşleşmezse ve istek tanımlama bilgisi hangzhou_region=always ise istek canary hizmetine yönlendirilir.

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        kubernetes.io/ingress.class: nginx
        nginx.ingress.kubernetes.io/canary: "true"
        nginx.ingress.kubernetes.io/canary-weight: "20"
        nginx.ingress.kubernetes.io/canary-by-header: "ack"
        nginx.ingress.kubernetes.io/canary-by-header-value: "alibaba"
        nginx.ingress.kubernetes.io/canary-by-cookie: "hangzhou_region"
Not
  • Tanımlama bilgisi tabanlı canary sürümü yalnızca always ve never değerlerini destekler. Özel değerleri desteklemez.

  • Canary kurallarının önceliği şu şekildedir (yüksekten düşüğe): üstbilgi tabanlı > tanımlama bilgisi tabanlı > ağırlık tabanlı.

cert-manager ile ücretsiz HTTPS sertifikaları

cert-manager, bir Kubernetes kümesinde HTTPS sertifikalarını otomatik olarak sağlayan ve yenileyen açık kaynaklı bir sertifika yönetim aracıdır. Aşağıdaki örnek, cert-manager kullanarak ücretsiz bir sertifika için nasıl başvuru yapılacağını ve otomatik yenilemenin nasıl etkinleştirileceğini göstermektedir.

Önemli

cert-manager açık kaynaklı bir bileşendir ve ACK tarafından bakımı yapılmamaktadır. Üretim ortamlarında dikkatli kullanın. cert-manager'ı yükseltmek için bkz. cert-manager'ı yükseltme.

  1. cert-manager'ı dağıtmak için aşağıdaki komutu çalıştırın.

    kubectl apply -f https://github.com/cert-manager/cert-manager/releases/latest/download/cert-manager.yaml
  2. Pod durumunu kontrol etmek için aşağıdaki komutu çalıştırın.

    kubectl get pods -n cert-manager

    Beklenen çıktı:

    NAME                     READY   STATUS    RESTARTS   AGE
    cert-manager-1           1/1     Running   0          2m11s
    cert-manager-cainjector  1/1     Running   0          2m11s
    cert-manager-webhook     1/1     Running   0          2m10s
  3. Aşağıdaki şablonu kullanarak bir ClusterIssuer oluşturun.

    apiVersion: cert-manager.io/v1
    kind: ClusterIssuer
    metadata:
      name: letsencrypt-prod-http01
    spec:
      acme:
        server: https://acme-v02.api.letsencrypt.org/directory
        email: <your_email_n***@gmail.com>  # Replace this with your email address.
        privateKeySecretRef:
          name: letsencrypt-http01
        solvers:
        - http01: 
            ingress:
              class: nginx
  4. ClusterIssuer durumunu kontrol etmek için aşağıdaki komutu çalıştırın.

    kubectl get clusterissuer

    Beklenen çıktı:

    NAME                         READY   AGE
    letsencrypt-prod-http01      True    17s
  5. Bir Nginx Ingress kaynak nesnesi oluşturun.

    Kubernetes 1.19 ve üzeri

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: ingress-tls
      annotations:
        kubernetes.io/ingress.class: "nginx"
        cert-manager.io/cluster-issuer: "letsencrypt-prod-http01"
    spec:
      tls:
      - hosts:
        - <YOUR_DOMAIN_NAME>        # Replace this with your domain name.
        secretName: ingress-tls   
      rules:
      - host: <YOUR_DOMAIN_NAME>    # Replace this with your domain name.
        http:
          paths:
          - path: /
            backend:
              service:
                name: <YOUR_SERVICE_NAME>  # Replace this with your backend service name.
                port: 
                  number: <YOUR_SERVICE_PORT>  # Replace this with your service port.
            pathType: ImplementationSpecific

    Kubernetes 1.19'dan önceki sürümler

    apiVersion: extensions/v1beta1
    kind: Ingress
    metadata:
      name: ingress-tls
      annotations:
        kubernetes.io/ingress.class: "nginx"
        cert-manager.io/cluster-issuer: "letsencrypt-prod-http01"
    spec:
      tls:
      - hosts:
        - <YOUR_DOMAIN_NAME>        # Replace this with your domain name.
        secretName: ingress-tls   
      rules:
      - host: <YOUR_DOMAIN_NAME>    # Replace this with your domain name.
        http:
          paths:
          - path: /
            backend:
              serviceName: <YOUR_SERVICE_NAME>  # Replace this with your backend service name.
              servicePort: <YOUR_SERVICE_PORT>  # Replace this with your service port.
    Not

    <YOUR_DOMAIN_NAME> için belirttiğiniz alan adı aşağıdaki koşulları karşılamalıdır:

    • Alan adının uzunluğu 64 karakteri aşmamalıdır.

    • Joker karakterli alan adları desteklenmez.

    • Alan adına internet üzerinden HTTP ile erişilebilir olmalıdır.

  6. Sertifika durumunu kontrol etmek için aşağıdaki komutu çalıştırın:

    kubectl get cert

    Beklenen çıktı:

    NAME          READY   SECRET        AGE
    ingress-tls   True    ingress-tls   52m
    Not

    READY durumu True değilse sertifika işleme ayrıntılarını görüntülemek için kubectl describe cert ingress-tls komutunu çalıştırabilirsiniz.

  7. Secret'ı kontrol etmek için aşağıdaki komutu çalıştırın:

    kubectl get secret  ingress-tls

    Beklenen çıktı:

    NAME          TYPE                DATA   AGE
    ingress-tls   kubernetes.io/tls   2      2m
  8. Web tarayıcınızı açın ve alanınıza erişmek için https://<YOUR_DOMAIN_NAME> adresini girin.

HTTP'den HTTPS'ye yönlendirme

NGINX Ingress'inize nginx.ingress.kubernetes.io/ssl-redirect ek açıklamasını ekleyerek HTTP trafiğinin HTTPS'ye yönlendirilmesini zorunlu kılabilirsiniz. Aşağıda bir örnek verilmiştir:

Kubernetes 1.19 ve üzeri

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true" # Enforce the redirection of HTTP traffic to HTTPS.

Kubernetes 1.19'dan önceki sürümler

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true" # Enforce the redirection of HTTP traffic to HTTPS.