AlbConfig yapılandırmasındaki listeners alanı, Application Load Balancer (ALB) için dinleyicileri yapılandırır. Bu konu, listeners alanının güncelleme davranışını ele alır ve dinleyicilerin nasıl oluşturulacağını, yapılandırılacağını ve silineceğini gösterir.
Ön Koşullar
Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
Kümenizle aynı VPC içinde bulunan, farklı alanlarda yer alan ve ALB'yi destekleyen alanlar içindeki iki vSwitch. Daha fazla bilgi için bkz. vSwitch Oluşturma ve Yönetme.
-
Kümenizde yüklü olan ALB Ingress denetleyicisi. Daha fazla bilgi için bkz. ALB Ingress Denetleyicisini Yönetme.
Özel bir ACK kümesinde dağıtılan hizmetlere erişmek için ALB Ingress kullanıyorsanız, öncelikle kümeye ALB Ingress denetleyicisi tarafından gereken izinleri verin. Daha fazla bilgi için ACK Özel Kümesine ALB Ingress Denetleyicisine Erişim İzni Verme konusuna bakın.
Bir AlbConfig kaynağı. Daha fazla bilgi için bkz. AlbConfig Oluşturma.
Kullanım Notları
ACK kümeleri tarafından oluşturulan ALB örnekleri yönetilen kaynaklardır (ServiceManagedResource). Bu örneklerle çalışırken aşağıdaki kısıtlamalar ve yönergeler geçerlidir.
ALB Konsolu Kısıtlamaları
Dinleyicileri doğrudan ALB konsolunda oluşturmayın, değiştirmeyin veya silmeyin. Örneğin, konsolda dinleyici bağlantı noktalarını değiştirmeyin veya dinleyicileri silmeyin. ACK, dinleyici yapılandırmasını AlbConfig CRD'sinden ALB örneğine sürekli olarak senkronize eder. ALB konsolunda yapılan tüm manuel değişiklikler, sonraki senkronizasyon döngüsü sırasında üzerine yazılır.
AlbConfig adımını atlayıp dinleyici ayarlarını doğrudan ALB konsolunda değiştirmek şu sorunlara neden olur:
Dinleyici ayarlarını değiştirmeye çalıştığınızda ALB konsolu
OperationDenied.ServiceManagedResourcehatası döndürür.Manuel olarak eklenen dinleyiciler (örneğin, 443 numaralı bağlantı noktası) ACK yapılandırmayı senkronize ettikten sonra otomatik olarak silinebilir.
Mevcut bir ALB örneğini ACK ile yeniden kullandığınızda, manuel olarak yapılandırılmış dinleyici ayarları kalıcı olmaz.
Doğru Yapılandırma Yolu
HTTPS sertifikaları, bağlantı noktaları ve istek zaman aşımları dahil olmak üzere tüm dinleyici yapılandırmaları, yalnızca Kubernetes kümenizdeki AlbConfig özel kaynağı üzerinden yönetilmelidir. AlbConfig, ALB dinleyici yapılandırması için tek doğruluk kaynağıdır ve ALB konsolundan değiştirilmemelidir.
Dinleyici Parametreleri
Aşağıdaki tabloda, bir AlbConfig içindeki spec.listeners altında bulunan tüm parametreler listelenmiştir.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
listeners Alanının Güncellenme Şekli
listeners alanı bir dizi olduğu için tamamen değiştirme yöntemiyle güncellenir: yeni yapılandırma, mevcut olanın tamamen yerine geçer. Bu davranışı anlamak, güncellenmiş bir AlbConfig uyguladığınızda neler olacağını öngörmenize yardımcı olur.
Temel Terimler
Nesne yapılandırma dosyası: Uyguladığınız ve AlbConfig'in istenen durumunu içeren YAML dosyası.
Mevcut nesne yapılandırma dosyası: Kümenizde zaten çalışan yapılandırma.
last-applied-configuration: Önceki yapılandırmayı kaydeden bir Kubernetes ek açıklamasıdır. Gerçek zamanlı olarak güncellenmez.
Güncelleme Kuralları
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Örnek
Aşağıdaki örnek, listeners alanı güncellenirken kuralların nasıl uygulandığını gösterir.
Yeni yapılandırma (nesne yapılandırma dosyası):
listeners:
- port: 8001
protocol: HTTP
- port: 8003
protocol: HTTP
- port: 8005 # New — will be added
protocol: HTTP
Mevcut yapılandırma:
listeners:
- port: 8001
protocol: HTTP
- port: 8002 # Missing from new config and in last-applied-configuration — will be deleted
protocol: HTTP
- port: 8003
protocol: HTTP
- port: 8004 # Missing from new config but not in last-applied-configuration — will be deleted
protocol: HTTP
last-applied-configuration:
listeners:
- port: 8001
protocol: HTTP
- port: 8002
protocol: HTTP
- port: 8003
protocol: HTTP
Yeni yapılandırma uygulandıktan sonraki sonuç:
listeners:
- port: 8001 # Meets condition ① — retained
protocol: HTTP
- port: 8003 # Meets condition ① — retained
protocol: HTTP
- port: 8005 # Meets condition ② — added
protocol: HTTP
# port 8002 meets condition ③ — deleted
# port 8004 meets condition ④ — deleted
Dinleyici Oluşturma
Bir dinleyici, ALB örneğinin uygulama katmanı bilgilerine göre trafiği aldığı ve dağıttığı giriş noktasıdır. port ve protocol alanları birlikte bir dinleyiciyi benzersiz şekilde tanımlar.
port, protocol veya diğer herhangi bir dinleyici özelliğini değiştirmek, orijinal dinleyiciyi siler ve yeni bir tane oluşturur.
HTTP dinleyicileri WebSocket'i otomatik olarak destekler. Ek yapılandırma gerekmez.
protocol için protokol seçenekleri: HTTP, HTTPS, QUIC.
Konsol
Container Service konsoluna giriş yapın ve sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Kümenizin adına tıklayın. Sol gezinme bölmesinde Workloads > Custom Resources seçeneğini belirleyin.
Resource Objects sekmesinde, arama kutusuna
AlbConfiggirin ve AlbConfig sonucuna tıklayın.AlbConfig panelinde, AlbConfig kaynağını bulun (varsayılan olarak
albolarak adlandırılır) ve Actions sütunundaki Edit YAML seçeneğine tıklayın.-
Edit YAML panelinde
spec.listeners.portvespec.listeners.protocolalanlarını ekleyin, ardından OK düğmesine tıklayın.
kubectl
AlbConfig'i düzenlemek için aşağıdaki komutu çalıştırın:
kubectl edit albconfig <AlbConfig_Name>
spec altına listeners alanını ekleyin:
apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
name: alb-demo
spec:
config:
# ... other config fields
listeners:
- port: 80
protocol: HTTP # Options: HTTP, HTTPS, QUIC
ALB Örneği Otomatik Oluşturma Hatasının Yaygın Nedenleri
AlbConfig bir ALB örneğini otomatik olarak oluşturamazsa, en yaygın nedenlerden biri eksik bir dinleyici yapılandırmasıdır. Örneğin, Ingress rotalarınız TLS/HTTPS gerektiriyorsa ancak AlbConfig hem 80 (HTTP) hem de 443 (HTTPS) bağlantı noktası dinleyicilerini içermiyorsa veya gerekli HTTPS sertifikası eksik ya da yanlış yapılandırılmışsa, örnek oluşturma veya senkronizasyon işlemi başarısız olabilir.
Bu sorunu önlemek için, uygulamadan önce AlbConfig dinleyici yapılandırmanızın Ingress gereksinimlerinizle eşleştiğini doğrulayın:
TLS/HTTPS Ingress rotaları kullanıldığında hem 80 hem de 443 bağlantı noktası dinleyicileri tanımlanmıştır.
HTTPS dinleyicisine geçerli bir sertifika atanmıştır veya etki alanı adına dayalı otomatik sertifika keşfi doğru şekilde yapılandırılmıştır.
HTTPS Sertifikalarını Yapılandırma
Bir HTTPS dinleyicisine bir veya daha fazla sertifika atamak için certificates alanını ayarlayın. ALB, ilk sertifikayı varsayılan sertifika olarak ayarlar. ALB, yalnızca varsayılan sertifikanın süresi dolduğunda veya artık uygulanabilir olmadığında diğer sertifikaları istek şifrelemesi için kullanır.
Bir sertifika belirtmezseniz, dinleyici hemen oluşturulmaz. Bunun yerine, bir Ingress ilişkilendirildikten ve etki alanı adına göre bir sertifika otomatik olarak keşfedildikten sonra oluşturulur. Ayrıntılar için Şifreli İletişim İçin HTTPS Sertifikalarını Yapılandırma konusuna bakın.
listeners:
- caEnabled: false
certificates:
- CertificateId: 756****-cn-hangzhou # Certificate ID
IsDefault: true
port: 443
protocol: HTTPS
TLS Güvenlik İlkesi Yapılandırma
Bir HTTPS dinleyicisine TLS güvenlik ilkesi uygulamak için securityPolicyId değerini ayarlayın. İlkeler özel veya önceden tanımlanmış olabilir. Daha fazla bilgi için bkz. TLS Güvenlik İlkesi.
listeners:
- port: 443
protocol: HTTPS
securityPolicyId: tls_cipher_policy_1_1 # Security policy ID
İstek Zaman Aşımını Ayarlama
Server Load Balancer (SLB) örneğinin bir istemci isteği aldıktan sonra arka uç sunucusundan yanıt bekleyeceği süreyi kontrol etmek için requestTimeout değerini ayarlayın. Zaman aşımı içinde yanıt dönmezse, SLB örneği beklemeyi durdurur ve istemciye HTTP 504 hatası döndürür.
Varsayılan:
60saniyeGeçerli değerler: 1–600 (tamsayı, saniye cinsinden)
600'ün üzerinde bir değer kullanmak için Quota Center üzerinden kota artırımı talep edin.
listeners:
- port: 80
protocol: HTTP
requestTimeout: 60 # Seconds. Default: 60. Valid values: 1–600.
Etki Alanı
requestTimeout, dinleyici düzeyinde (bağlantı noktası düzeyinde) bir parametredir. ALB örneğinde aynı dinleyici bağlantı noktasını kullanan tüm rotalara genel olarak uygulanır. Aynı dinleyicideki bireysel rotalar için farklı ön uç boşta oturum zaman aşımları ayarlamak desteklenmez.
AI Akış Yanıtı Desteği
ALB, AI akış yanıtı arayüzlerini (örneğin, büyük dil modeli akış çıkışı) destekler. ALB'yi AI akış iş yükleriyle kullanırken:
requestTimeoutdeğerini, akış aktarımının tamamını kapsayacak kadar yüksek ayarlayın. Çok düşük bir değer, ALB'nin akış tamamlanmadan önce bağlantıyı kapatmasına ve istemciye HTTP 504 hatası döndürmesine neden olur.Akış oturumunu kesintiye uğratabilecek erken bağlantı sonlandırmalarını önlemek için WAF ve arka uç hizmetleri gibi istek zincirindeki tüm bileşenlerin zaman aşımı ayarlarını doğrulayın.
Dinleyici Etiketleri Ekleme
Bir dinleyiciye anahtar-değer etiketleri eklemek için tags alanını kullanın.
listeners:
- port: 80
protocol: HTTP
tags:
- key: "key"
value: "value1"
Veri Sıkıştırmayı Etkinleştirme
ALB'nin istemcilere iletmeden önce yanıt verilerini sıkıştırıp sıkıştırmayacağını kontrol etmek için gzipEnabled değerini ayarlayın.
true: Yanıtları içerik türüne bağlı olarak Brotli veya Gzip kullanarak sıkıştırır.false: Tüm içerik türleri için sıkıştırmayı devre dışı bırakır.
Sıkıştırma, yalnızca yanıt üst bilgisindeki Content-Length değeri 1.024 baytı aştığında tetiklenir. İki sıkıştırma algoritması şu şekilde çalışır:
Brotli: Tüm içerik türlerini sıkıştırır.
Gzip:
text/plain,text/css,application/javascript,application/x-javascript,application/rss+xml,application/atom+xml,application/xmlveapplication/jsoniçerik türlerini sıkıştırır.
Aşağıdaki örnek sıkıştırmayı devre dışı bırakır:
listeners:
- port: 80
protocol: HTTP
gzipEnabled: false # true: compress specific content types. false: disable all compression.
X-Forwarded-For Üst Bilgilerini Yapılandırma
ALB'nin trafiği arka uç sunucularına iletirken istek üst bilgilerine hangi bilgileri dahil edeceğini kontrol etmek için xForwardedForConfig alanını kullanın.
Tüm xForwardedForConfig parametreleri yalnızca HTTP ve HTTPS dinleyicileri için geçerlidir.
İstemci IP Adresini Alma
XForwardedForEnabled her zaman etkindir ve devre dışı bırakılamaz. Etkinleştirildiğinde, ALB istemci kaynak IP adresini X-Forwarded-For üst bilgisine ekler.
listeners:
- port: 80
protocol: HTTP
xForwardedForConfig:
XForwardedForEnabled: true
Dinleyici Protokolünü Alma
Dinleyici protokolünü arka uç sunucularına iletilen üst bilgilere dahil etmek için XForwardedForProtoEnabled değerini true olarak ayarlayın.
listeners:
- port: 80
protocol: HTTP
xForwardedForConfig:
XForwardedForProtoEnabled: true
SLB Örnek Kimliğini Alma
SLB örnek kimliğini arka uç sunucularına iletilen üst bilgilere dahil etmek için XForwardedForSLBIdEnabled değerini true olarak ayarlayın.
listeners:
- port: 80
protocol: HTTP
xForwardedForConfig:
XForwardedForSLBIdEnabled: true # true: include SLB instance ID. false: omit it.
Dinleme Bağlantı Noktasını Alma
Dinleme bağlantı noktasını arka uç sunucularına iletilen üst bilgilere dahil etmek için XForwardedForSLBPortEnabled değerini true olarak ayarlayın.
listeners:
- port: 80
protocol: HTTP
xForwardedForConfig:
XForwardedForSLBPortEnabled: true # true: include listening port. false: omit it.
Proxy Arkasındaki Gerçek İstemci IP Adresini Alma
İstekler proxy'lerden geçtiğinde, X-Forwarded-For üst bilgisi bir IP adresi zinciri içerebilir. ALB'nin gerçek istemci IP adresini belirlemesine olanak tanımak için XForwardedForClientSourceIpsEnabled değerini true olarak ayarlayın. Bu ayar, listeden sağdan sola doğru ilerleyerek güvenilen listede olmayan ilk IP adresini seçer.
Hangi proxy IP adreslerine güvenileceğini belirtmek için XForwardedForClientSourceIpsTrusted kullanın. Bu özellik, kaynak IP'ye göre hız sınırlama gibi senaryoları destekler.
Biçim: Boşluk içermeyen, noktalı virgülle ayrılmış IP adresleri veya CIDR blokları.
XForwardedForClientSourceIpsTrustedyalnızcaXForwardedForClientSourceIpsEnableddeğeritrueolduğunda etkili olur.
listeners:
- port: 80
protocol: HTTP
xForwardedForConfig:
XForwardedForClientSourceIpsEnabled: true
XForwardedForClientSourceIpsTrusted: 192.168.x.x;192.168.x.x/16 # Semicolon-separated, no spaces
Erişim Kontrolünü Ayarlama
Bir ALB dinleyicisinde erişim kontrolünü etkinleştirmek için aclConfig alanını kullanın. Erişim kontrolü, bir izin listesi veya engelleme listesi yapılandırarak belirli IP adreslerine izin vermenizi veya bunları engellemenizi sağlar. Daha fazla bilgi için bkz. Erişim Kontrolü İçin ACL'leri Yapılandırma.
aclType: İzin listesi içinWhiteveya engelleme listesi içinBlackolarak ayarlayın.aclEntries: CIDR bloklarının listesi. Her giriş eksiksiz bir CIDR bloğu olmalıdır.
listeners:
- port: 80
protocol: HTTP
aclConfig:
aclEntries:
- 127.0.0.1/32 # CIDR block must be complete
aclType: White # White: allowlist. Black: blocklist.
Dinleyici Silme
Bir dinleyiciyi silmek için albconfig.spec.listeners alanından kaldırın.
Silmeden önce dinleyiciyle ilişkili tüm Ingress'leri kaldırın. Herhangi bir Ingress hala ilişkiliyse, silme işlemi başarısız olur.
Önce:
listeners:
- port: 8001
protocol: HTTP
- port: 8002 # Listener to delete
protocol: HTTP
Sonra:
listeners:
- port: 8001
protocol: HTTP