Varsayılan olarak, bir ACK kümesindeki hizmetler harici ağdan izole edilir. Bir ALB Ingress, bu hizmetleri harici trafiğin giriş noktası olarak Application Load Balancer (ALB) kullanarak dışa açar. ALB, alan adı tabanlı yönlendirme, güvenlik ve yüksek kullanılabilirlik sunar.
Çalışma mekanizması
|
|
Hizmet türü sınırlamaları
Flannel ağ eklentisi kullanılırken, bir ALB Ingress için arka uç hizmetleri yalnızca NodePort ve LoadBalancer türleriyle sınırlıdır.
ALB Ingress Controller'ı yükleme
Küme oluşturma sırasında
ACK konsolu oturumunu açın ve Create Kubernetes Cluster seçeneğine tıklayın.
Component Configuration adımında, Ingress bölümüne gidin ve ALB Ingress seçeneğini belirleyin.
-
Bu örnekte New seçeneği kullanılmaktadır. Küme oluşturmak için ekrandaki talimatları izleyin.
ALB Instance
Açıklama
New
Otomatik olarak bir ALB örneği, bir AlbConfig ve bir IngressClass oluşturur.
-
ALB örneği: Kümenin VPC'sinde standart, kullandıkça öde, genel veya özel bir ALB örneği otomatik olarak oluşturur ve bir
HTTP:80dinleyicisi yapılandırır. -
AlbConfig ve IngressClass: Kümede ilgili AlbConfig ve IngressClass kaynaklarını otomatik olarak oluşturur ve bunları ALB örneğiyle ilişkilendirir.
Select Existing VPC
Bu seçenek yalnızca küme mevcut bir Virtual Private Cloud (VPC) kullanacak şekilde yapılandırıldığında kullanılabilir.
Mevcut bir ALB örneği kullanır ve otomatik olarak bir AlbConfig ile bir IngressClass oluşturur. Belirtilen ALB örneği Standard veya WAF-enhanced edition olmalı, kümeyle aynı VPC'de bulunmalı ve başka bir kümeyle ilişkilendirilmemiş olmalıdır.
None
Yalnızca ALB Ingress Controller bileşenini yükler. Daha sonra bir AlbConfig ve bir IngressClass manuel olarak oluşturmanız gerekir. Bu durum, ALB örneği yapılandırmasını özelleştirmeniz gereken senaryolar için uygundur.
-
Mevcut bir küme için
ACK konsolu oturumunu açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Clusters sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde Components and Add-ons seçeneğine tıklayın.
Arama kutusunu kullanın veya bileşeni bulmak için Networking sekmesine tıklayın. ALB Ingress Controller bileşen kartında, sağ alt köşede bulunan Install seçeneğine tıklayın.
-
Bu örnekte New seçeneği kullanılmaktadır. OK seçeneğine tıklayın.
ALB Instance
Açıklama
New
Otomatik olarak bir ALB örneği, bir AlbConfig ve bir IngressClass oluşturur.
-
ALB örneği: Kümenin VPC'sinde standart, kullandıkça öde, genel veya özel bir ALB örneği otomatik olarak oluşturur ve bir
HTTP:80dinleyicisi yapılandırır. -
AlbConfig ve IngressClass: Kümede ilgili AlbConfig ve IngressClass kaynaklarını otomatik olarak oluşturur ve bunları ALB örneğiyle ilişkilendirir.
Existing
Mevcut bir ALB örneği kullanır ve otomatik olarak bir AlbConfig ile bir IngressClass oluşturur. Belirtilen ALB örneği Standard veya WAF-enhanced edition olmalı, kümeyle aynı VPC'de bulunmalı ve başka bir kümeyle ilişkilendirilmemiş olmalıdır.
None
Yalnızca ALB Ingress Controller bileşenini yükler. Daha sonra bir AlbConfig ve bir IngressClass manuel olarak oluşturmanız gerekir. Bu durum, ALB örneği yapılandırmasını özelleştirmeniz gereken senaryolar için uygundur.
-
Örnek uygulama oluşturma
Örnek uygulama, coffee adlı bir Deployment ve buna karşılık gelen coffee-svc adlı bir Service dağıtır.
Konsol
Clusters sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde seçeneğine tıklayın.
-
Create from YAML seçeneğine tıklayın. Sample Template açılır listesinden Custom seçeneğini belirleyin. Ardından aşağıdaki içeriği şablon düzenleyicisine kopyalayın ve Create seçeneğine tıklayın.
Onay iletişim kutusunda View seçeneğine tıklayın ve Pod durumunun
Runningolduğunu doğrulayın.
kubectl
-
Aşağıdaki içeriği içeren
coffee-deployment-service.yamladlı bir dosya oluşturun. -
Örnek uygulama için Deployment ve Service öğelerini oluşturun.
kubectl apply -f coffee-deployment-service.yaml -
Pod durumunun
Runningolduğunu doğrulayın.kubectl get pod -l app=coffeeBeklenen çıktı:
NAME READY STATUS RESTARTS AGE coffee-84bd6*****-***** 1/1 Running 0 4m22s coffee-84bd6*****-***** 1/1 Running 0 4m22s
ALB Ingress oluşturma
ingress-demo.com/coffee isteklerini küme içindeki coffee-svc Service öğesine yönlendirmek için ALB Ingress'in alan adı ve yol eşlemelerini yapılandırın.
Bir ACK dedicated cluster içinde ALB Ingress kullanmak için ALB Ingress Controller'a erişim izinleri vermeniz gerekir.
Konsol
Sol gezinme bölmesinde seçeneğini belirleyin.
defaultad alanını seçin ve Create Ingress seçeneğine tıklayın.-
Aşağıdaki Ingress parametrelerini belirtin ve OK seçeneğine tıklayın.
Name:
coffee-ingressDomain Name:
ingress-demo.com-
Mappings: Path:
/coffee, Match Rule:Prefix, Service:coffee-svc, Port:80.
Eşleştirme kuralı (pathType)
Açıklama
Prefix
İstek yolunu öneki temel alarak eşleştirir. Örneğin,/coffee/1veya/coffee/buy/1istekleri eşleştirilir ancak/cofveya/coffeebuy/1istekleri eşleştirilmez.
Exact
İstek yolunu tam olarak eşleştirir. Yalnızca/coffeeistekleri eşleştirilir.
ImplementationSpecific
Eşleştirme davranışı Ingress controller uygulamasına bağlıdır. ALB Ingress Controller için bu tür, Exact eşleşmesine eşdeğerdir.
-
Endpoint adresini alın.
Bir ALB Ingress'in etkili olması yaklaşık 10 saniye sürer. Uç nokta bilgilerini almak için yenileme düğmesine tıklayabilirsiniz. Uç nokta uzun süre güncellenmezse Ingress adına tıklayıp Events sekmesine giderek sorun giderme işlemini gerçekleştirin.
Ingress listesindeki Endpoint sütununda,
alb-<instance_id>.cn-wulanchabu.alb.aliyuncsslb.combenzeri bir biçimde olan ALB uç nokta adresini bulun. -
Alan adına ve uç noktaya erişimi test edin.
200HTTP durum kodu, ALB Ingress'in doğru çalıştığını gösterir.curl -H "Host:ingress-demo.com" http://<endpoint_address>/coffee -s -o /dev/null -w "%{http_code}\n"
kubectl
-
Aşağıdaki içeriğe sahip
coffee-ingress.yamladlı bir dosya oluşturun. Ardından ALB Ingress'i oluşturmak içinkubectl apply -f coffee-ingress.yamlkomutunu çalıştırın.apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: coffee-ingress namespace: default spec: ingressClassName: alb rules: - host: ingress-demo.com http: paths: - path: /coffee backend: service: name: coffee-svc port: number: 80 pathType: Prefix
Eşleştirme kuralı (pathType)
Açıklama
Prefix
İstek yolunu öneki temel alarak eşleştirir. Örneğin,/coffee/1veya/coffee/buy/1istekleri eşleştirilir ancak/cofveya/coffeebuy/1istekleri eşleştirilmez.
Exact
İstek yolunu tam olarak eşleştirir. Yalnızca/coffeeistekleri eşleştirilir.
ImplementationSpecific
Eşleştirme davranışı Ingress controller uygulamasına bağlıdır. ALB Ingress Controller için bu tür, Exact eşleşmesine eşdeğerdir. -
Ingress'i görüntüleyin ve uç nokta adresini
ADDRESSalanından alın.kubectl get ingress coffee-ingress -o jsonpath='{.status.loadBalancer.ingress[0].hostname}'Beklenen çıktı:
alb-******************.cn-wulanchabu.alb.aliyuncsslb.com -
Alan adına ve uç noktaya erişimi test edin.
200HTTP durum kodu, ALB Ingress'in doğru çalıştığını gösterir.curl -H "Host:ingress-demo.com" http://<endpoint_address>/coffee -s -o /dev/null -w "%{http_code}\n"
Ücretlendirme
ALB Ingress Controller: Bu, yönetilen bir ACK bileşenidir ve ücretsizdir.
ALB örneği: Her
AlbConfigkaynak nesnesi, karşılık gelen bir ALB örneği oluşturur. ALB örnekleri kullandıkça öde faturalandırmasını kullanır.
Üretim dağıtımı
DNS yapılandırma: Hizmet alan adınızı ALB örneğinin genel uç noktasına eşlemek için bir CNAME kaydı oluşturun. Bu işlem, alan adını örnek uç noktasından ayırarak yüksek kullanılabilirliğe ve esnekliğe sahip bir hizmet giriş noktası sağlar.
HTTPS etkinleştirme: Sertifikalarınızı merkezi olarak yönetmek için Certificate Management Service kullanın ve hizmet trafiğini HTTPS ile güvence altına almak için bunları bir Ingress kaynağının
tlsalanında bildirim temelli olarak referans alın.
Kotalar ve sınırlar
AlbConfig, Ingress, Service ve ad alanı kaynak adları
aliyunile başlayamaz.ALB Ingress kota sınırları hakkında bilgi için bkz. ALB kota hesaplaması.
ALB Ingress tarafından desteklenen bölgeler ve kullanılabilirlik alanları hakkında bilgi için bkz. ALB tarafından desteklenen bölgeler ve alanlar.
SSS
Ingress neden HTTP hata kodları döndürür?
Nedenler
-
503 (Service Temporarily Unavailable) hatası
Eşleşen yönlendirme kuralı yok: İstek yolu, Ingress'te yapılandırılan hiçbir yönlendirme kuralıyla eşleşmiyor.
Sağlıklı arka uç pod'u yok: İlişkili Service'in hazır pod'u bulunmuyor, bu da boş bir endpoints nesnesiyle sonuçlanır.
-
502 (Bad Gateway) hatası
Bir HTTP veya HTTPS dinleyicisi bir istemci bağlantı isteği aldıktan sonra, ALB isteği bir Pod'a iletemediği veya Pod'dan yanıt alamadığı için istemciye HTTP 502 Bad Gateway durum kodu gönderir.
-
404 (Not Found) hatası
Bu durum genellikle bir istek bir Ingress yönlendirme kuralıyla eşleştiğinde, ancak URL'sinin arka uç pod'undaki uygulamanın hizmet yoluyla eşleşmediğinde meydana gelir.
-
400 (Bad Request) hatası
Bu durum, bir HTTPS dinleyicisine HTTP isteği göndermek gibi çeşitli nedenlerle meydana gelebilir.
HTTP hata kodları hakkında daha fazla bilgi için bkz. ALB durum kodları .
Çözüm
-
Ingress durumunu kontrol edin:
kubectl describe ingress <ingress-name> -n <namespace>komutunu çalıştırın ve hata mesajları için Events bölümünü inceleyin.listener is not exist in albgibi bir olay görünüyorsa, AlbConfig'inize gerekli dinleyici yapılandırmasını ekleyin.... Events: Type Reason Age From Message ---- ------ ---- ---- ------- Warning FailedBuildModel **** ingress listener is not exist in alb, port: 443, protocol: HTTPS Warning FailedBuildModel **** ingress listener not found for (443/HTTPS), with ingresses 1 ... Arka uç uç noktalarını kontrol edin:
kubectl get endpoints <service-name> -n <namespace>komutunu çalıştırarakENDPOINTSalanında en az bir sağlıklı pod IP adresi ve bağlantı noktasının listelendiğini doğrulayın. Alan boşsa, Service'inselectordeğerinin pod'larınlabelsdeğeriyle eşleştiğini ve pod'larınRunningdurumunda olduğunu doğrulayın.Pod durumunu ve günlüklerini kontrol edin: Pod durumunu görüntülemek için
kubectl get pod -l <app=your-app> -n <namespace>komutunu çalıştırın. Ardından, başlatma hataları veya istek işleme hataları olup olmadığını kontrol etmek üzere pod adını kullanarakkubectl logs <pod-name> -n <namespace>komutunu çalıştırın ve uygulama günlüklerini inceleyin.Ağ bağlantısını test edin: Bir pod içinden veya bir düğümden, hizmetin küme içinde ulaşılabilir olduğunu doğrulamak amacıyla arka uç Service'inin ClusterIP'sine veya bir pod IP'sine erişmek için
curlkullanın.
TLS yapılandırmasından sonra neden HTTPS erişilemez?
Nedenler
ALB örneği 443 numaralı bağlantı noktasını dinlemiyor: Ingress için TLS yapılandırdınız, ancak karşılık gelen
HTTPS:443dinleyicisi oluşturulmadı.Yanlış sertifika yapılandırması: Secret türü
kubernetes.io/tlsveyaIngressTLSdeğil veyadataalanındakitls.crtvetls.keyiçeriği yanlış veya eşleşmiyor.Eski sertifika: ALB örneği eski bir sertifika kullanıyor olabilir. Bu durum, Alibaba Cloud Certificate Management Service'te bir sertifikayı güncellediğinizde ancak AlbConfig'inizdeki sertifika kimliğini güncellemediğinizde veya otomatik keşif ve uzlaştırma tetiklenemediğinde gerçekleşir.
Çözüm
Dinleyici bağlantı noktasını kontrol edin:
spec.listeners.port: 443vespec.listeners.protocol: HTTPSyapılandırmalarının mevcut olduğunu doğrulamak içinkubectl describe albconfig <alb-name> -n <namespace>komutunu çalıştırın.Ingress yapılandırmasını kontrol edin: Ingress yapılandırmasının, Ingress'i HTTP ve HTTPS dinleyicileriyle ilişkilendiren
alb.ingress.kubernetes.io/listen-ports: [{"HTTP": 80}, {"HTTPS": 443}]ek açıklamasını içerdiğini doğrulayın.Secret yapılandırmasını kontrol edin: Ingress yapılandırmasında, doğru Secret'ın referans alındığını onaylamak için
spec.tlsiçindekisecretNamealanını kontrol edin. Secret türünü ve veri bütünlüğünü doğrulamak içinkubectl get secret <secret-name> -n <namespace> -o yamlkomutunu çalıştırın.
Ingress alan adı çözümlemesi nasıl yapılandırılır?
-
Örneğin, kayıt türü
CNAME, ana bilgisayar kaydı @ (kök alan adını temsil eder, örneğiningress-demo.com) ve kayıt değeri olarak Ingress uç nokta adresi olan bir DNS kaydı ekleyin . -
Tarayıcıda http://ingress-demo.com/coffee adresine giderek alan adı çözümlemenin çalıştığını doğrulayın.
Erişim başarılı olduktan sonra, arka uç pod'unun Server address, Server name, Date ve URI (değeri
/coffeeolan) gibi bilgilerini görüntüleyen bir NGINX test sayfası döndürülür. Bu durum, Ingress'in isteği arka uç pod'una doğru şekilde yönlendirdiğini gösterir.Doğrulama için örneği kayıtlı alan adınızla değiştirin. Alan adı çözümlemesi başarısız olursa bkz. Alan adı çözümleme hataları için hızlı sorun giderme .
Ingress için HTTPS nasıl yapılandırılır?
Resmi sertifika satın alma ve sertifika başvurusu yapma işlemlerini gerçekleştirin. Kullanmak istediğiniz sertifikanın Issued durumunda olduğundan emin olun.
-
Bu örnekte, sunucu türü Other olarak ayarlanmış
ingress-demo.comalan adı için PEM biçimli sertifika dosyasının nasıl indirileceği gösterilmektedir. -
Sertifika dosyasını depolamak için bir Secret oluşturun.
Clusters sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde seçeneğine tıklayın.
-
Secrets sayfasında
defaultad alanını seçin ve ardından sol tarafta bulunan Create seçeneğine tıklayın. Aşağıdaki yapılandırmaları ekleyin ve OK seçeneğine tıklayın.Name:
ingress-tlsType: Ingress TLS Certificate
Certificates: İndirilen ve zipten çıkarılan sertifika dosyasının (.pem) tam içeriği.
Key: İndirilen ve zipten çıkarılan özel anahtar dosyasının (.key) tam içeriği.
-
ALB örneği için bir
HTTPS:443dinleyicisi eklemek üzere AlbConfig'i güncelleyin.Sol gezinme bölmesinde seçeneğini belirleyin. Resource Objects sekmesinde AlbConfig için arama yapın ve ardından arama sonucuna tıklayın.
AlbConfig kaynak nesneleri listesinde hedef
albkaynağını bulun ve Actions sütununda Edit YAML seçeneğine tıklayın.-
spec.listeners.port: 443vespec.listeners.protocol: HTTPSalanlarını ekleyin ve ardından OK seçeneğine tıklayın.spec: config: addressAllocatedMode: Fixed addressType: Internet zoneMappings: - vSwitchId: vsw-xxx - vSwitchId: vsw-xxx listeners: - port: 80 protocol: HTTP - port: 443 protocol: HTTPS
-
TLS yapılandırması eklemek ve bunu
HTTPS:443dinleyicisiyle ilişkilendirmek için Ingress'i güncelleyin.Sol gezinme bölmesinde seçeneğini belirleyin. Hedef Ingress'in Actions sütununda Update seçeneğine tıklayın.
-
Aşağıdaki yapılandırmaları ekleyin ve OK seçeneğine tıklayın.
TLS Settings: Etkin
Domain Name:
ingress-demo.comSecrets:
ingress-tlsAnnotations:
alb.ingress.kubernetes.io/listen-ports: [{"HTTP": 80}, {"HTTPS": 443}]
-
Tarayıcıda
https://ingress-demo.com/coffeeadresine giderek HTTPS erişimini doğrulayın.Sayfada NGINX logosu ve sunucu yanıt bilgileri görüntülenir. Server address, Server name ve URI (değeri
/coffeeolan) beklenen şekilde döndürülür. Bu durum, HTTPS'nin doğru yapılandırıldığını ve Ingress'in istekleri coffee arka uç pod'una yönlendirdiğini doğrular.Doğrulama için örneği kayıtlı alan adınızla değiştirin.
HTTPS sertifikalarını yapılandırma hakkında daha fazla bilgi için bkz. Şifreli iletişim için HTTPS sertifikalarını yapılandırma.
AlbConfig ve IngressClass manuel olarak nasıl oluşturulur?
AlbConfig oluşturma
-
VPC konsolu oturumunu açın ve kümenin dağıtıldığı VPC içinde farklı kullanılabilirlik alanlarında bulunan en az iki vSwitch'in ID'lerini not edin.
Yapılandırılan vSwitch'lerin kullanılabilirlik alanları ALB tarafından desteklenmelidir. Daha fazla bilgi için bkz. ALB bölgeleri ve alanları .
-
Aşağıdaki kodda yer alan
zoneMappings.vSwitchIddeğerini önceki adımda elde ettiğiniz vSwitch ID'leriyle değiştirin. İçeriği albconfig.yaml adlı bir dosyaya kaydedin ve AlbConfig'i oluşturmak içinkubectl apply -f albconfig.yamlkomutunu çalıştırın.Daha ayrıntılı adımlar için bkz. AlbConfig oluşturma .
apiVersion: alibabacloud.com/v1 kind: AlbConfig metadata: name: alb # Do not create another AlbConfig resource with the same name. spec: config: name: alb-test addressType: Internet zoneMappings: - vSwitchId: vsw-****cg2a9g71hx8go**** # Replace with your actual vSwitch ID. - vSwitchId: vsw-****un9tql5t8nh15**** # Replace with your actual vSwitch ID. listeners: - port: 80 protocol: HTTP
IngressClass oluşturma
IngressClass kaynağı, bir AlbConfig'i Ingress kaynaklarıyla ilişkilendirir. Bir Ingress içinde ingressClassName: alb belirttiğinizde, alb IngressClass'inde tanımlanan AlbConfig kullanılır.
Aşağıdaki içeriği IngressClass.yaml adlı bir dosyaya kaydedin ve ardından IngressClass'i oluşturmak için kubectl apply -f IngressClass.yaml komutunu çalıştırın.
spec.parameters.namealanı, AlbConfig'in adına ayarlanmalıdır. Bileşeni yüklerken oluşturulan varsayılan AlbConfig'in adıalbşeklindedir. Daha fazla bilgi için bkz. AlbConfig'i bir Ingress ile ilişkilendirmek için IngressClass kullanma .
apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
name: alb
spec:
controller: ingress.k8s.alibabacloud/alb
parameters:
apiGroup: alibabacloud.com
kind: AlbConfig
name: alb # This must match the name of the AlbConfig resource.
İlgili belgeler
Gelişmiş ALB Ingress Kullanımı