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.
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
Küme KubeConfig dosyasını aldınız ve bir kubectl istemcisi kullanarak kümeye bağlandınız.
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-configurationConfigMap'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
-
NGINX hizmetine erişin.
-
ADDRESSdeğerini almak için aşağıdaki komutu çalıştırın.kubectl get ingressBeklenen çıktı:
NAME CLASS HOSTS ADDRESS PORTS AGE foo.bar.com nginx foo.bar.com 172.16.XX.XX 80 46m -
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/fooBeklenen çı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:serverbloğuna özel yapılandırmalar ekler.nginx.ingress.kubernetes.io/configuration-snippet:locationbloğ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.
-
Hizmet sertifikanızı hazırlayın.
NotSertifikadaki alan adı, Ingress'te belirttiğiniz ana bilgisayar adıyla eşleşmelidir. Aksi takdirde NGINX Ingress denetleyicisi sertifikayı yükleyemez.
-
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" -
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
-
-
Bir Ingress kaynağı oluşturmak için aşağıdaki şablonu dağıtın.
tlsalanı, ö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: ImplementationSpecificKubernetes 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 -
TLS hizmetine erişmek için
hostsdosyanızı veya DNS kayıtlarınızı yapılandırın.web1-svcHizmetinehttps://foo.bar.com/fooadresinden 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.
-
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' -
Sunucu sertifikası oluşturun.
-
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' -
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.crtBeklenen çıktı:
Signature ok subject=/CN=foo.bar.com Getting CA Private Key
-
-
İstemci sertifikası oluşturun.
-
İ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' ----- -
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.crtBeklenen çıktı:
Signature ok subject=/CN=Fern Getting CA Private Key
-
-
Oluşturulan sertifika dosyalarını kontrol etmek için aşağıdaki komutu çalıştırın:
lsBeklenen çıktı:
ca.crt ca.key client.crt client.csr client.key server.crt server.csr server.key -
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.crtBeklenen çıktı:
secret/ca-secret created -
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.keyBeklenen çıktı:
secret/tls-secret created -
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-secretKubernetes 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-secretBeklenen çıktı:
ingress.networking.k8s.io/nginx-test configured -
Ingress'in IP adresini görüntülemek için aşağıdaki komutu çalıştırın.
kubectl get ingADDRESS 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 -
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/hostsYapılandırmayı doğrulayın:
-
İstemci sertifikası olmadan hizmete erişin:
curl --cacert ./ca.crt https://foo.bar.comBeklenen çı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.comBeklenen çı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.
-
Aşağıdaki şablonu dağıtın. Bu örnekte
~^www\.\d+\.example\.comdü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: ImplementationSpecificKubernetes 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 -
NGINX Ingress denetleyicisinin yapılandırmasını kontrol edin.
-
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-controllerBeklenen çıktı:
nginx-ingress-controller-77cd987c4c-c**** 1/1 Running 0 1h nginx-ingress-controller-77cd987c4c-x**** 1/1 Running 0 1h -
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
-
-
Ingress'in IP adresini almak için aşağıdaki komutu çalıştırın:
kubectl get ingBeklenen çıktı:
NAME HOSTS ADDRESS PORTS AGE ingress-regex foo.bar.com 101.37.XX.XX 80 11s -
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.comkullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:curl -H "Host: foo.bar.com" <IP_ADDRESS>/fooBeklenen çıktı:
/foo -
Host: www.123.example.comkullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:curl -H "Host: www.123.example.com" <IP_ADDRESS>/fooBeklenen çıktı:
/foo -
Host: www.321.example.comkullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:curl -H "Host: www.321.example.com" <IP_ADDRESS>/fooBeklenen çı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.
-
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: ImplementationSpecificKubernetes 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 -
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"Notnginx-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.comNGINX 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 -
Ingress'in IP adresini almak için aşağıdaki komutu çalıştırın:
kubectl get ingBeklenen çıktı:
NAME HOSTS ADDRESS PORTS AGE ingress-regex *.ingress-regex.com 101.37.XX.XX 80 11s -
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.comkullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:curl -H "Host: abc.ingress-regex.com" <IP_ADDRESS>/fooBeklenen çıktı:
/foo -
Host: 123.ingress-regex.comkullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:curl -H "Host: 123.ingress-regex.com" <IP_ADDRESS>/fooBeklenen çıktı:
/foo -
Host: a1b1.ingress-regex.comkullanarak hizmete erişmek için aşağıdaki komutu çalıştırın:curl -H "Host: a1b1.ingress-regex.com" <IP_ADDRESS>/fooBeklenen çı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ılanheaderdeğerialwaysise istekler canary hizmetine yönlendirilir.headerdeğerineverise istekler canary hizmetine yönlendirilmez. Diğerheaderdeğ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-valuevenginx.ingress.kubernetes.io/canary-by-header: Bir istektekiheaderveheader-valuebelirtilen değerlerle eşleştiğinde trafik canary hizmetine yönlendirilir. Diğerheaderdeğ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. Belirtilencookiedeğerialwaysise istek trafiği canary hizmetine yönlendirilir. Belirtilencookiedeğerineverise 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:alwaysise istek canary hizmetine yönlendirilir. İstek üstbilgisiack:neverise 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:alibabaise 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=alwaysise 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"
Tanımlama bilgisi tabanlı canary sürümü yalnızca
alwaysveneverdeğ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.
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.
-
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 -
Pod durumunu kontrol etmek için aşağıdaki komutu çalıştırın.
kubectl get pods -n cert-managerBeklenen çı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 -
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 -
ClusterIssuer durumunu kontrol etmek için aşağıdaki komutu çalıştırın.
kubectl get clusterissuerBeklenen çıktı:
NAME READY AGE letsencrypt-prod-http01 True 17s -
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: ImplementationSpecificKubernetes 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.
-
Sertifika durumunu kontrol etmek için aşağıdaki komutu çalıştırın:
kubectl get certBeklenen çıktı:
NAME READY SECRET AGE ingress-tls True ingress-tls 52mNotREADY durumu True değilse sertifika işleme ayrıntılarını görüntülemek için
kubectl describe cert ingress-tlskomutunu çalıştırabilirsiniz. -
Secret'ı kontrol etmek için aşağıdaki komutu çalıştırın:
kubectl get secret ingress-tlsBeklenen çıktı:
NAME TYPE DATA AGE ingress-tls kubernetes.io/tls 2 2m 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.