Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:ALB Ingress Configuration Dictionary

Son Güncelleme:Oct 06, 2026

ALB örneği ve dinleyici yapılandırması için desteklenen tüm Ingress ek açıklamalarını (annotations) ve AlbConfig alanlarını inceleyin.

İçindekiler

Ek açıklama alanları

Özellik kategorisi

Ingress ek açıklaması yapılandırması

Ek Açıklaması YAML

Ek Açıklaması YAML örneği

ALB Ingress yapılandırması

Sağlık denetimi

Dinleyici veya protokol yapılandırması

Trafik yönlendirme kuralı yapılandırması

Gelişmiş yapılandırma

Diğer

Diğer

AlbConfig alanları

Alan kategorisi

Alan bağlantıları

AlbConfig YAML

Tam AlbConfig YAML

AlbConfig

ALB örneği

LoadBalancerSpec

Dinleyici yapılandırması

ListenerSpec[]

Sanal anahtar

ZoneMapping

Simple Log Service

AccessLogConfig

QUIC dinleyicisi

QuicConfig

Sertifika yapılandırması

Certificate

Erişim kontrolü

AclConfig

Tracing Analysis

AccessLogTracingConfig

X-Forwarded- yapılandırması

XForwardedForConfig

Günlüklerde özel üst bilgi

LogConfig

Ayrılmış alanlar

Ek Açıklaması YAML örneği

Ingress ek açıklamaları ile bir ALB örneğini yapılandırma örneği.

Ingress için Ek Açıklaması YAML örneğini görüntülemek üzere genişletin

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/healthcheck-enabled: "true"
    alb.ingress.kubernetes.io/healthcheck-path: "/"
    alb.ingress.kubernetes.io/healthcheck-protocol: "HTTP"
    alb.ingress.kubernetes.io/healthcheck-httpversion: "HTTP1.1"
    alb.ingress.kubernetes.io/healthcheck-method: "HEAD"
    alb.ingress.kubernetes.io/healthcheck-code: "http_2xx"
    alb.ingress.kubernetes.io/healthcheck-timeout-seconds: "5"
    alb.ingress.kubernetes.io/healthcheck-interval-seconds: "2"
    alb.ingress.kubernetes.io/healthy-threshold-count: "3"
    alb.ingress.kubernetes.io/unhealthy-threshold-count: "3"
    alb.ingress.kubernetes.io/conditions.service-a: | # The service referenced here must exist in the cluster. Its name must match the service name in the backend field of the rule.
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*^/pathvalue1", # Add ~* before a regular expression to mark it as such. The part after ~* is the actual regular expression.
              "/pathvalue2" # Do not add ~* before an exact match.
           ]
       }
      }]
    alb.ingress.kubernetes.io/order: "1"
    alb.ingress.kubernetes.io/canary: "true"
    alb.ingress.kubernetes.io/canary-by-header: "location"
    alb.ingress.kubernetes.io/canary-by-header-value: "hz"
    ... ...
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      # Configure context path
      - path: /tea
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      # Configure context path
      - path: /coffee
        pathType: Prefix
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

Ingress tarafından desteklenen ek açıklamalar

İhtiyaç duyulduğunda Ingress kaynaklarına ek açıklamalar ekleyin.

Sağlık denetimi

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/healthcheck-enabled

Arka uç sunucu grubu için sağlık denetimlerini etkinleştirin. Bkz. Sağlık denetimini yapılandırma.

  • true: Etkinleştirir

  • false: Devre dışı bırakır

Varsayılan: false.

alb.ingress.kubernetes.io/healthcheck-path

Sağlık denetimi yolu.

Varsayılan: /.

alb.ingress.kubernetes.io/healthcheck-protocol

Sağlık denetimleri için kullanılan protokol.

  • HTTP: HTTP kullanır. Tarayıcı erişimini simüle etmek ve uygulama sağlığını doğrulamak için HEAD veya GET istekleri gönderir.

  • HTTPS: HTTPS kullanır. Tarayıcı erişimini simüle etmek ve uygulama sağlığını doğrulamak için HEAD veya GET istekleri gönderir.

  • TCP: TCP kullanır. Sunucu bağlantı noktasının etkin olup olmadığını doğrulamak için SYN el sıkışma paketleri gönderir.

  • GRPC: gRPC kullanır. Uygulama sağlığını doğrulamak için POST veya GET istekleri gönderir.

Varsayılan: HTTP.

alb.ingress.kubernetes.io/healthcheck-httpversion

HTTP sürümü. Yalnızca healthcheck-protocol değeri HTTP veya HTTPS olduğunda geçerlidir.

  • HTTP1.0

  • HTTP1.1

Varsayılan: HTTP1.1.

alb.ingress.kubernetes.io/healthcheck-method

Sağlık denetimi yöntemi.

  • HEAD

  • POST

  • GET

Varsayılan: HEAD.

Önemli

healthcheck-protocol değeri GRPC olduğunda POST veya GET seçin.

alb.ingress.kubernetes.io/healthcheck-httpcode

Sağlık denetimi durum kodları. Arka uç sunucusu yalnızca probe bu kodlardan birini döndürdüğünde sağlıklı kabul edilir.

Virgülle ayrılmış bir veya daha fazla değer belirtin:

  • http_2xx

  • http_3xx

  • http_4xx

  • http_5xx

Varsayılan: http_2xx.

alb.ingress.kubernetes.io/healthcheck-code

Sağlık denetimi durum kodları. Arka uç sunucusu yalnızca probe bu kodlardan birini döndürdüğünde sağlıklı kabul edilir.

Hem healthcheck-httpcode hem de bu alan ayarlanırsa bu alan önceliklidir.

Geçerli değerler, healthcheck-protocol değerine bağlıdır:

  • HTTP veya HTTPS:

    Virgülle ayrılmış bir veya daha fazla değer belirtin:

    • http_2xx

    • http_3xx

    • http_4xx

    • http_5xx

    Varsayılan: http_2xx.

  • GRPC:

    Aralık: [0, 99].

    Varsayılan: 0.

    Virgülle ayrılmış en fazla 20 aralık desteklenir.

alb.ingress.kubernetes.io/healthcheck-timeout-seconds

Saniye (s) cinsinden sağlık denetimi zaman aşımı süresi.

Aralık: [1, 300].

Varsayılan: 5.

alb.ingress.kubernetes.io/healthcheck-interval-seconds

Saniye (s) cinsinden sağlık denetimleri arasındaki aralık.

Aralık: [1, 50].

Varsayılan: 2.

alb.ingress.kubernetes.io/healthy-threshold-count

Bir sunucuyu sağlıklı olarak işaretlemek için gereken ardışık başarılı sağlık denetimi sayısı.

Aralık: [2, 10].

Varsayılan: 3.

alb.ingress.kubernetes.io/unhealthy-threshold-count

Bir sunucuyu sağlıksız olarak işaretlemek için gereken ardışık başarısız sağlık denetimi sayısı.

Aralık: [2, 10].

Varsayılan: 3.

alb.ingress.kubernetes.io/healthcheck-connect-port

Sağlık denetimleri için kullanılan bağlantı noktası.

Varsayılan: 0.

Not

0 değeri, sağlık denetiminin arka uç sunucusunun bağlantı noktasını kullandığını gösterir.

Yönlendirme

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/ssl-redirect

HTTP isteklerini 308 durum koduyla HTTPS'ye (443 numaralı bağlantı noktası) yönlendirin. Bkz. HTTP'den HTTPS'ye yönlendirmeyi yapılandırma.

  • true: HTTPS'ye yönlendirir.

  • false: HTTPS'ye yönlendirmez.

Varsayılan: false.

Arka uç hizmeti tarafından kullanılan protokol

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/backend-protocol

Arka uç sunucu grubu tarafından kullanılan protokol. Bkz. Arka uç sunucularında HTTPS ve gRPC protokollerinin desteklenmesi.

  • http: HTTP kullanır.

  • https: HTTPS kullanır.

  • grpc: gRPC kullanır.

Varsayılan: http.

Not

Dinleyici türüne göre desteklenen arka uç protokolleri:

  • HTTP dinleyicileri HTTP ve HTTPS'yi destekler.

  • HTTPS dinleyicileri HTTP, HTTPS ve gRPC'yi destekler.

  • QUIC dinleyicileri HTTP'yi destekler.

Yeniden yazma


Ek Açıklama


Açıklama


alb.ingress.kubernetes.io/rewrite-target


Yol yeniden yazma için hedef yol. Bkz. Yolu yeniden yazma.

Dinleyici

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/listen-ports

Ingress kaynağıyla ilişkili dinleyiciler için bağlantı noktaları ve protokoller. Bkz. Özel dinleyici bağlantı noktalarını yapılandırma.

Ingress kurallarıyla ilişkilendirilecek dinleyici protokollerini ve bağlantı noktalarını belirtin:

  • '[{"HTTP": 80}]' : 80 numaralı bağlantı noktasındaki HTTP dinleyicisiyle ilişkilendirir.

  • '[{"HTTPS": 443}]' : 443 numaralı bağlantı noktasındaki HTTPS dinleyicisiyle ilişkilendirir.

  • '[{"QUIC": 443}]' : 443 numaralı bağlantı noktasındaki QUIC dinleyicisiyle ilişkilendirir.

  • '[{"HTTP": 80}, {"HTTPS": 443}]' : 80 numaralı bağlantı noktasındaki HTTP dinleyicisi ve 443 numaralı bağlantı noktasındaki HTTPS dinleyicisiyle ilişkilendirir.

  • '[{"HTTPS": 443}, {"QUIC": 443}]' : 443 numaralı bağlantı noktasındaki HTTPS dinleyicisi ve 443 numaralı bağlantı noktasındaki QUIC dinleyicisiyle ilişkilendirir.

Yavaş başlatma

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/slow-start-enabled

Yavaş başlatmayı etkinleştirin. ALB Ingress, başlatma sırasında CPU ve bellek dalgalanmalarını önlemek için trafiği yeni eklenen pod'lara kademeli olarak yönlendirir. Bkz. Arka uç yavaş başlatma.

  • true: Etkinleştirir

  • false: Devre dışı bırakır

Varsayılan: devre dışı.

alb.ingress.kubernetes.io/slow-start-duration

Yavaş başlatma başladıktan sonra trafiğin kademeli artışı için geçen süre (saniye cinsinden). Daha uzun süreler daha yavaş bir artış anlamına gelir.

Aralık: [30, 900].

Varsayılan: 30.

Öncelik

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/order

İletme kuralının göreli önceliği. Daha düşük sayılar daha yüksek önceliği gösterir. Bkz. İletme kuralı önceliğini yapılandırma.

Aralık: [1, 1000].

Varsayılan: 10.

Aşamalı sürüm

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/canary

Canary aşamalı sürümü etkinleştirin. Bkz. ALB Ingress ile aşamalı sürüm uygulama.

  • true: Etkinleştirir

  • false: Devre dışı bırakır

Varsayılan: false.

alb.ingress.kubernetes.io/canary-by-header

Canary yönlendirmeyi tetiklemek için kullanılan istek üst bilgisi.

alb.ingress.kubernetes.io/canary-by-header-value

Canary yönlendirmeyi tetikleyen üst bilgi değeri.

alb.ingress.kubernetes.io/canary-by-cookie

Canary yönlendirmeyi tetiklemek için kullanılan çerez.

alb.ingress.kubernetes.io/canary-weight

Belirtilen hizmete yönlendirilen isteklerin yüzdesi (0–100). Bkz. Canary ağırlığı.

Oturum kalıcılığı

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/sticky-session

Arka uç sunucu grubu için oturum kalıcılığını etkinleştirin. Bkz. Ek açıklamalarla oturum kalıcılığını etkinleştirme.

  • true: Oturum kalıcılığını etkinleştirir.

  • false: Oturum kalıcılığını devre dışı bırakır.

Varsayılan: false.

alb.ingress.kubernetes.io/sticky-session-type

Oturum kalıcılığı türü.

  • Insert: Çerez ekleme modu. ALB, istemcinin ilk ziyaretinde yanıt içine bir çerez ekler.

  • Server: Çerez yeniden yazma modu. ALB, kullanıcı tanımlı bir çerez varsa mevcut çerezi yeniden yazar.

Varsayılan: Insert.

alb.ingress.kubernetes.io/cookie-timeout

Saniye (s) cinsinden oturum kalıcılığı zaman aşımı süresi.

Aralık: [1, 86400].

Varsayılan: 1000.

alb.ingress.kubernetes.io/cookie

Özel çerez değeri. Tür: string. Varsayılan: "".

Bağlantı boşaltma

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/connection-drain-enabled

Bağlantı boşaltmayı etkinleştirin. ALB Ingress, bir pod Sonlandırılıyor durumuna geçtiğinde veya sağlık denetimlerini geçemediğinde belirli bir süre boyunca trafiği korur. Zaman aşımından sonra bağlantılar kapatılır. Bkz. Bağlantı boşaltma.

  • true: Bağlantı boşaltmayı etkinleştirir.

  • false: Bağlantı boşaltmayı devre dışı bırakır.

Varsayılan: devre dışı.

alb.ingress.kubernetes.io/connection-drain-timeout

Saniye (s) cinsinden bağlantı boşaltma zaman aşımı süresi.

Aralık: [0, 900].

Varsayılan: 300.

Yük dengeleme

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/backend-scheduler

Arka uç sunucu grubu için yük dengeleme algoritması. Bkz. Arka uç sunucu grubu için yük dengeleme algoritması belirtme.

  • wrr: Ağırlıklı döngüsel sıralama. Daha yüksek ağırlıklar seçilme olasılığını artırır.

  • wlc: Ağırlıklı en az bağlantı. Eşit ağırlıklarda, mevcut bağlantı sayısı daha az olan sunucuların seçilme olasılığı daha yüksektir.

  • sch: Kaynak IP karmaşı. Aynı kaynak IP'den gelen istekler aynı sunucuya gider.

  • uch: URL karmaşı. Özdeş URL parametrelerine sahip istekler aynı sunucuya gider.

Varsayılan: wrr.

alb.ingress.kubernetes.io/backend-scheduler-uch-value

Yük dengeleme algoritması uch olduğunda kullanılan URL karma parametresi.

Çapraz etki alanı

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/enable-cors

Çapraz kaynak paylaşımını (CORS) etkinleştirin. Bkz. CORS yapılandırması.

  • true: CORS'u etkinleştirir.

  • false: CORS'u devre dışı bırakır.

Varsayılan: false.

alb.ingress.kubernetes.io/cors-allow-origin

Çapraz etki alanı isteği yapmasına izin verilen kaynaklar.

Varsayılan: *.

alb.ingress.kubernetes.io/cors-expose-headers

İstemciye gösterilen üst bilgiler listesi.

alb.ingress.kubernetes.io/cors-allow-methods

Çapraz etki alanı istekleri için izin verilen HTTP yöntemleri.

Bir veya daha fazla değer belirtin:

  • GET

  • POST

  • PUT

  • DELETE

  • HEAD

  • OPTIONS

  • PATCH

Varsayılan: "GET, PUT, POST, DELETE, PATCH, OPTIONS".

alb.ingress.kubernetes.io/cors-allow-credentials

Çapraz etki alanı isteklerinde kimlik bilgilerine izin verin.

  • true: Kimlik bilgilerine izin verir.

  • false: Kimlik bilgilerine izin vermez.

Varsayılan: true.

alb.ingress.kubernetes.io/cors-max-age

Tarayıcılarda ön istek yanıtlarının önbellekte tutulacağı maksimum süre (saniye cinsinden).

Aralık: [-1, 172800].

Varsayılan: 172800.

Not

-1 değeri sonsuz önbellek süresi anlamına gelir.

alb.ingress.kubernetes.io/cors-allow-headers

Çapraz etki alanı isteklerinde izin verilen üst bilgiler listesi.

Varsayılan: "DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization".

Özel iletme

Ek Açıklama

Açıklama

alb.ingress.kubernetes.io/actions.{svcName}

Özel iletme eylemi. Bkz. ALB Ingress için özel iletme kuralları tanımlama.

alb.ingress.kubernetes.io/conditions.{svcName}

Özel iletme koşulu.

alb.ingress.kubernetes.io/rule-direction.{svcName}

Özel iletme yönü.

  • Request: İstekleri alırken özel iletmeyi uygular.

  • Response: Yanıtları gönderirken özel iletmeyi uygular.

Varsayılan: Request.

Arka uç sunucu grubu için IPv6 eki

Açıklama

Açıklama

alb.ingress.kubernetes.io/enable-ipv6

Arka uç sunucu grubu için IPv6 ekini etkinleştirin. Bkz. Arka uç sunucu gruplarına IPv6 adresleri ekleme.

  • true: Etkinleştirir.

  • false: Devre dışı bırakır.

Varsayılan: false.

Diğer


Açıklama


Açıklama


alb.ingress.kubernetes.io/backend-keepalive

Arka uç sunucularına kalıcı bağlantıları etkinleştirin. Bkz. Arka uç sunucularına kalıcı bağlantılar.

Varsayılan: false.


alb.ingress.kubernetes.io/traffic-limit-qps

Saniye başına istek (QPS) hız sınırlaması.

Aralık: [1, 1000000].


alb.ingress.kubernetes.io/use-regex

Yol alanında düzenli ifadelerin kullanılmasına izin verin. Yalnızca Ön Ek yol türlerine uygulanır.

Varsayılan: false.

AlbConfig alanları

Bir AlbConfig özel kaynağı, bir ALB örneğini ve dinleyicilerini tanımlar. Alan ayrıntıları için aşağıya bakın.

Tam AlbConfig YAML dosyasını görüntülemek için genişletin

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-config-example
spec:
  # Set ALB instance properties based on your needs.
  config:
    id: ""   # ALB instance ID. Leave empty to create a new instance.
    name: alb-instance-name       
    addressAllocatedMode: Fixed
    addressType: Internet
    ipv6AddressType: Intranet
    addressIpVersion: IPv4
    resourceGroupId: ""
    edition: Standard
    deletionProtectionEnabled: false
    forceOverride: false
    listenerForceOverride: false
    zoneMappings:            # Virtual switches.
      - vSwitchId: vsw-uf6ccg2a9g71hx8go****
        zoneId: "" 
        allocationId:   eip-asdfas****         
        eipType: ""
      - vSwitchId: vsw-uf6nun9tql5t8nh15****
        zoneId: ""      
        allocationId: "eip-xxxx"
        eipType: ""
    securityGroupids:           
      - sg-uf6blkp8************ # Security group ID.
      - sg-djladhla************ # Security group ID.
    accessLogConfig:        # Simple Log Service.
      logProject: ""
      logStore: "alb_******"    
    billingConfig:           
      internetBandwidth: 0
      internetChargeType: ""
      payType: ""
      bandWidthPackageId: "cbwp-xxx" 
    modificationProtectionConfig:
      reason: ""
      status: ""
    tags:
      - key: example-key
        value: example-value
  listeners:
    # Set listener properties based on your needs.
    - port: 80
      protocol: HTTP         # HTTP: Use HTTP. HTTPS: Use HTTPS. QUIC: Use QUIC.
      gzipEnabled: null
      http2Enabled: null
      securityPolicyId: ""
      idleTimeout: 15
      loadBalancerId: ""
      description: "Listener description"
      caEnabled: false
      requestTimeout: 60
      quicConfig:
        quicUpgradeEnabled: false
        quicListenerId: ""
      defaultActions: []
      caCertificates: []
      certificates: []
      xForwardedForConfig:     # X-Forwarded- configuration.
        XForwardedForClientCertSubjectDNEnabled: false
        XForwardedForProtoEnabled: false
        XForwardedForClientCertIssuerDNEnabled: false
        XForwardedForSLBIdEnabled: false
        XForwardedForClientSrcPortEnabled: false
        XForwardedForClientCertFingerprintEnabled: false
        XForwardedForEnabled: true
        XForwardedForProcessingMode: append
        XForwardedForHostEnabled: false
        XForwardedForSLBPortEnabled: false
        XForwardedForClientCertClientVerifyEnabled: false
        XForwardedForClientCertSubjectDNAlias: ""
        XForwardedForClientCertClientVerifyAlias: ""
        XForwardedForClientCertIssuerDNAlias: ""
        XForwardedForClientCertFingerprintAlias: ""
        XForwardedForClientSourceIpsEnabled: false
        XForwardedForClientSourceIpsTrusted: ""
      logConfig:
        accessLogRecordCustomizedHeadersEnabled: false
        accessLogTracingConfig:
          tracingEnabled: false
          tracingSample: 100
          tracingType: Zipkin
      aclConfig:
        aclName: ""
        aclType: Black
        aclEntries: []
        aclIds: []
status:
  loadBalancer:
    dnsname: ""
    id: ""
    listeners:
      portAndProtocol: ""
      certificates:
        certificateId: ""
        isDefault: false

AlbConfig


Alan


Veri türü


Açıklama


apiVersion


Sabit değer

Bu kaynak için API sürümü.

Sabit değer: alibabacloud.com/v1.


kind


Sabit değer

Kaynak türü.

Sabit değer: AlbConfig.


metadata


ObjectMeta


Standart nesne meta verileri.


spec


AlbConfigSpec


ALB örneği ve dinleyici özelliklerini açıklayan parametreler.


status


AlbConfigStatus


Uzlaştırma sonrasında örnek durumu status alanına yazılır. Mevcut örnek durumunu yansıtır.

AlbConfigSpec


Alan


Veri türü


Açıklama


config


LoadBalancerSpec


ALB örneğinin özellikleri.


listeners


[ListenerSpec[]](#ApyPx)


Örnek altındaki dinleyicilerin özellikleri.

LoadBalancerSpec

Alan

Veri türü

Açıklama

id

string

ALB örnek kimliği. Yeniden kullanım modunu etkinleştirmek için doldurun. Yeni bir örnek oluşturmak için boş bırakın. Bkz. AlbConfig oluşturma.

Varsayılan: "".

name

string

ALB örnek adı.

Varsayılan: Bu kalıp kullanılarak otomatik olarak oluşturulur: k8s-{namespace}-{name}-{hashCode}.

addressAllocatedMode

enum

Adres tahsis modu.

  • Dynamic: Alan başına en az bir IP adresi. IP adresleri trafikle birlikte otomatik olarak ölçeklenir. Saniyede 1 milyona kadar isteği (QPS) destekler.

  • Fixed: Alan başına tam olarak bir sabit IP adresi. Esneklik sınırlıdır. Saniyede 100.000 isteği (QPS) destekler.

Varsayılan: Fixed.

addressType

enum

IPv4 adres türü.

  • Internet: Genel mod. Otomatik olarak bir genel alan adı alır.

  • Intranet: Özel mod.

Varsayılan: Internet.

ipv6AddressType

enum

IPv6 adres türü. IPv4 adres türüyle eşleşmesi gerekmez.

  • Internet: Genel mod. Otomatik olarak bir genel alan adı alır.

  • Intranet: Özel mod.

Varsayılan: Intranet.

addressIpVersion

enum

Örneğin çift yığın desteğini belirler.

  • IPv4: Yalnızca IPv4.

  • DualStack: Çift yığın. Hem IPv4 hem de IPv6'yı destekler.

Varsayılan: IPv4.

resourceGroupId

string

Kaynak grubu kimliği.

Varsayılan: "".

edition

enum

Özellik sürümü. Yeniden kullanım modunda değiştirilemez.

Varsayılan: Standard.

deletionProtectionEnabled

bool

Rezerve edilmiş alan. Değiştirmeyin.

forceOverride

bool

Yeniden kullanım modunda örnek özelliklerini zorla geçersiz kılma.

  • true: Zorla geçersiz kıl.

  • false: Zorla geçersiz kılmaz.

  • null: Zorla geçersiz kılmaz.

Varsayılan: false.

listenerForceOverride

bool

Yeniden kullanım modunda dinleyici özelliklerini zorla geçersiz kılma.

  • true: Zorla geçersiz kıl.

  • false: Zorla geçersiz kılmaz.

  • null: Zorla geçersiz kılmaz.

Varsayılan: null.

zoneMappings

ZoneMapping[]

Alanlar ve EIP yapılandırmaları.

accessLogConfig

AccessLogConfig

Günlük toplama.

billingConfig

BillingConfig

Faturalandırma yöntemi.

modificationProtectionConfig

ModificationProtectionConfig

Yapılandırma salt okunur modu.

tags

Tag[]

Örnek etiketleri.

securityGroupIds

string[]

ALB örneği için güvenlik grubu kimlikleri. Bkz. AlbConfig ile güvenlik gruplarını yapılandırma.

ZoneMapping


Alan


Veri türü


Açıklama


vSwitchId


string

(Zorunlu) Sanal anahtar kimliği.

Varsayılan: "".


zoneId


string

Sanal anahtarın alanı. Varsayılan değeri koruyun.

Varsayılan: "".


allocationId


string

Elastic IP (EIP) kimliği. Bkz. AlbConfig ile ALB örneklerini yapılandırma.

Varsayılan: "eip-xxxx".


eipType


string


Rezerve edilmiş alan. Değiştirmeyin.

AccessLogConfig


Alan


Veri türü


Açıklama


logProject


string

Simple Log Service projesinin adı.

Varsayılan: "".


logStore


string

Simple Log Service (SLS) Logstore adı. alb_ ile başlamalıdır. Logstore yoksa otomatik olarak oluşturulur. Bkz. Simple Log Service için erişim günlüklerini etkinleştirme.

Varsayılan: "alb_****".

BillingConfig


Alan


Veri türü


Açıklama


internetBandwidth


int


Rezerve edilmiş alan. Değiştirmeyin.


internetChargeType


string


Rezerve edilmiş alan. Değiştirmeyin.


payType


enum


Rezerve edilmiş alan. Değiştirmeyin.


bandWidthPackageId


string

İliştirilecek İnternet Paylaşımlı Bant Genişliği paketinin kimliği. İliştirildikten sonra kaldırılamaz. Bkz. İnternet Paylaşımlı Bant Genişliği paketi yapılandırması.

Varsayılan: "cbwp-xxx".

ModificationProtectionConfig


Alan


Veri türü


Açıklama


reason


string


Rezerve edilmiş alan.


status


string


Rezerve edilmiş alan.

Tag


Alan


Veri türü


Açıklama


key


string

Etiket anahtarı.

Varsayılan: "".


value


string

Etiket değeri.

Varsayılan: "".

ListenerSpec

Alan

Veri türü

Açıklama

gzipEnabled

bool

Veri sıkıştırmayı etkinleştirin. Bkz. Veri sıkıştırma kullanma.

  • true: Sıkıştırmayı etkinleştirir.

  • false: Sıkıştırmayı devre dışı bırakır.

  • null: Sıkıştırmayı etkinleştirir.

Varsayılan: null.

http2Enabled

bool

HTTP/2 protokolünü etkinleştirin.

  • true: HTTP/2'yi etkinleştirir.

  • false: HTTP/2'yi devre dışı bırakır.

  • null: HTTP/2'yi etkinleştirir.

Varsayılan: null.

port

int

(Zorunlu) Dinleyici tarafından kullanılan bağlantı noktası.

Varsayılan: 0.

protocol

enum

(Zorunlu) Dinleyici tarafından kullanılan protokol.

  • HTTP: HTTP kullanır.

  • HTTPS: HTTPS kullanır.

  • QUIC: QUIC kullanır.

securityPolicyId

string

TLS güvenlik ilkesi kimliği.

Varsayılan: "".

idleTimeout

int

Boşta bağlantı zaman aşımı süresi (saniye cinsinden).

Aralık: [1, 600].

Varsayılan: 15.

Not

0 değeri varsayılanı kullanır.

loadBalancerId

string

Rezerve edilmiş alan. Değiştirmeyin.

description

string

Dinleyici adı.

Varsayılan: Bu kalıp kullanılarak otomatik olarak oluşturulur: ingress-auto-listener-{port}.

caEnabled

bool

Karşılıklı kimlik doğrulamayı etkinleştirin.

  • true: Karşılıklı kimlik doğrulamayı etkinleştirir.

  • false: Karşılıklı kimlik doğrulamayı devre dışı bırakır.

Varsayılan: false.

requestTimeout

int

İstek zaman aşımı süresi (saniye cinsinden).

Aralık: [1, 600].

Varsayılan: 60.

quicConfig

QuicConfig

QUIC dinleyici yapılandırması.

defaultActions

Action[]

Rezerve edilmiş alan. Değiştirmeyin.

caCertificates

Certificate[]

Dinleyici için kök CA sertifikası.

certificates

Certificate[]

Dinleyici için sunucu sertifikası.

xForwardedForConfig

XForwardedForConfig

X-Forwarded- yapılandırması.

logConfig

LogConfig

Dinleyici için günlük yapılandırması.

aclConfig

AclConfig

Erişim kontrolü.

QuicConfig

Alan

Veri türü

Açıklama

quicUpgradeEnabled

bool

QUIC yükseltmeyi etkinleştirin. QUIC ve HTTPS dinleyicilerini ilişkilendirir veya ayırır. Bkz. HTTP/3'ü desteklemek için QUIC dinleyicileri kullanma.

  • true: QUIC yükseltmeyi etkinleştirir ve QUIC'i HTTPS ile ilişkilendirir.

  • false: QUIC yükseltmeyi devre dışı bırakır ve QUIC'i HTTPS ile ilişkilendirmez.

Varsayılan: false.

quicListenerId

string

QUIC dinleyicisiyle ilişkili HTTPS dinleyicisi.

Varsayılan: "".

Sertifika

Alan

Veri türü

Açıklama

IsDefault

bool

Bu sertifikayı varsayılan olarak ayarlayın. Bkz. Şifreli iletişim için HTTPS sertifikalarını yapılandırma.

  • true: Varsayılan olarak ayarlar.

  • false: Varsayılan olarak ayarlamaz.

Varsayılan: false.

Önemli

Yalnızca bir sertifikayı varsayılan olarak ayarlayabilirsiniz.

CertificateId

string

Sertifikanın CertIdentifier değeri.

Varsayılan: "".

XForwardedForConfig

Alan

Veri türü

Açıklama

XForwardedForClientCertSubjectDNEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Clientcert-subjectdn üstbilgisini ekler. İstemci sertifikası sahibi bilgilerini korur.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForProtoEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Proto üstbilgisini ekler. ALB dinleyici protokolünü kaydeder.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForClientCertIssuerDNEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Clientcert-issuerdn üstbilgisini ekler. İstemci sertifikası yayınlama bilgilerini korur.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForSLBIdEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-For-SLB-ID üstbilgisini ekler. ALB örnek kimliğini kaydeder.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForClientSrcPortEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Client-Port üstbilgisini ekler. İstemci bağlantı noktasını korur.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForClientCertFingerprintEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Clientcert-fingerprint üstbilgisini ekler. İstemci sertifikası parmak izini korur.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForEnabled

bool

Bir ALB örneği tarafından iletilen HTTP mesajlarının istek üstbilgilerine, istemcinin kaynak IP adresini korumak amacıyla X-Forwarded-For alanı eklenir. Bu özelliği değeri false olarak ayarlayarak devre dışı bırakamazsınız.

Bu özelliği devre dışı bırakmak veya gelişmiş işlevleri kullanmak için ALB Ingress Controller'ı 2.15.0 veya sonraki bir sürüme yükseltin ve XForwardedForProcessingMode kullanın.

XForwardedForProcessingMode

string

  • append: Orijinal istek bir X-Forwarded-For üstbilgisi içermiyorsa, ALB istemci IP adresiyle birlikte bir tane oluşturur. Aksi takdirde, ALB arka uç sunucusuna göndermeden önce mevcut X-Forwarded-For üstbilgisine istemci IP adresini ekler.

  • remove: ALB, isteği arka uç sunucusuna göndermeden önce X-Forwarded-For üstbilgisini kaldırır.

  • preserve: ALB, isteği arka uç sunucusuna göndermeden önce X-Forwarded-For üstbilgisinde değişiklik yapmaz.

XForwardedForConfig içinde hem XForwardedForEnabled hem de XForwardedForProcessingMode yapılandırılmışsa, XForwardedForProcessingMode öncelik kazanır. ALB örnek dinleyicisi, yapılandırılan değere göre X-Forwarded-For üstbilgisini ekler, kaldırır veya korur.

XForwardedForHostEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Host üstbilgisini ekler. İstemcinin ALB örneğine erişmek için kullandığı alan adını kaydeder.

XForwardedForSLBPortEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Port üstbilgisini ekler. ALB dinleyici bağlantı noktasını kaydeder.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForClientCertClientVerifyEnabled

bool

İletilen HTTP mesajlarına X-Forwarded-Clientcert-clientverify üstbilgisini ekler. İstemci sertifikası doğrulama sonucunu korur.

  • true: Alanı ekler.

  • false: Alanı eklemez.

Varsayılan: false.

XForwardedForClientCertSubjectDNAlias

string

XForwardedForClientCertSubjectDNEnabled tarafından eklenen X-Forwarded-Clientcert-subjectdn üstbilgisi için özel takma ad.

XForwardedForClientCertSubjectDNEnabled değerinin true olmasını gerektirir.

Varsayılan: "".

XForwardedForClientCertClientVerifyAlias

string

XForwardedForClientCertClientVerifyEnabled tarafından eklenen X-Forwarded-Clientcert-clientverify üstbilgisi için özel takma ad.

XForwardedForClientCertClientVerifyEnabled değerinin true olmasını gerektirir.

Varsayılan: "".

XForwardedForClientCertIssuerDNAlias

string

XForwardedForClientCertIssuerDNEnabled tarafından eklenen X-Forwarded-ClientCert-IssuerDN üstbilgisi için özel takma ad.

XForwardedForClientCertIssuerDNEnabled değerinin true olmasını gerektirir.

Varsayılan: "".

XForwardedForClientCertFingerprintAlias

string

XForwardedForClientCertFingerprintEnabled tarafından eklenen X-Forwarded-Client-Cert-Fingerprint üstbilgisi için özel takma ad.

XForwardedForClientCertFingerprintEnabled değerinin true olmasını gerektirir.

Varsayılan: "".

XForwardedForClientSourceIpsEnabled

bool

ALB'nin kaynak istemci IP'sini X-Forwarded-For üstbilgisinden bulmasına izin verir.

  • true: İzin ver. Ayrıca XForwardedForClientSourceIpsTrusted öğesini geçerli bir değerle yapılandırmanız gerekir.

  • false: İzin verme.

Varsayılan: false.

XForwardedForClientSourceIpsTrusted

string

Güvenilir proxy IP adreslerini belirtin.

Geçerli IP adreslerini veya CIDR bloklarını boşluk olmadan noktalı virgül (;) ile ayırarak belirtin. XForwardedForClientSourceIpsEnabled değerinin true olmasını gerektirir.

  • Güvenilir IP listesini 0.0.0.0/0 olarak ayarlayın: X-Forwarded-For üstbilgisindeki en soldaki adresi alır; bu, kaynak istemci IP adresidir.

  • Güvenilir IP listesini proxy1 IP; proxy2 IP,.. olarak ayarlayın: Listede olmayan ve en sağdan ilk adresi alır ve bunu kaynak istemci IP adresi olarak kullanır.

Örnek: 192.168.x.x;192.168.x.x/16

AclConfig

Alan

Veri türü

Açıklama

aclName

string

AclEntry modundaki ilişkili ACL ilkesinin adı. Bkz. Erişim kontrolü için ACL yapılandırma.

Varsayılan: "".

aclType

enum

Erişim kontrolü modu.

  • Black: Kara liste modu. Belirli IP adreslerinden gelen erişimi engeller.

  • White: Beyaz liste modu. Yalnızca belirli IP adreslerinden gelen erişime izin verir.

aclEntries

string

Erişim ilkesi girişleri.

Varsayılan: "".

Önemli

aclEntries ve aclIds öğelerini birlikte kullanmayın. Bkz. Erişim kontrolü için ACL yapılandırma.

aclIds

string

İlişkilendirilecek mevcut ilke kimliklerinin listesi.

Varsayılan: "".

LogConfig

Alan

Veri türü

Açıklama

accessLogRecordCustomizedHeadersEnabled

bool

ALB örneğinin erişim günlüklerinde özel üstbilgiler kullanın.

  • true: Özel üstbilgiler kullanır.

  • false: Özel üstbilgiler kullanmaz.

Varsayılan: false.

accessLogTracingConfig

AccessLogTracingConfig

Tracing Analysis yapılandırması. Bkz. AlbConfig ile Tracing Analysis için Xtrace'i etkinleştirme.

AccessLogTracingConfig

Alan

Veri türü

Açıklama

tracingEnabled

bool

Tracing Analysis'yi etkinleştirin.

  • true: Tracing Analysis'yi etkinleştirir.

  • false: Tracing Analysis'yi devre dışı bırakır.

Varsayılan: false.

tracingSample

int

Tracing Analysis örnek oranı, birim 0.01%.

Aralık: [1, 10000].

tracingType

enum

Tracing Analysis için örnekleme algoritması.

  • Zipkin: Zipkin algoritmasını kullanır.

AlbConfigStatus

Önemli

Aşağıdaki alanlar, durum kaydı için ALB Ingress tarafından ayrılmıştır. Bu alanları değiştirmeyin: AlbConfigStatus, LoadBalancerStatus, ListenerStatus ve AppliedCertificate.


Alan


Çıktı


Açıklama


loadBalancer


LoadBalancerStatus

Ayrılmış alan. Değiştirmeyin.

ALB örneğinin durumu.

LoadBalancerStatus


Alan


Çıktı


Açıklama


dnsname


string

Ayrılmış alan. Değiştirmeyin.

ALB örneğinin DNS adresi.


id


string

Ayrılmış alan. Değiştirmeyin.

ALB örneğinin kimliği.


listeners


ListenerStatus

Ayrılmış alan. Değiştirmeyin.

ALB örneğinin dinleyici özellikleri.

ListenerStatus


Alan


Çıktı


Açıklama


portAndProtocol


string

Ayrılmış alan. Değiştirmeyin.

Dinleyici tarafından kullanılan bağlantı noktası ve protokol.


certificates


AppliedCertificate

Ayrılmış alan. Değiştirmeyin.

Dinleyiciyle ilişkili sertifika.

AppliedCertificate


Alan


Çıktı


Açıklama


certificateId


string

Ayrılmış alan. Değiştirmeyin.

Sertifikanın CertIdentifier değeri.


isDefault


bool

Ayrılmış alan. Değiştirmeyin.

Sertifikanın varsayılan sertifika olup olmadığı.

Referanslar