Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Troubleshoot ALB Ingress issues

Son Güncelleme:Oct 15, 2026

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.

image

Adım 1: Anormal olayları kontrol edin

  • Konsolu kullanın: Sol gezinme bölmesinde, Network > Ingresses 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.

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 tls.secretName alanında belirtilen değerle tam olarak eşleştiğinden emin olun.

The param of Rules.1.RuleConditions.2.PathConfig.Values.1 is illegal

Yönlendirme kuralı geçersiz bir yol parametresi içeriyor.

  • Ingress'te Rewrite annotation kullanıyorsanız pathType alanının değerini Prefix olarak değiştirin.

  • Ingress'te Rewrite annotation kullanmıyorsanız path alanında geçersiz karakterler olabilir.

    Not

    Normal ifade olmayan yol türleri için yol / ile başlamalıdır. Harfler, rakamlar ve şu özel karakterleri içerebilir: dolar işaretleri ($), artı işaretleri (+), eğik çizgiler (/), ampersanlar (&), tilde (~), at işaretleri (@), alt çizgiler (_), kısa çizgiler (-), noktalar (.) ve iki nokta (:). Joker karakter olarak yıldız işareti (*) ve soru işareti (?) de desteklenir.

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ı adalanı+HizmetAdı+bağlantınoktası biçiminde oluşturur. Ad 2 ila 128 karakter uzunluğunda olmalı, bir harf veya Çince karakterle başlamalı ve rakamlar, noktalar (.), alt çizgiler (_) ve kısa çizgiler (-) içerebilir.

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 ALB > Server Group 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: {namespace}-{name}-{identity}.

  • {namespace}: Etkilenen Secret'ın bulunduğu ad alanı. Örnek: default.

  • {name}: Etkilenen Secret'ın adı. Örnek: https-secret-1.

  • {identity}: Secret içeriğinin karma değeri. Örnek: b585e6.

  • Bu gizli sertifikayı kullanmaya devam etmek istiyorsanız hata mesajındaki {namespace}-{name} bilgisine dayanarak süresi dolmuş Secret'ı bulun ve içeriğini geçerli bir sertifikayla güncelleyin. Yeni sertifikanın geçerlilik süresi mevcut tarihten en az 1 gün sonra bitmelidir.

  • Bu gizli sertifikaya artık ihtiyacınız yoksa karşılık gelen ingress kaynağını düzenleyin ve süresi dolmuş Secret'a başvuran yapılandırmayı tls alanından kaldırın.

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 yapılandırılmadı

    Oturum kalıcılığını cookie yeniden yazma yöntemi (sticky-session-type: "Server") kullanacak şekilde yapılandırırsanız bir cookie değeri belirtmezseniz bu hata oluşur. Aşağıdaki kod hatalı bir yapılandırma örneği sunar:

    ...
        alb.ingress.kubernetes.io/sticky-session: "true"
        alb.ingress.kubernetes.io/sticky-session-type: "Server"   
        alb.ingress.kubernetes.io/cookie: "" # Not allowed to be empty.

Cookie yeniden yazma yöntemini kullandığınızda bir cookie değeri yapılandırmanız gerekir.

...
    alb.ingress.kubernetes.io/cookie: "test" 

Parametreler hakkında daha fazla bilgi için bkz. Annotation kullanarak oturum kalıcılığı uygulama.

  • ALB Ingress Controller sürümü çok eski.

    v2.15.0-aliyun.1 önceki ALB Ingress Controller sürümlerinde sunucu grubu oturum kalıcılığı özel cookieleri desteklemez.

ALB Ingress Controller bileşenini yükseltin.

The quota of alb_quota_server_added_num is exceeded for resource eni-xxxx, usage 202/200

ALB için alb_quota_server_added_num kotasına ulaşıldı. Bu, bir arka uç sunucusunun (IP adresine göre) ALB arka uç sunucu gruplarına eklenebileceği maksimum sayıdır.

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:

  1. IngressClass belirtilmedi: Ingress kaynağının doğru ingressClassName (örneğin alb) belirttiğinden emin olun. ingressClassName ayarlanmamış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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.