Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:configure alb listeners using albconfig

Son Güncelleme:Oct 06, 2026

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:

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ı

Önemli

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.ServiceManagedResource hatası 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.


Parametre


Tür


Varsayılan


Protokoller


Açıklama


port


integer


—


HTTP, HTTPS, QUIC


Dinleyici bağlantı noktası. Zorunludur. Bu değerin değiştirilmesi, orijinal dinleyiciyi siler ve yeni bir tane oluşturur.


protocol


string


—


HTTP, HTTPS, QUIC


Dinleyici protokolü. Zorunludur. Bu değerin değiştirilmesi, orijinal dinleyiciyi siler ve yeni bir tane oluşturur.


certificates[].CertificateId


string


—


HTTPS


Dinleyiciye atanacak sertifika kimliği.


certificates[].IsDefault


boolean


—


HTTPS


Bunun varsayılan sertifika olup olmadığını belirtir.


caEnabled


boolean


false


HTTPS


CA sertifikası doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirtir.


securityPolicyId


string


—


HTTPS


TLS güvenlik ilkesi kimliği. Örneğin, tls_cipher_policy_1_1.


requestTimeout


integer


60


HTTP, HTTPS


HTTP 504 hatası döndürmeden önce arka uç yanıtı için beklenecek maksimum süre (saniye cinsinden). Geçerli değerler: 1–600.


tags[].key


string


—


—


Etiket anahtarı.


tags[].value


string


—


—


Etiket değeri.


gzipEnabled


boolean


—


HTTP, HTTPS


Veri sıkıştırmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. true: belirli içerik türlerini sıkıştırır. false: tüm sıkıştırmayı devre dışı bırakır.


xForwardedForConfig.XForwardedForEnabled


boolean


true


HTTP, HTTPS


İstemci IP adresinin X-Forwarded-For üst bilgisine dahil edilip edilmeyeceğini belirtir. Her zaman etkindir; devre dışı bırakılamaz.


xForwardedForConfig.XForwardedForProtoEnabled


boolean


—


HTTP, HTTPS


Dinleyici protokolünün, arka uç sunucularına iletilen istek üst bilgilerine dahil edilip edilmeyeceğini belirtir.


xForwardedForConfig.XForwardedForSLBIdEnabled


boolean


—


HTTP, HTTPS


SLB örnek kimliğinin, arka uç sunucularına iletilen istek üst bilgilerine dahil edilip edilmeyeceğini belirtir.


xForwardedForConfig.XForwardedForSLBPortEnabled


boolean


—


HTTP, HTTPS


Dinleme bağlantı noktasının, arka uç sunucularına iletilen istek üst bilgilerine dahil edilip edilmeyeceğini belirtir.


xForwardedForConfig.XForwardedForClientSourceIpsEnabled


boolean


—


HTTP, HTTPS


Gerçek istemci IP adresinin X-Forwarded-For üst bilgisinden alınıp alınmayacağını belirtir.


xForwardedForConfig.XForwardedForClientSourceIpsTrusted


string


—


HTTP, HTTPS


Güvenilen proxy IP adreslerinin veya CIDR bloklarının noktalı virgülle ayrılmış listesi. Yalnızca XForwardedForClientSourceIpsEnabled değeri true olduğunda etkili olur.


aclConfig.aclType


string


—


HTTP, HTTPS


Erişim Kontrol Listesi (ACL) türü: White (izin listesi) veya Black (engelleme listesi).


aclConfig.aclEntries[]


string


—


HTTP, HTTPS


Erişim kontrolü için CIDR blokları. Her giriş eksiksiz bir CIDR bloğu olmalıdır.

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ı


Senaryo


Yeni yapılandırmada


Mevcut yapılandırmada


last-applied-configuration içinde


Sonuç


①


Evet


Evet


—


Birleştirme: Mevcut nesneyi güncellemek için yeni yapılandırmadaki değerleri uygular.


②


Evet


Hayır


—


Oluşturma: Yeni dinleyiciyi ekler.


③


Hayır


—


Evet


Silme: Dinleyiciyi kaldırır. Varsayılan değere sıfırlayabilir.


④


Hayır


Evet


Hayır


Silme: Dinleyiciyi mevcut yapılandırmadan kaldırır.

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

Önemli

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

  1. Container Service konsoluna giriş yapın ve sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Kümenizin adına tıklayın. Sol gezinme bölmesinde Workloads > Custom Resources seçeneğini belirleyin.

  3. Resource Objects sekmesinde, arama kutusuna AlbConfig girin ve AlbConfig sonucuna tıklayın.

  4. AlbConfig panelinde, AlbConfig kaynağını bulun (varsayılan olarak alb olarak adlandırılır) ve Actions sütunundaki Edit YAML seçeneğine tıklayın.

  5. Edit YAML panelinde spec.listeners.port ve spec.listeners.protocol alanlarını ekleyin, ardından OK düğmesine tıklayın.

    image

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: 60 saniye

  • Geç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:

  • requestTimeout değ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/xml ve application/json iç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.

Önemli

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

  • XForwardedForClientSourceIpsTrusted yalnızca XForwardedForClientSourceIpsEnabled değeri true olduğ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çin White veya engelleme listesi için Black olarak 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.

Önemli

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