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:
Bir ACK yönetilen kümesi oluşturulmuştur.
NGINX Ingress denetleyicisi yüklenmiş ve çalışır durumdadır.
kubectl kümesine bağlıdır.
Kümede bir Deployment ve bir Service dağıtılmıştır.
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:
-
Ingress IP adresini alın.
kubectl get ingressBeklenen çıktı:
NAME CLASS HOSTS ADDRESS PORTS AGE foo.bar.com nginx foo.bar.com 172.16.XX.XX 80 46m -
ADDRESSdeğerindeki Ingress IP adresini kullanarak bir istek gönderin.curl -k -H "Host: foo.bar.com" http://<ADDRESS>/svc/fooBeklenen çıktı:
web1: /foo/svcöneki kaldırılır ve arka uç/fooalı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.
-
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" -
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.
-
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' -
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.crtBeklenen çıktı:
Signature ok subject=/CN=foo.bar.com Getting CA Private Key
Adım 3: Bir istemci sertifikası oluşturun.
-
İstemci CSR'sini oluşturun.
openssl req -new -newkey rsa:4096 \ -keyout client.key -out client.csr \ -nodes -subj '/CN=Fern' -
İ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.crtBeklenen çı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.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 — istek başarılı olur:
curl --cacert ./ca.crt --cert ./client.crt --key ./client.key https://foo.bar.comBeklenen çı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.
-
NGINX Ingress denetleyicisi pod adını alı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 -
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_nameyö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ğerlerialwaysveyaneverolmalı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.