ALB Ingress Controller, Kubernetes kümeleri için harici trafiği iç hizmetlere yönlendiren bir giriş denetleyicisidir. Bir hizmete erişmek için ALB Ingress kullandığınızda, ALB Ingress Controller hizmetle ilişkili uç nokta kaynaklarında yapılan değişiklikleri izler. Denetleyici daha sonra arka uç düğümlerinin durumunu ilgili arka uç sunucu grubuyla eşitler ve bu değişiklikleri Application Load Balancer (ALB) örneğine uygular. Bu konuda, ALB Ingress kullanırken karşılaşabileceğiniz anormal olayların nasıl tanılanacağı ve çözüleceği açıklanmaktadır.
Nasıl çalışır
Bir hizmete ALB Ingress üzerinden eriştiğinizde, ALB Ingress Controller çeşitli kaynaklarda yapılan değişiklikleri izler ve bu değişiklikleri ilişkili ALB örneğiyle eşitler. Bu işlem, çeşitli sınırlamalar veya yapılandırma hataları nedeniyle başarısız olabilir. Aşağıdaki şekilde farklı kaynaklar arasındaki mantıksal ilişkiler ve eşitleme süreci gösterilmektedir.
Adım 1: Anormal olayları kontrol edin
Konsolu kullanın: Sol gezinme bölmesinde, seçeneğini belirleyin. Hedef ad alanını seçin, hedef ingress'in adına tıklayarak ayrıntılar sayfasını açın ve ardından Events sekmesine tıklayın.
-
kubectl kullanın:
kubectl describe ingress <ingress-name> -n <namespace>Beklenen çıktı:
... Events: Type Reason Age From Message ---- ------ ---- ---- ------- Warning FailedBuildModel 2m28s (x10 over 6m43s) ingress listener is not exist in alb, port: 443, protocol: HTTPS Normal Sync 19s (x32 over 11d) ingress Scheduled for sync Normal SuccessfullyReconciled 4s (x20 over 11d) ingress Successfully reconciled
Description sütununda veya Message alanında ingress ile ilgili olay bilgilerini kontrol edin.
Scheduled for sync: Olayın başladığını gösterir.Successfully reconciled: Uzlaştırmanın tamamlandığını gösterir.-
Warningmesajları için sorunu gidermek üzere Adım 2'ye bakın.Anormal olay bildirilmemesine rağmen yaptığınız değişikliklerin etkili olmaması durumunda ALB Ingress değişiklikleri etkili olmadığında ve anormal olay bildirilmediğinde ne yapmalıyım? konusuna bakın.
Adım 2: Anormal olayları analiz edin ve çözün
Aşağıdaki tabloda yaygın anormal olaylar, nedenleri ve çözümleri açıklanmaktadır.
Yeni özelliklerle uyumsuz olan eski bir ALB Ingress Controller bileşen sürümünden kaynaklanan anormal olayları önlemek için tanılama yapmadan önce Sürüm notlarına bakabilir ve bileşeni hedef sürüme yükseltebilirsiniz.
Mesaj | Neden | Çözüm |
listener is not exist in alb, port: 80, protocol: HTTP | ALB Ingress Controller v2.11.0 ve sonraki sürümlerde, bir ingress için dinleyiciler yalnızca ilişkilendirilir, otomatik olarak oluşturulmaz. Bu hata, karşılık gelen AlbConfig'de önceden oluşturmadan bir ingress'te bir dinleyici kullanırsanız oluşur. | ALB Ingress Controller v2.11.0 veya sonraki sürümler için, ingress kaynağı için gereken dinleyiciyi AlbConfig'de oluşturun. Daha fazla bilgi için bkz. AlbConfig kullanarak ALB dinleyicisi yapılandırma. |
listener is not exist in alb, port: 443, protocol: HTTPS | ||
listener not found for (80/HTTP), with ingresses 1 | ALB Ingress Controller v2.11.0 ve sonraki sürümlerde, bu hata hala bir ingress ile ilişkili olan bir dinleyiciyi AlbConfig'den kaldırırsanız oluşur. Hata mesajı eksik dinleyiciyi ve ilişkili ingress sayısını gösterir. | Bir dinleyiciyi kaldırmak için öncelikle bununla ilişkili tüm ingress'leri kaldırmanız gerekir. Önemli Bir dinleyiciyi yanlışlıkla kaldırdıysanız geri eklemeniz gerekir. |
none certificate found for host | TLS etkinleştirilmiş ve bir etki alanı için sertifika otomatik keşfi aktif ancak Certificate Management Service'te bu etki alanı için eşleşen bir sertifika bulunmuyor. |
|
Secret "XXX" not found | Ingress, belirtilen ad alanında bulunmayan bir TLS sertifikası Secret'ına başvuruyor. Bu durum öncelikle HTTPS yapılandırmasını etkiler. Başvurulan Secret eksikse ALB Ingress Controller sertifika yapılandırmasını tamamlayamaz ve AlbConfig yapılandırma güncellemesi sorun çözülene kadar engellenebilir. | Sertifika Secret'ının Ingress ile aynı ad alanında bulunduğundan ve adının Ingress kaynağının |
The param of Rules.1.RuleConditions.2.PathConfig.Values.1 is illegal | Yönlendirme kuralı geçersiz bir yol parametresi içeriyor. |
|
The param of ServerGroupName is illegal | ALB arka uç sunucu grubunun adı geçersiz bir biçime sahip. | Sunucu grubu adının doğru biçimi kullandığından emin olun. Denetleyici sunucu grubu adını |
The specified resource sgp-vz2fb219vv792flx3u is in use | ACK tarafından yönetilen ALB arka uç sunucu grubu başka bir ALB örneği tarafından referans alınıyor. | Application Load Balancer konsoluna giriş yapın. Sol gezinme bölmesinde seçeneğini belirleyin. Server Group sayfasında hedef arka uç sunucu grubunu bulun ve gerektiğinde ALB örneğinin ilişkisini kaldırın. |
Message: Invalid parameter. Check the parameter input. | Bu hata genellikle bir AlbConfig'de sertifika belirtirken sertifika kimliğini yanlış yapılandırdığınızda oluşur. | Sertifika kimliği olarak bir kaynak kimliğinin mi yoksa sayısal bir kimliğin mi kullanıldığını kontrol edin. CertIdentifier tarafından belirtilen sertifika kimliğini kullanmanız gerekir. |
Message: Failed to create SSL Certificate with name default-https-secret-1-b585e6 ({namespace}-{name}-{identity}). Error: The certificate has expired . | Ingress tarafından kullanılan gizli sertifikanın süresi dolmuş. Hata mesajındaki sertifika adı üç bölümden oluşur:
|
Yapılandırma hakkında daha fazla bilgi için bkz. Şifreli iletişim için HTTPS sertifikası yapılandırma. |
failed to createSSLCertificateWithName: XXX ErrorCode: NameRepeat Message: The name is already used. Please enter another name. | Ingress tarafından kullanılan gizli sertifikanın süresi dolmuş. Süresi dolmuş sertifikanın adını yeni bir sertifika yüklerken yeniden kullanmak SSL sertifikası adı çakışmasına neden olur. | |
invalid server group Cookie: |
| Cookie yeniden yazma yöntemini kullandığınızda bir cookie değeri yapılandırmanız gerekir. Parametreler hakkında daha fazla bilgi için bkz. Annotation kullanarak oturum kalıcılığı uygulama. |
| ||
The quota of alb_quota_server_added_num is exceeded for resource eni-xxxx, usage 202/200 | ALB için | Kota Merkezi'nde sunucu grubu kotasını artırın. |
SSS
ALB Ingress değişiklikleri etkili olmuyor
Denetleyici AlbConfig için uzlaştırma olaylarını tetiklemezse veya değişiklik olaylarını işleyemezse neden IngressClass ile AlbConfig arasında yanlış bir bağlama olabilir. Daha fazla bilgi için IngressClass kullanarak AlbConfig'i bir ingress ile ilişkilendirme konusuna bakın ve IngressClass'taki spec.parameters parametresinin doğru AlbConfig kaynak nesnesi adına işaret ettiğini kontrol edin.
Bir ALB Ingress'in harici uç noktası (Endpoint) neden boşdur veya adres alınamıyor ve bunu nasıl çözerim?
Bir ALB Ingress'in harici uç noktası boşsa veya adres alınamıyorsa aşağıdaki yaygın nedenleri kontrol edin ve gerekli işlemi yapın:
IngressClass belirtilmedi: Ingress kaynağının doğru
ingressClassName(örneğinalb) belirttiğinden emin olun.ingressClassNameayarlanmamışsa veya değer ALB Ingress Controller tarafından yönetilen IngressClass ile eşleşmiyorsa denetleyici Ingress'i işlemez ve uç nokta boş kalır.Yanlış AlbConfig ilişkilendirmesi: IngressClass'ın doğru AlbConfig adıyla ilişkilendirilip ilişkilendirilmediğini kontrol edin ve AlbConfig durumunun normal olduğunu doğrulayın. Yanlış bir ilişkilendirme veya anormal durumdaki bir AlbConfig ALB'nin sağlanmasını engeller. Daha fazla bilgi için bkz. IngressClass kullanarak AlbConfig'i bir ingress ile ilişkilendirme.
Yetersiz vSwitch IP adresi: AlbConfig ile ilişkili vSwitch'lerdeki kullanılabilir IP adresi sayısını kontrol edin. ALB'nin esnek özelliklerinin tam olarak desteklendiğinden emin olmak için ALB örneğinin dağıtıldığı her vSwitch'te en az 8 IP adresi ayırın. Kullanılabilir IP adresleri yetersizse vSwitch'i değiştirin veya vSwitch CIDR aralığını genişletin.
Yetersiz kullanılabilirlik alanı: ALB yüksek kullanılabilirlik gerektirir ve en az iki farklı kullanılabilirlik alanında vSwitch'lere ihtiyaç duyar. Yalnızca bir kullanılabilirlik alanı yapılandırıldıysa en az bir diğer kullanılabilirlik alanında vSwitch'ler ekleyin.
Bileşen kurulum seçeneği: Bileşen kurulumu sırasında None seçildiyse otomatik olarak ALB örneği veya AlbConfig oluşturulmadı. AlbConfig ve IngressClass'ı manuel olarak oluşturmanız ve IngressClass kullanarak bir AlbConfig'i bir Ingress ile ilişkilendirmeniz gerekir.