NGINX Ingress Controller, Alibaba Cloud Container Service for Kubernetes (ACK) yönetilen kümeleri için giriş ağ geçidi olarak hizmet verir ve esnek yönlendirme kurallarıyla harici trafiği dahili hizmetlere iletir. Açıklamalar (annotations) aracılığıyla HTTPS şifreleme, canary sürümleri ve özel yapılandırmalar gibi özellikleri destekleyerek güvenli, yüksek kullanılabilirliğe sahip ve ölçeklenebilir Katman 7 (L7) ağ erişimi sağlar.
11 Eylül 2025 tarihinden itibaren, Classic Load Balancer (CLB) için teknik özellik bazlı faturalandırmanın sona ermesi nedeniyle, Container Service for Kubernetes konsolunda yük dengeleyici türünde hizmetler oluştururken veya yeni NGINX Ingress Controller'ları yüklerken varsayılan olarak Network Load Balancer (NLB) örnekleri kullanılır. CLB tabanlı hizmetlerin oluşturulması bir izin listesine tabi olacaktır ve bu hizmetler varsayılan olarak kullandıkça öde faturalandırma modelini kullanır. Daha fazla bilgi için bkz. [[Ürün değişikliği] Yeni hizmetler ve NGINX Ingress Controller için varsayılan yük dengeleyici türü ve faturalandırma yöntemindeki değişiklikler hakkında duyuru](t2980097.xdita#).
Kaynak açık kaynak Ingress-NGINX projesinin bakımı Mart 2026'dan sonra sona erecektir. Bu nedenle, Container Service for Kubernetes NGINX Ingress Controller bileşeni için bakımı durduracaktır. İlgili risklerin farkında olun. Daha fazla bilgi için bkz. [[Ürün duyurusu] NGINX Ingress Controller bileşeni için bakımın sona ermesi hakkında duyuru](t3212739.xdita#).
Kullanım notları
NGINX Ingress Controller tarafından kullanılan varsayılan hizmeti silmeyin. Eklenti yüklendikten sonra,
kube-systemad alanındanginx-ingress-lbadında varsayılan bir hizmet oluşturulur. Bu hizmetin silinmesi eklentiyi kararsız hale getirir ve çökmesine neden olabilir.Eklenti için özel parametreleri yapılandırmak üzere Eklentiler veya OpenAPI kullanın. Yapılandırmayı başka yöntemlerle değiştirmek eklentinin hatalı çalışmasına ve gelecekteki yükseltmelerin engellenmesine neden olabilir.
Özel yapılandırmalar için NGINX Ingress ConfigMap kullanın. Teknik destek, snippet'ler veya Lua kodu gibi ek yapılandırmalardan kaynaklanan sorunları kapsamaz.
Kaynak topluluk sürümündeki hatalar veya güvenlik açıkları nedeniyle iş kesintilerini önlemek için NGINX Ingress Controller eklentisini zamanında yükseltin.
NGINX Ingress Controller eklentisini yükleme
Örnek bir uygulama oluşturun
Örnek uygulama, coffee ve tea adlı iki durum bilgisi içermeyen iş yükü (Dağıtımlar) ve bunlara karşılık gelen coffee-svc ile tea-svc adlı Hizmetleri dağıtır.
Konsol
|
1. Kaynakları oluşturun
|
|
2. Sonucu görüntüleyin YAML Resource Creation Result iletişim kutusunda, bir kaynağın oluşturulduğunu onaylamak için Actions sütunundaki View seçeneğine tıklayın. |
kubectl
Kümeniz için KubeConfig dosyasını edinin ve kubectl kullanarak kümeye bağlanın.
-
Aşağıdaki içeriğe sahip test-deployment-service.yaml adlı bir dosya oluşturun.
-
Dağıtımı ve Hizmeti oluşturmak için yapılandırmayı uygulayın.
kubectl apply -f test-deployment-service.yaml -
coffeeveteaDağıtımlarının durumunu doğrulayın.kubectl get deployment coffee teaBeklenen çıktı:
NAME READY UP-TO-DATE AVAILABLE AGE coffee 2/2 2 2 14m tea 2/2 2 2 14m -
coffee-svcvetea-svcHizmetlerinin durumunu doğrulayın.kubectl get service coffee-svc tea-svcBeklenen çıktı:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE coffee-svc ClusterIP 192.168.xxx.xxx <none> 80/TCP 15m tea-svc ClusterIP 192.168.xxx.xxx <none> 80/TCP 15m
NGINX Ingress oluşturun
Bu örnekte alan adı (ana bilgisayar) olarak test-nginx-ingress.com kullanılmaktadır. Bunu kendi kayıtlı alan adınızla değiştirin. Yol eşlemesi (yollar), Örnek bir uygulama oluşturun örneğinden alınmıştır. Bu yolları uygulamanızın yapılandırmasına uyacak şekilde değiştirin.
Konsol
|
1. Ingress oluşturun
|
|
2. Uç noktayı edinin Yaklaşık bir dakika sonra sayfayı yenileyin. Endpoint sütununda bir Elastik IP (EIP) göründüğünde Nginx Ingress başarıyla oluşturulmuş demektir. Bu EIP, ilişkili Cloud Load Balancer (CLB) örneğinin genel hizmet adresidir. Birkaç dakika sonra uç nokta bilgileri görünmezse Ingress adına tıklayın ve sorun giderme için Events sekmesini kontrol edin. |
kubectl
-
Aşağıdaki içeriğe sahip test-ingress.yaml adlı bir dosya oluşturun.
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: test-nginx-ingress namespace: default spec: ingressClassName: nginx rules: - host: test-nginx-ingress.com # Replace with your registered domain name http: paths: - path: /coffee backend: service: name: coffee-svc port: number: 80 pathType: ImplementationSpecific - path: /tea backend: service: name: tea-svc port: number: 80 pathType: ImplementationSpecific - host: www.test-nginx-ingress.com # Replace with your registered domain name http: paths: - path: /coffee backend: service: name: coffee-svc port: number: 80 pathType: ImplementationSpecific - path: /tea backend: service: name: tea-svc port: number: 80 pathType: ImplementationSpecificParametre açıklamaları:
name: Ingress'in adı. Bu örnekte adtest-nginx-ingressolarak belirtilmiştir.host: Hizmete erişmek için kullanılan alan adı. Bu örnekte alan adıtest-nginx-ingress.comolarak belirtilmiştir. Bunu kendi kayıtlı alan adınızla değiştirin.path: Kural için URL yolu. Bir isteğin arka uca yönlendirilmesi için belirtilen ana bilgisayara ve yola eşleşmesi gerekir. Bu örnekte yollar/coffeeve/teaşeklindedir.-
backend: Bir hizmet adı ve bir hizmet bağlantı noktasından oluşur.Hizmet adı: Ingress'in trafiği ilettiği arka uç hizmetinin adı. Örneğin,
coffee-svcvetea-svc.Hizmet bağlantı noktası: Arka uç Hizmetindeki hedef bağlantı noktası. Bu örnekte bağlantı noktası
80şeklindedir.
-
Ingress'i oluşturun.
kubectl apply -f test-ingress.yaml -
Ingress'i görüntüleyin ve
8.xxx.xxx.117gibi bir Elastik IP (EIP) adresini edinin.kubectl get ingressBeklenen çıktı:
NAME CLASS HOSTS ADDRESS PORTS AGE test-nginx-ingress nginx test-nginx-ingress.com,www.test-nginx-ingress.com 8.xxx.xxx.117 80 2m39s -
Nginx Ingress'in doğru çalıştığını doğrulamak için EIP'yi kullanın.
curl http://8.xxx.xxx.117/coffee -H "Host: test-nginx-ingress.com"Beklenen çıktı:
... <title>Hello World</title> ... <p><span>Server address:</span> <span>10.xxx.xxx.19:80</span></p> <p><span>Server name:</span> <span>coffee-96d4bc87-l29dh</span></p> <p class="smaller"><span>Date:</span> <span>08/Aug/2025:02:21:02 +0000</span></p> <p class="smaller"><span>URI:</span> <span>/coffee</span></p> ... <div id="footer"> <div id="center" align="center"> Request ID: 42e2d73c85b16b55b6ab52deb7d995d4<br/> © NGINX, Inc. 2018 </div> </div> ...
DNS çözümlemesini yapılandırma
Bir etki alanı adı kaydedin. Etki alanı adı yalnızca üçüncü taraf bir sağlayıcı üzerinden kaydedildiyse eklenmelidir. Alibaba Cloud, platformu üzerinden satın alınan etki alanı adlarını Alibaba Cloud DNS içindeki genel yetkili bölgelere otomatik olarak ekler; bu sayede doğrudan DNS kayıtları ekleyebilirsiniz.
|
1. Bir etki alanı adı ekleyin
|
|
2. Bir DNS kaydı ekleyin
Daha fazla bilgi için bkz. Bir web sitesi çözümleme kaydı ekleme. |
|
3. Etki alanı adını ve yolu doğrulayın Tarayıcınızda İstek başarılı olursa sayfa, NGINX arka uç pod'undan gelen bilgileri döndürür. Bu bilgiler arasında server address, server name, Date ve URI alanları yer alır. Sonucu onaylamak için ayrıca DNS çözümlemesini test etme yöntemleri konusuna bakabilirsiniz. Bir DNS kaydı etkili olmazsa DNS çözümleme hatalarını hızlıca giderme konusuna bakın. |
HTTPS güvenliğini yapılandırma
Bir ticari sertifika ve sertifikayı talep edin. Sertifikasının Issued durumunda olduğundan emin olun. Ardından sertifikayı indirmek ve bir TLS yapılandırması eklemek için aşağıdaki adımları izleyin. Bu işlem, etki alanınıza şifreli HTTPS erişimi sağlar.
Konsol
|
1. Sertifikayı indirin
For more details, see Download an SSL certificate. |
|
2. Secret oluşturun
|
|
3. TLS yapılandırması ekleyin
|
|
4. HTTPS erişimini doğrulayın Web tarayıcınızda |
Kubectl
Log on to the Certificate Management Service console. In the left-side navigation pane, choose .
On the Commercial Certificates tab, select the certificate you want to download, and click Download in the bottom-left corner of the certificate list.
In the dialog box that appears, select Nginx as the server type, download the certificate package, and decompress it.
-
Use the downloaded certificate file (.pem) and private key file (.key) to create a Secret.
kubectl create secret tls nginx-ingress-tls --cert test-nginx-ingress.com.pem --key test-nginx-ingress.com.key -n default -
Add a TLS configuration to the
test-nginx-ingressIngress. Replacetest-nginx-ingress.comin the command with your actual registered domain name.kubectl patch ingress test-nginx-ingress -p '{"spec":{"tls":[{"hosts":["test-nginx-ingress.com"],"secretName":"nginx-ingress-tls"}]}}' -
Verify encrypted HTTPS access to the service path by running the following command with your actual Elastic IP Address.
curl -v -k https://8.xxx.xxx.117/coffee -H "Host: test-nginx-ingress.com"-
Parameters:
-v: Displays verbose output, including the TLS handshake.-k(or --insecure): Skips certificate verification. Use this option if you are using a self-signed certificate.
-
Expected output:
... * Trying 8.xxx.xxx.117:443... * Connected to 8.xxx.xxx.117 (8.xxx.xxx.117) port 443 * ALPN: curl offers h2,http/1.1 * (304) (OUT), TLS handshake, Client hello (1): * (304) (IN), TLS handshake, Server hello (2): * (304) (IN), TLS handshake, Unknown (8): * (304) (IN), TLS handshake, Certificate (11): * (304) (IN), TLS handshake, CERT verify (15): * (304) (IN), TLS handshake, Finished (20): * (304) (OUT), TLS handshake, Finished (20): ... <title>Hello World</title> ... <p><span>Server address:</span> <span>10.xxx.xxx.159:80</span></p> <p><span>Server name:</span> <span>coffee-96d4bc87-6cstv</span></p> <p class="smaller"><span>Date:</span> <span>14/Aug/2025:09:27:42 +0000</span></p> <p class="smaller"><span>URI:</span> <span>/coffee</span></p> ... <div id="footer"> <div id="center" align="center"> Request ID: fee5fe107106748a35d99a2dbbbc6652<br/> © NGINX, Inc. 2018 </div> </div> ...
-
Ek yapılandırmalar
Canary sürümü
Hizmetleri yükseltmek için kademeli güncellemeler, aşamalı sürümler, mavi-yeşil dağıtımlar ve canary sürümleri gibi çeşitli dağıtım stratejilerini kullanabilirsiniz. Ayrıntılı talimatlar için NGINX Ingress kullanarak aşamalı sürümler ve mavi-yeşil dağıtımlar uygulama konusuna bakın.
Arka uç hizmet protokolü
Bir arka uç hizmetinin protokolünü belirtmek için nginx.ingress.kubernetes.io/backend-protocol ek açıklamasını ekleyin. Desteklenen protokoller HTTP, HTTPS, gRPC ve gRPCS'dir. Yapılandırma örneği için NGINX Ingress için gRPC hizmeti yapılandırma konusuna bakın.
URL yeniden yazma
NGINX Ingress denetleyicisini kullandığınızda istekler tam yola göre iletilir. Örneğin, /service1/api adresine yapılan bir istek, arka uç pod'unun /service1/api yoluna iletilir. Arka uç hizmetinizin yolu /api ise yol uyumsuzluğu oluşur ve 404 hatası alırsınız. Bu sorunu çözmek için istek yolunu doğru dizine yeniden yazmak amacıyla nginx.ingress.kubernetes.io/rewrite-target ek açıklamasını ekleyebilirsiniz.
Ayrıntılı talimatlar için URL yönlendirmesini yapılandırma konusuna bakın.
Ek açıklamalar
NGINX Ingress, ek açıklamalarla etkinleştirebileceğiniz geniş bir özellik yelpazesini destekler. Daha fazla bilgi için NGINX Ingress yapılandırma sözlüğü ve Gelişmiş NGINX Ingress yapılandırmaları konularına bakın.
Gözlemlenebilirlik
Kapsamlı NGINX Ingress erişim günlüğü analiz raporlarına ve gerçek zamanlı izleme panolarına erişmek için küme oluşturma sırasında Simple Log Service'i (SLS) etkinleştirin. Ayrıntılar için NGINX Ingress erişim günlüklerini analiz etme ve izleme konusuna bakın.
Yüksek yük senaryoları
Yüksek yük senaryolarında NGINX Ingress Denetleyicisinin performansını ve kararlılığını artırmak için Yüksek yük senaryoları için NGINX Ingress Denetleyicisi yapılandırma ve NGINX Ingress Denetleyicisi kullanımıyla ilgili öneriler konularına bakın.
SSS
Küme içinden harici IP'ye ulaşılamıyor
Büyük üstbilgiler veya çerezler
CORS yapılandırması
İstemci IP geçişi
Referanslar
Sürümler ve sürüm notları için NGINX Ingress Controller konusuna bakın.
Yaygın sorunlar ve sorun giderme adımları için NGINX Ingress SSS ve NGINX Ingress sorunlarını giderme konularına bakın.