Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Configure advanced NGINX Ingress features

Son Güncelleme:Oct 06, 2026

NGINX Ingress için URL yeniden yazma, TLS, mTLS, canary sürümleri ve cert-manager kurulumunu yapın.

Ön koşullar

Aşağıdaki koşulların sağlandığından emin olun:

NGINX yapılandırma yöntemleri

ACK'deki NGINX Ingress denetleyicisi, açık kaynaklı üst akışla tam uyumludur. Üç yöntem mevcuttur:

Yöntem Kapsam Referans
Annotation Bireysel Ingress — belirli bir Ingress YAML dosyasını değiştirir Annotations
ConfigMap Tüm Ingress'ler — kube-system/nginx-configuration ConfigMap dosyasını değiştirir ConfigMaps
Custom NGINX template Tam kontrol — diğer yöntemler yetersiz kaldığında NGINX şablonunu özelleştirir Custom NGINX template

URL yönlendirmesini yapılandırma

NGINX Ingress denetleyicisi varsayılan olarak istekleri tam yol ile iletir. Arka uç yolunuz farklıysa, bunu yeniden yazmak için nginx.ingress.kubernetes.io/rewrite-target annotation öğesini kullanın.

NGINX Ingress denetleyicisi 0.22.0 ve sonraki sürümler, yoldaki yakalama gruplarına sahip düzenli ifadeler gerektirir; bunlar rewrite-target annotation öğesi ile birlikte kullanılır.

Kümenizin Kubernetes sürümü için şablonu uygulayın.

Kubernetes 1.19 ve sonrası

cat <<-EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: foo.bar.com
  namespace: default
  annotations:
    # Rewrite the request path: strip the /svc prefix and forward the remainder to the backend.
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
  - host: foo.bar.com
    http:
      paths:
      - path: /svc(/|$)(.*)
        backend:
          service:
            name: web1-service
            port:
              number: 80
        pathType: ImplementationSpecific
EOF

Kubernetes 1.19 veya öncesi

cat <<-EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: foo.bar.com
  namespace: default
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
  - host: foo.bar.com
    http:
      paths:
      - path: /svc(/|$)(.*)
        backend:
          serviceName: web1-service
          servicePort: 80
EOF

Verify the configuration:

  1. Ingress IP adresini alı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. ADDRESS değerindeki Ingress IP adresini kullanarak bir istek gönderin.

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

    Beklenen çıktı:

    web1: /foo

    /svc öneki kaldırılır ve arka uç /foo alır.

Yeniden yazma kurallarını yapılandırma

nginx.ingress.kubernetes.io/rewrite-target annotation öğesi temel yol yeniden yazma işlemlerini yönetir. Gelişmiş yeniden yazma işlemleri için, özel NGINX yapılandırmasını doğrudan enjekte etmek amacıyla snippet annotation öğelerini kullanın:

Annotation Hedef blok Kullanım durumu
nginx.ingress.kubernetes.io/server-snippet server {} bloğu Sunucu düzeyinde yeniden yazma, yönlendirme
nginx.ingress.kubernetes.io/configuration-snippet location {} bloğu Konum düzeyinde yeniden yazma, özel başlıklar

Örnek:

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;

Oluşturulan nginx.conf dosyasındaki snippet'i doğrulayın:

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

server-snippet öğesi server {} bloğunda ve configuration-snippet öğesi location {} bloğunda görünür:

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

Genel snippet'leri ConfigMap içindeki server-snippet ile yapılandırın. Tam rewrite sözdizimi için NGINX yeniden yazma modülü belgelerine bakın.

Ingress için TLS sertifikası yapılandırma

HTTPS'yi etkinleştirmek için bir Ingress'e TLS sertifikası ekleyin.

TLS sertifikası alan adı, Ingress host değeriyle eşleşmelidir. Eşleşmemesi durumunda denetleyici sertifikayı yükleyemez.

Adım 1: Sertifikayı ve Secret'ı oluşturun.

  1. Kendinden imzalı bir sertifika ve özel anahtar oluşturun.

    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. Sertifikayı ve anahtarı bir Kubernetes Secret'ında saklayın.

    kubectl create secret tls tls-test-ingress --key tls.key --cert tls.crt

Adım 2: Secret'a referans veren bir Ingress oluşturun.

Kubernetes 1.19 ve sonrası

cat <<EOF | kubectl create -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: test-test-ingress
spec:
  tls:
  - hosts:
    - foo.bar.com
    secretName: tls-test-ingress  # Reference the Secret created above.
  rules:
  - host: tls-test-ingress.com
    http:
      paths:
      - path: /foo
        backend:
          service:
            name: web1-svc
            port:
              number: 80
        pathType: ImplementationSpecific
EOF

Kubernetes 1.19 veya öncesi

cat <<EOF | kubectl create -f -
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: test-test-ingress
spec:
  tls:
  - hosts:
    - foo.bar.com
    secretName: tls-test-ingress
  rules:
  - host: tls-test-ingress.com
    http:
      paths:
      - path: /foo
        backend:
          serviceName: web1-svc
          servicePort: 80
EOF

tls-test-ingress.com adresini Ingress IP'sine çözmek için hosts dosyanızı veya DNS kayıtlarınızı güncelleyin. Hizmeti https://tls-test-ingress.com/foo adresinden erişilebilir hale getirin.

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

mTLS, TLS el sıkışması sırasında hem sunucunun hem de istemcinin sertifika sunmasını gerektirir.

mTLS ana bilgisayar bazında uygulanır; aynı ana bilgisayar altındaki farklı yollar ayrı ayarlara sahip olamaz.

Dört annotation öğesi mTLS'yi kontrol eder:

Annotation Açıklama
nginx.ingress.kubernetes.io/auth-tls-verify-client İstemci sertifikası doğrulamasını etkinleştirir. Değerler: "on" (geçerli sertifika gerekir; yoksa HTTP 400 döner), "optional" (ister ancak zorunlu kılmaz) veya "off" (devre dışı bırakır).
nginx.ingress.kubernetes.io/auth-tls-secret İstemci doğrulaması için CA sertifikasını içeren Secret'ın namespace/secretName değeri.
nginx.ingress.kubernetes.io/auth-tls-verify-depth İstemci sertifika zincirinin maksimum derinliği. Varsayılan: 1.
nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream "true" ise, istemci sertifikasını bir istek başlığında arka uca iletir.

Adım 1: Kendinden imzalı bir sertifika yetkilisi (CA) oluşturun.

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'

Adım 2: Bir sunucu sertifikası oluşturun.

  1. Sertifika imzalama isteği (CSR) oluşturun.

    openssl req -new -newkey rsa:4096 \
      -keyout server.key -out server.csr \
      -nodes -subj '/CN=foo.bar.com'
  2. Sunucu sertifikasını üretmek için CSR'yi CA ile imzalayı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

Adım 3: Bir istemci sertifikası oluşturun.

  1. İstemci CSR'sini oluşturun.

    openssl req -new -newkey rsa:4096 \
      -keyout client.key -out client.csr \
      -nodes -subj '/CN=Fern'
  2. İstemci CSR'sini CA ile imzalayı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

Adım 4: Tüm sertifika dosyalarının mevcut olduğunu onaylayın.

ls

Beklenen çıktı:

ca.crt  ca.key  client.crt  client.csr  client.key  server.crt  server.csr  server.key

Adım 5: CA ve sunucu sertifikaları için Secret'lar oluşturun.

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

Adım 6: mTLS annotation öğeleriyle NGINX Ingress'i oluşturun.

Kubernetes 1.19 ve sonrası

cat <<-EOF | kubectl apply -f -
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
EOF

Kubernetes 1.19 veya öncesi

cat <<-EOF | kubectl apply -f -
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
EOF

Adım 7: /etc/hosts dosyasını oluşturun veya güncelleyin.

Ingress IP adresini alın ve /etc/hosts dosyasına ekleyin.

kubectl get ing

Beklenen çıktı:

NAME         HOSTS         ADDRESS        PORTS     AGE
nginx-test   foo.bar.com   39.102.XX.XX   80, 443   4h42m
echo "39.102.XX.XX  foo.bar.com" | sudo tee -a /etc/hosts

Verify the configuration:

  • İstemci sertifikası olmadan — sunucu isteği reddeder:

    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 — istek başarılı olur:

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

    Beklenen çıktı: varsayılan nginx karşılama sayfası (Welcome to nginx!).

HTTPS isteklerini arka uç konteynerlerine iletme

NGINX Ingress denetleyicisi varsayılan olarak HTTP'yi arka uçlara iletir. HTTPS arka uçları için nginx.ingress.kubernetes.io/backend-protocol: "HTTPS" annotation öğesini ekleyin.

Kubernetes 1.19 ve sonrası

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: backend-https
  annotations:
    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 veya öncesi

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: backend-https
  annotations:
    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>

Yer tutucuları kendi değerlerinizle değiştirin:

Yer Tutucu Açıklama
<your-host-name> Alan adınız
<your-secret-cert-name> TLS sertifikanızı içeren Secret
<your-service-name> Arka uç Service adınız
<your-service-port> Arka uç Service bağlantı noktanız

Alan adları için düzenli ifadeleri kullanma

Kubernetes, Ingress host alanlarında varsayılan olarak düzenli ifadeleri desteklemez. nginx.conf dosyasına regex tabanlı sunucu takma adları eklemek için nginx.ingress.kubernetes.io/server-alias annotation öğesini kullanın.

Adım 1: Regex sunucu takma adı içeren bir Ingress oluşturun.

Bu örnek, www.<digits>.example.com ve abc.example.com biçimindeki herhangi bir ana bilgisayar adıyla eşleşir.

Kubernetes 1.19 ve sonrası

cat <<-EOF | kubectl apply -f -
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
EOF

Kubernetes 1.19 veya öncesi

cat <<-EOF | kubectl apply -f -
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
EOF

Adım 2: Takma adların nginx.conf dosyasında aktif olduğunu doğrulayın.

  1. NGINX Ingress denetleyicisi pod adını alı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. Oluşturulan yapılandırmayı inceleyin.

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

    Beklenen çıktı — server_name yönergesi tüm takma adları listeler:

    server {
      server_name foo.bar.com abc.example.com ~^www\.\d+\.example\.com$ ;
      listen 80  ;
      listen 443  ssl http2 ;

Adım 3: Ingress IP adresini alın.

kubectl get ing

Beklenen çıktı:

NAME            HOSTS         ADDRESS        PORTS   AGE
ingress-regex   foo.bar.com   101.37.XX.XX   80      11s

Adım 4: Eşleşen tüm ana bilgisayar adlarını test edin.

<IP_ADDRESS> yerine önceki adımdaki adresi yazın.

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

Joker karakterli alan adlarını belirtme

NGINX Ingress'ler yerel olarak joker karakterli alan adlarını destekler. Bu örnek, ingress-regex.com alan adının herhangi bir alt alan adıyla eşleşir.

Adım 1: Joker karakterli bir ana bilgisayar içeren bir Ingress oluşturun.

Kubernetes 1.19 ve sonrası

cat <<-EOF | kubectl apply -f -
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
EOF

Kubernetes 1.19 veya öncesi

cat <<-EOF | kubectl apply -f -
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
EOF

Adım 2: nginx.conf dosyasındaki server_name değerini doğrulayın.

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

<nginx-ingress-pod-name> yerine gerçek pod adını yazın.

Beklenen çıktı (eski denetleyici sürümleri):

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

Beklenen çıktı (en son denetleyici sürümleri):

## start server *.ingress-regex.com
server {
  server_name ~^(?<subdomain>[\w-]+)\.ingress-regex\.com$ ;
  listen 80;
  listen [::]:80;
...
}
## end server *.ingress-regex.com

Adım 3: Ingress IP adresini alın.

kubectl get ing

Beklenen çıktı:

NAME            HOSTS                 ADDRESS        PORTS   AGE
ingress-regex   *.ingress-regex.com   101.37.XX.XX   80      11s

Adım 4: Joker karakter eşleşmesini test edin.

<IP_ADDRESS> yerine önceki adımdaki adresi yazın.

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

Canary sürümleri için annotation öğelerini kullanma

Canary sürümleri, trafiğin bir alt kümesini yeni bir hizmet sürümüne yönlendirir. Tüm canary yapılandırmaları, canary Ingress üzerinde nginx.ingress.kubernetes.io/canary: "true" gerektirir.

Bu annotation öğeleri trafik bölünmesini kontrol eder ve şu sırayla değerlendirilir: başlık tabanlı → çerez tabanlı → ağırlık tabanlı.

Annotation Değerler Koşul karşılanmadığında davranış
nginx.ingress.kubernetes.io/canary-weight 0–100 arasında tamsayı (yüzde) Yok — son geri dönüş olarak işlev görür
nginx.ingress.kubernetes.io/canary-by-header Herhangi bir başlık adı Başlık yoksa veya always veya never ile eşleşmiyorsa, çerez tabanlı veya ağırlık tabanlı kurallara geçer
nginx.ingress.kubernetes.io/canary-by-header-value Özel dize (canary-by-header ile kullanılır) Başlık değeri eşleşmezse, önceliğe göre sonraki kurala geçer
nginx.ingress.kubernetes.io/canary-by-cookie Çerez adı Çerez değeri always veya never olmalıdır — özel değerler desteklenmez

Ağırlık tabanlı canary sürümü

Trafiğin %20'sini canary Service'e yönlendirir:

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"

Başlık tabanlı canary sürümü

ack başlığı always ise, trafik canary'ye yönlendirilir. never ise, canary atlanır. Diğer değerler ağırlığa (%50) geri döner:

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"

Özel başlık değeri içeren başlık tabanlı canary sürümü

ack başlığı alibaba değerine eşitse, trafik canary'ye yönlendirilir. Diğer değerler ağırlığa (%20) geri döner:

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"

Çerez tabanlı canary sürümü

Hiçbir başlık kuralı eşleşmez ve hangzhou_region çerezi always ise, trafik canary'ye yönlendirilir. Diğer durumlar ağırlığa (%20) geri döner:

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"
Çerez değerleri always veya never olmalıdır. Özel değerler desteklenmez.

Tam bir kılavuz için bkz. Canary sürümlerini ve mavi-yeşil dağıtımları uygulamak için NGINX Ingress denetleyicisini kullanma.

cert-manager ile ücretsiz TLS sertifikası alma

cert-manager, Kubernetes'te Let's Encrypt aracılığıyla TLS sertifikası sağlama ve yenileme işlemlerini otomatikleştirir.

Bu YAML, ASK (Sunucusuz Kubernetes) kümeleri için tasarlanmıştır. ACK kümeleri için cert-manager yükleme kılavuzuna bakın.

cert-manager'ı dağıtma

kubectl apply -f https://raw.githubusercontent.com/AliyunContainerService/serverless-k8s-examples/master/cert-manager/ask-cert-manager.yaml

cert-manager pod'larının çalıştığını doğrulama

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

ClusterIssuer oluşturma

cat <<EOF | kubectl apply -f -
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_name@gmail.com>  # Replace with your email address.
    privateKeySecretRef:
      name: letsencrypt-http01
    solvers:
    - http01:
        ingress:
          class: nginx
EOF

ClusterIssuer'ın hazır olduğunu onaylama

kubectl get clusterissuer

Beklenen çıktı:

NAME                         READY   AGE
letsencrypt-prod-http01      True    17s

Sertifika isteyen bir Ingress oluşturma

Alan adı aşağıdaki koşulları karşılamalıdır:

  • 64 karakterden fazla olmamalıdır

  • Joker karakterli bir alan adı olmamalıdır

  • HTTP üzerinden herkese açık olarak erişilebilir olmalıdır (ACME HTTP-01 sorgulaması için gereklidir)

Kubernetes 1.19 ve sonrası

cat <<EOF | kubectl apply -f -
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 with your domain name.
    secretName: ingress-tls
  rules:
  - host: <your_domain_name>   # Replace with your domain name.
    http:
      paths:
      - path: /
        backend:
          service:
            name: <your_service_name>   # Replace with your Service name.
            port:
              number: <your_service_port>  # Replace with your Service port.
        pathType: ImplementationSpecific
EOF

Kubernetes 1.19 veya öncesi

cat <<EOF | kubectl apply -f -
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>
    secretName: ingress-tls
  rules:
  - host: <your_domain_name>
    http:
      paths:
      - path: /
        backend:
          serviceName: <your_service_name>
          servicePort: <your_service_port>
EOF

Sertifika verilmesini izleme

kubectl get cert

Beklenen çıktı (verme işlemi birkaç dakika sürebilir):

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

READY değeri True değilse, ayrıntılar için sertifikayı inceleyin:

kubectl describe cert ingress-tls

Şuna benzer bir Events bölümü arayın:

Events:
  Type    Reason     Age    From          Message
  ----    ------     ---    ----          -------
  Normal  Requested  64s    cert-manager  Created new CertificateRequest resource "ingress-tls-xxxxx"
  Normal  Issuing    40s    cert-manager  The certificate has been successfully issued

Sertifika Secret'ını doğrulama

kubectl get secret ingress-tls

Beklenen çıktı:

NAME          TYPE                DATA   AGE
ingress-tls   kubernetes.io/tls   2      2m

HTTPS'nin etkin olduğunu onaylamak için https://<your_domain_name> adresine erişin.

Sonraki adımlar