Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Advanced ALB Ingress configurations

Son Güncelleme:Oct 06, 2026

Yönlendirme, HTTPS yönlendirmesi, sağlık kontrolleri ve kademeli sürüm yayınlama (canary) için ALB Ingress açıklamalarını yapılandırın.

Ön koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

Açıklama hızlı başvuru kılavuzu

ALB Ingress özellikleri, metadata.annotations alanındaki açıklamalarla yapılandırılır. Aşağıdaki tabloda desteklenen açıklamalar kategori bazında listelenmiştir.

Kategori Açıklama (Annotation) Açıklama
Sağlık kontrolü alb.ingress.kubernetes.io/healthcheck-enabled Sağlık kontrollerini etkinleştirin veya devre dışı bırakın
alb.ingress.kubernetes.io/healthcheck-path Sağlık kontrolü yolu
alb.ingress.kubernetes.io/healthcheck-protocol Protokol: HTTP, HTTPS, TCP, GRPC
alb.ingress.kubernetes.io/healthcheck-httpversion HTTP sürümü: HTTP1.0, HTTP1.1
alb.ingress.kubernetes.io/healthcheck-method Yöntem: HEAD, POST, GET
alb.ingress.kubernetes.io/healthcheck-code Beklenen durum kodu (healthcheck-httpcode öğesinden daha yüksek önceliğe sahiptir)
alb.ingress.kubernetes.io/healthcheck-httpcode Beklenen HTTP durum kodu (1,19'dan eski kümeler için)
alb.ingress.kubernetes.io/healthcheck-timeout-seconds Saniye cinsinden zaman aşımı (1–300)
alb.ingress.kubernetes.io/healthcheck-interval-seconds Saniye cinsinden kontrol aralığı (1–50)
alb.ingress.kubernetes.io/healthy-threshold-count Sunucunun sağlıklı olarak işaretlenmesi için gereken ardışık başarılı deneme sayısı (2–10)
alb.ingress.kubernetes.io/unhealthy-threshold-count Sunucunun sağlıksız olarak işaretlenmesi için gereken ardışık başarısız deneme sayısı (2–10)
alb.ingress.kubernetes.io/healthcheck-connect-port Sağlık kontrolleri için kullanılan bağlantı noktası (0 = arka uç bağlantı noktası)
TLS / HTTPS alb.ingress.kubernetes.io/ssl-redirect HTTP 80 bağlantı noktasından HTTPS 443 bağlantı noktasına yönlendirme yapın
Arka uç protokolü alb.ingress.kubernetes.io/backend-protocol Arka uç protokolü: https, grpc
Yol eşleşmesi alb.ingress.kubernetes.io/use-regex Yol kurallarında düzenli ifadeleri etkinleştirin
Yeniden yazma alb.ingress.kubernetes.io/rewrite-target İletmeden önce istek yolunu yeniden yazın
Dinleyici bağlantı noktaları alb.ingress.kubernetes.io/listen-ports Özel dinleyici bağlantı noktaları, örn. [{"HTTP": 80},{"HTTPS": 443}]
İletim önceliği alb.ingress.kubernetes.io/order İletim kuralı önceliği (1–1000; düşük değer = yüksek öncelik)
Kademeli sürüm yayınlama alb.ingress.kubernetes.io/canary Kademeli yönlendirmeyi etkinleştirin
alb.ingress.kubernetes.io/canary-by-header İstek üstbilgisi adına göre yönlendirin
alb.ingress.kubernetes.io/canary-by-header-value Tam üstbilgi değerine göre yönlendirin
alb.ingress.kubernetes.io/canary-by-cookie Çerez adına göre yönlendirin (always veya never)
alb.ingress.kubernetes.io/canary-weight Kademeli sürüme yönlendirilecek trafik yüzdesi (0–100)
Oturum kalıcılığı alb.ingress.kubernetes.io/sticky-session Oturum kalıcılığını etkinleştirin
alb.ingress.kubernetes.io/sticky-session-type Çerez modu: Insert veya Server
alb.ingress.kubernetes.io/cookie-timeout Saniye cinsinden çerez zaman aşımı (1–86400)
alb.ingress.kubernetes.io/cookie Özel çerez adı (tür Server ise gereklidir)
Yük dengeleme algoritması alb.ingress.kubernetes.io/backend-scheduler Algoritma: wrr, wlc, sch, uch
alb.ingress.kubernetes.io/backend-scheduler-uch-value uch karma işlemi için URL parametresi adı
CORS alb.ingress.kubernetes.io/enable-cors Kaynaklar Arası Kaynak Paylaşımını (CORS) etkinleştirin
alb.ingress.kubernetes.io/cors-allow-origin İzin verilen kaynaklar
alb.ingress.kubernetes.io/cors-allow-methods İzin verilen HTTP yöntemleri
alb.ingress.kubernetes.io/cors-allow-headers İzin verilen istek üstbilgileri
alb.ingress.kubernetes.io/cors-expose-headers Tarayıcıya gösterilen üstbilgiler
alb.ingress.kubernetes.io/cors-allow-credentials Kimlik bilgilerinin izin verilip verilmeyeceği
alb.ingress.kubernetes.io/cors-max-age Ön talep önbellekleme süresi saniye cinsinden (−1–172800)
Arka uç bağlantıları alb.ingress.kubernetes.io/backend-keepalive Kalıcı arka uç bağlantılarını etkinleştirin
Hız sınırlama alb.ingress.kubernetes.io/traffic-limit-qps İletim kuralı başına QPS sınırı (1–100.000)
Yavaş başlatma alb.ingress.kubernetes.io/slow-start-enabled Yeni pod'lar için yavaş başlatmayı etkinleştirin
alb.ingress.kubernetes.io/slow-start-duration Saniye cinsinden artış süresi (30–900)
Bağlantı boşaltma alb.ingress.kubernetes.io/connection-drain-enabled Bağlantı boşaltmayı etkinleştirin
alb.ingress.kubernetes.io/connection-drain-timeout Saniye cinsinden boşaltma zaman aşımı (0–900)

İstekleri etki alanı adlarına göre iletin

İstekleri etki alanı adına göre iletmek için bir Ingress oluşturun. ALB Ingress, standart ve boş etki alanı adlarını destekler.

Standart bir etki alanı adına göre istekleri iletin

Aşağıdaki örnekte yönlendirme yolu /hello olarak ayarlanmıştır. demo.domain.ingress.top/hello adresine yapılan istekler arka uç Hizmetine iletilir.

  1. Bir Hizmet, Dağıtım ve Ingress oluşturmak için aşağıdaki şablonu dağıtın. İstekler, Ingress içindeki etki alanı adı aracılığıyla Hizmet'e iletilir.

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

    1,19 ve sonraki sürüm kümeler için

    apiVersion: v1
    kind: Service
    metadata:
      name: demo-service
      namespace: default
    spec:
      ports:
        - name: port1
          port: 80
          protocol: TCP
          targetPort: 8080
      selector:
        app: demo
      sessionAffinity: None
      type: ClusterIP
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: demo
      namespace: default
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: demo
      template:
        metadata:
          labels:
            app: demo
        spec:
          containers:
            - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
              imagePullPolicy: IfNotPresent
              name: demo
              ports:
                - containerPort: 8080
                  protocol: TCP
    ---
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: demo
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - host: demo.domain.ingress.top
          http:
            paths:
              - backend:
                  service:
                    name: demo-service
                    port:
                      number: 80
                path: /hello
                pathType: ImplementationSpecific

    1,19'dan eski sürüm kümeler için

    apiVersion: v1
    kind: Service
    metadata:
      name: demo-service
      namespace: default
    spec:
      ports:
        - name: port1
          port: 80
          protocol: TCP
          targetPort: 8080
      selector:
        app: demo
      sessionAffinity: None
      type: ClusterIP
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: demo
      namespace: default
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: demo
      template:
        metadata:
          labels:
            app: demo
        spec:
          containers:
            - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
              imagePullPolicy: IfNotPresent
              name: demo
              ports:
                - containerPort: 8080
                  protocol: TCP
    ---
    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: demo
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - host: demo.domain.ingress.top
          http:
            paths:
              - backend:
                  serviceName: demo-service
                  servicePort: 80
                path: /hello
                pathType: ImplementationSpecific
  2. Yönlendirmeyi test edin. ADDRESS ifadesini ALB örneği etki alanı adıyla değiştirin (almak için kubectl get ing komutunu çalıştırın).

    curl -H "host: demo.domain.ingress.top" <ADDRESS>/hello

    Beklenen çıktı:

    {"hello":"coffee"}

Boş bir etki alanı adına göre istekleri iletin

host alanı boş bırakıldığında, Ingress etki alanından bağımsız olarak tüm istekleri eşleştirir. Aşağıdaki örnek, <ADDRESS>/hello adresine yapılan istekleri arka uç Hizmetine yönlendirir.

  1. Bir Ingress oluşturmak için aşağıdaki şablonu dağıtın.

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

    1,19 ve sonraki sürüm kümeler için

    apiVersion: v1
    kind: Service
    metadata:
      name: demo-service
      namespace: default
    spec:
      ports:
        - name: port1
          port: 80
          protocol: TCP
          targetPort: 8080
      selector:
        app: demo
      sessionAffinity: None
      type: ClusterIP
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: demo
      namespace: default
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: demo
      template:
        metadata:
          labels:
            app: demo
        spec:
          containers:
            - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
              imagePullPolicy: IfNotPresent
              name: demo
              ports:
                - containerPort: 8080
                  protocol: TCP
    ---
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: demo
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - host: ""
          http:
            paths:
              - backend:
                  service:
                    name: demo-service
                    port:
                      number: 80
                path: /hello
                pathType: ImplementationSpecific

    1,19'dan eski sürüm kümeler için

    apiVersion: v1
    kind: Service
    metadata:
      name: demo-service
      namespace: default
    spec:
      ports:
        - name: port1
          port: 80
          protocol: TCP
          targetPort: 8080
      selector:
        app: demo
      sessionAffinity: None
      type: ClusterIP
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: demo
      namespace: default
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: demo
      template:
        metadata:
          labels:
            app: demo
        spec:
          containers:
            - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
              imagePullPolicy: IfNotPresent
              name: demo
              ports:
                - containerPort: 8080
                  protocol: TCP
    ---
    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: demo
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - host: ""
          http:
            paths:
              - backend:
                  serviceName: demo-service
                  servicePort: 80
                path: /hello
                pathType: ImplementationSpecific
  2. Yönlendirmeyi test edin. ADDRESS ifadesini ALB örneği etki alanı adıyla değiştirin.

    curl <ADDRESS>/hello

    Beklenen çıktı:

    {"hello":"coffee"}

İstekleri URL yollarına göre iletin

ALB Ingress, istekleri pathType alanını kullanarak URL yollarına göre iletir. Üç eşleşme türü desteklenir:

**pathType** Davranış
Prefix Büyük/küçük harfe duyarlı olarak, segment segment yol ön ekini eşleştirir
Exact Yalnızca tam eşleşme
ImplementationSpecific ALB Ingress denetleyicisi tarafından tam eşleşme (Exact) olarak işlenir. path ayarlanmazsa, ALB varsayılan olarak / kullanır
Önemli

pathType değeri Exact veya Prefix olarak ayarlanırsa, path boş olmayan mutlak bir yol olmalıdır. Aksi takdirde, Ingress oluşturma işlemi doğrulama hatasıyla başarısız olur. Birden fazla URL eşleşme kuralı çakıştığında, ALB bunları iletim kuralı önceliğine göre değerlendirir.

Yol eşleşme referansı

Basit yollar (/, /foo, /foo/)

Eşleşme türü Kural yolu İstek yolu Eşleşti mi?
Prefix / / (tümünü eşleştirir) Evet
Prefix /foo /foo Evet
Prefix /foo /foo/ Evet
Prefix /foo/ /foo Evet
Prefix /foo/ /foo/ Evet
Prefix /aaa /ccc Hayır — ön ek eşleşmiyor
Exact veya ImplementationSpecific /foo /foo Evet
Exact veya ImplementationSpecific /foo /bar Hayır
Exact veya ImplementationSpecific /foo /foo/ Hayır
Exact veya ImplementationSpecific /foo/ /foo Hayır

Hiyerarşik yollar (/aaa/bb, /aaa/bbb, /aaa/bbb/)

Eşleşme türü Kural yolu İstek yolu Eşleşti mi?
Prefix /aaa/bb /aaa/bbb Hayır
Prefix /aaa/bbb /aaa/bbb Evet
Prefix /aaa/bbb/ /aaa/bbb Evet — kuraldaki sondaki eğik çizgi yok sayılır
Prefix /aaa/bbb /aaa/bbb/ Evet — istekteki sondaki eğik çizgi eşleşir
Prefix /aaa/bbb /aaa/bbb/ccc Evet — alt yol eşleşir

Birden fazla kural yolu

Eşleşme türü Kural yolları İstek yolu Eşleşti mi?
Prefix /, /aaa /aaa/ccc Evet — / ön ekiyle eşleşir
Prefix /aaa, / /aaa/ccc Evet — /aaa ön ekiyle eşleşir
Prefix /aaa, / /ccc Evet — / ön ekiyle eşleşir
Prefix /aaa, /bbb /ccc Hayır — ön ek eşleşmiyor

Ön ek eşleşmesi (Prefix)

Ön ek eşleştirme, / ile ayrılan yol segmentlerini büyük/küçük harfe duyarlı olarak karşılaştırır. Aşağıdaki örnekte kural yolu / olarak ayarlanmıştır; bu yol /hello dahil olmak üzere tüm yollarla eşleşir.

  1. Bir Ingress oluşturmak için aşağıdaki şablonu dağıtın.

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

    1,19 ve sonraki sürüm kümeler için

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: demo-path-prefix
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - http:
            paths:
            - path: /
              backend:
                service:
                  name: demo-service
                  port:
                    number: 80
              pathType: Prefix

    1,19'dan eski sürüm kümeler için

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: demo-path-prefix
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - http:
            paths:
            - path: /
              backend:
                serviceName: demo-service
                servicePort: 80
              pathType: Prefix
  2. Yönlendirmeyi test edin. ADDRESS ifadesini ALB örneği etki alanı adıyla değiştirin.

    curl <ADDRESS>/hello

    Beklenen çıktı:

    {"hello":"coffee"}

Tam eşleşme (Exact veya ImplementationSpecific)

Aşağıdaki örnekte kural yolu /hello olarak ayarlanmıştır. Yalnızca tam /hello yolu eşleşir.

  1. Bir Ingress oluşturmak için aşağıdaki şablonu dağıtın.

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

    1,19 ve sonraki sürüm kümeler için

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: demo-path
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - http:
            paths:
            - path: /hello
              backend:
                service:
                  name: demo-service
                  port:
                    number: 80
              pathType: Exact

    1,19'dan eski sürüm kümeler için

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      name: demo-path
      namespace: default
    spec:
      ingressClassName: alb
      rules:
        - http:
            paths:
            - path: /hello
              backend:
                serviceName: demo-service
                servicePort: 80
              pathType: Exact
  2. Yönlendirmeyi test edin. ADDRESS ifadesini ALB örneği etki alanı adıyla değiştirin.

    curl <ADDRESS>/hello

    Beklenen çıktı:

    {"hello":"coffee"}

HTTP'yi HTTPS'ye yönlendirin

HTTP isteklerini HTTPS 443 bağlantı noktasına yönlendirmek için alb.ingress.kubernetes.io/ssl-redirect: "true" açıklamasını ekleyin.

Önemli

Bu açıklama yalnızca dinleyici bağlantı noktası 80 üzerindeki HTTP iletim kuralları için geçerlidir. Bu özellik yalnızca RemoveHeader, InsertHeader ve çapraz alan CORS açıklamalarıyla birlikte çalışır. Bu açıklamayı eklemeden önce AlbConfig içinde 443 bağlantı noktasında bir HTTPS dinleyicisi yapılandırın.

Kubernetes 1,19 veya sonraki sürümleri çalıştıran kümeler

apiVersion: v1
kind: Service
metadata:
  name: demo-service-ssl
  namespace: default
spec:
  ports:
    - name: port1
      port: 80
      protocol: TCP
      targetPort: 8080
  selector:
    app: demo-ssl
  sessionAffinity: None
  type: ClusterIP
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-ssl
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-ssl
  template:
    metadata:
      labels:
        app: demo-ssl
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
          imagePullPolicy: IfNotPresent
          name: demo-ssl
          ports:
            - containerPort: 8080
              protocol: TCP
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
  namespace: default
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - ssl.alb.ingress.top
  rules:
    - host: ssl.alb.ingress.top
      http:
        paths:
          - backend:
              service:
                name: demo-service-ssl
                port:
                  number: 80
            path: /
            pathType: Prefix

Kubernetes'in 1,19'dan eski sürümlerini çalıştıran kümeler

apiVersion: v1
kind: Service
metadata:
  name: demo-service-ssl
  namespace: default
spec:
  ports:
    - name: port1
      port: 80
      protocol: TCP
      targetPort: 8080
  selector:
    app: demo-ssl
  sessionAffinity: None
  type: ClusterIP
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-ssl
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-ssl
  template:
    metadata:
      labels:
        app: demo-ssl
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
          imagePullPolicy: IfNotPresent
          name: demo-ssl
          ports:
            - containerPort: 8080
              protocol: TCP
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
  namespace: default
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - ssl.alb.ingress.top
  rules:
    - host: ssl.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: demo-service-ssl
              servicePort: 80
            path: /
            pathType: Prefix

Sağlık kontrollerini yapılandırın

Arka uç sunucu grubu için sağlık kontrollerini aşağıdaki açıklamalarla yapılandırın.

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

Arka uç sunucu grubu için sağlık kontrollerini etkinleştirmek ve yapılandırmak için aşağıdaki açıklamaları ekleyin.

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"
spec:
  ...

1,19 ve sonraki sürüm kümeler için

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"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      - path: /coffee
        pathType: ImplementationSpecific
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
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-method: "HEAD"
    alb.ingress.kubernetes.io/healthcheck-httpcode: "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"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /tea
        backend:
          serviceName: tea-svc
          servicePort: 80
      - path: /coffee
        backend:
          serviceName: coffee-svc
          servicePort: 80

Açıklama referansı:

Açıklama Açıklama Varsayılan
alb.ingress.kubernetes.io/healthcheck-enabled Sağlık kontrollerini etkinleştirin: true veya false false
alb.ingress.kubernetes.io/healthcheck-path Sağlık kontrolü yolu /
alb.ingress.kubernetes.io/healthcheck-protocol Protokol: HTTP, HTTPS, TCP veya GRPC. HTTP/HTTPS HEAD veya GET kullanır; TCP SYN kullanır; gRPC POST veya GET kullanır HTTP
alb.ingress.kubernetes.io/healthcheck-httpversion HTTP sürümü: HTTP1.0 veya HTTP1.1. HTTP ve HTTPS protokolleri için geçerlidir HTTP1.1
alb.ingress.kubernetes.io/healthcheck-method İstek yöntemi: HEAD, POST veya GET. Protokol GRPC olduğunda POST veya GET kullanın HEAD
alb.ingress.kubernetes.io/healthcheck-code Beklenen durum kodları. healthcheck-httpcode öğesinden daha yüksek önceliğe sahiptir. HTTP/HTTPS için: http_2xx, http_3xx, http_4xx, http_5xx (virgülle ayrılmış). gRPC için: [0, 99] aralığında tamsayı aralıkları (en fazla 20 aralık, virgülle ayrılmış) HTTP/HTTPS: http_2xx; gRPC: 0
alb.ingress.kubernetes.io/healthcheck-httpcode 1,19'dan eski kümeler için beklenen durum kodları. Seçenekler: http_2xx, http_3xx, http_4xx, http_5xx (virgülle ayrılmış) http_2xx
alb.ingress.kubernetes.io/healthcheck-timeout-seconds Saniye cinsinden zaman aşımı. Aralık: [1, 300] 5
alb.ingress.kubernetes.io/healthcheck-interval-seconds Saniye cinsinden kontrol aralığı. Aralık: [1, 50] 2
alb.ingress.kubernetes.io/healthy-threshold-count Bir arka uç sunucusunun sağlıklı olarak işaretlenmesi için gereken ardışık başarılı deneme sayısı. Aralık: [2, 10] 3
alb.ingress.kubernetes.io/unhealthy-threshold-count Bir arka uç sunucusunun sağlıksız olarak işaretlenmesi için gereken ardışık başarısız deneme sayısı. Aralık: [2, 10] 3
alb.ingress.kubernetes.io/healthcheck-connect-port Sağlık kontrolü bağlantı noktası. 0 arka uç sunucu bağlantı noktasını kullanır 0

Arka uç protokolleri olarak HTTPS ve gRPC kullanın

Arka uç protokolü olarak HTTPS veya gRPC kullanmak için alb.ingress.kubernetes.io/backend-protocol açıklamasını ekleyin.

Ingress oluşturulduktan sonra arka uç protokolü değiştirilemez. Protokolleri değiştirmek için Ingress'i silin ve yeni bir tane oluşturun.
Önemli

Ingress üzerinden gRPC trafiğini iletirken, etki alanı adı için bir TLS sertifikası yapılandırın ve iletişim için TLS kullanın.

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: grpc-demo-svc
            port:
              number: 9080

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: grpc-demo-svc
              servicePort: 9080
            path: /
            pathType: Prefix
Açıklama Değerler Açıklama
alb.ingress.kubernetes.io/backend-protocol https Arka uç Hizmeti HTTPS kullanır
grpc Arka uç Hizmeti gRPC kullanır. Etki alanı adı üzerinde TLS yapılandırması gerektirir

Düzenli ifadeleri yapılandırın

Yol kurallarında düzenli ifade eşleştirmesini etkinleştirmek için alb.ingress.kubernetes.io/use-regex: "true" açıklamasını kullanın. Bu açıklama yalnızca pathType: Prefix olan yol kuralları için geçerlidir.

Açıklama Açıklama
alb.ingress.kubernetes.io/use-regex: "true" Yol kurallarında düzenli ifadeleri etkinleştirir
alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME> Özel iletim koşullarını yapılandırır. <YOUR-SVC-NAME> ifadesini gerçek Hizmet adıyla değiştirin; bu ad backend.service.name ile eşleşmelidir

Düzenli ifade eşleştirme kuralları:

Hedef Ön ek Kural örneği İstemci yolu Eşleşti mi? Notlar
Etki alanı adı ~ ile başlar ~test.example.com test.EXAMPLE.com Evet Etki alanı adları büyük/küçük harfe duyarsız eşleştirmeyi destekler
Yol ~ ile başlar ~/api /API Evet Büyük/küçük harfe duyarsız eşleştirme
Yol ~* ile başlar ~*/api /Api Hayır Büyük/küçük harfe duyarlı eşleştirme

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"  # Enables regular expression matching
   alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME>: | # Replace <YOUR-SVC-NAME> with the Service name — must match backend.service.name
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*/pathvalue1", # ~* = case-sensitive regex; ~ = case-insensitive regex
              "/pathvalue2"    # No prefix needed for exact match
           ]
       }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
   - http:
      paths:
      - path: /test-path-for-alb
        pathType: Prefix
        backend:
          service:
            name: <YOUR-SVC-NAME> # Must match the service name in the annotation above
            port:
              number: 88

Yeniden yazmaları yapılandırın

ALB Ingress, istekleri iletmeden önce istek yolunu yeniden yazar. İki açıklama yeniden yazma davranışını kontrol eder:

  • alb.ingress.kubernetes.io/rewrite-target: /<path>/${number} — yeniden yazmayı etkinleştirir ve hedef yolu ayarlar. Orijinal yoldan bir yakalama grubuna referans vermek için ${number} biçimini kullanın (en fazla üç grup: ${1}, ${2}, ${3}). pathType değeri Prefix olmalıdır.

  • alb.ingress.kubernetes.io/use-regex — yolda düzenli ifadelerin kullanılıp kullanılmayacağını belirtir. rewrite-target yapılandırıldığında otomatik olarak etkinleştirilir. Devre dışı bırakmak için "false" olarak ayarlayın; regex devre dışı bırakıldığında özel karakterler içeren yolların (%#;!()[]^,"\") oluşturulamayacağını unutmayın.

Senaryo 1: Bir öneki kaldırın

path: /something(/|$)(.*) yolu üç yakalama grubu kullanır:

  • /something — kaldırılacak ön eki eşleştirir

  • (/|$) — ilk grup: / veya yol sonunu eşleştirir

  • (.*) — ikinci grup: /something/ sonrası her şeyi yakalar ve yeniden yazma hedefinde ${2} olarak referans verilir

Yeniden yazma hedefi / + ${2}, /something ön ekini kaldırır:

Orijinal yol Eşleşti mi? Yeniden yazılan yol
/something Evet (ikinci grup boştur) /
/something/ Evet (ikinci grup boştur) /
/something/new Evet (ikinci grup: new) /new
/something-new/item Hayır 503
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"
    alb.ingress.kubernetes.io/rewrite-target: /${2}
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /something(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

Senaryo 2: Birden çok bölümü yakalayın ve yeniden düzenleyin

/items/(.*)/(.*)/(.*) yolu üç segmenti yakalar. Yeniden yazma hedefi /${2}?code=${3} URL'yi ikinci ve üçüncü grupları kullanarak yeniden yapılandırır.

Bu desen tam olarak dört yol segmenti gerektirir. İstemciler sabit bir yol biçimi kullanmalıdır.
Orijinal yol Eşleşti mi? Yeniden yazılan yol
/items/electronics/computers/554 Evet (grup 2: computers, grup 3: 554) /computers?code=554
/items/produce/fruits/12 Evet (grup 2: fruits, grup 3: 12) /fruits?code=12
/items/headphones/5 Hayır 503
/drinks/41 Hayır 503
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"
    alb.ingress.kubernetes.io/rewrite-target: /${2}?code=${3}
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /items/(.*)/(.*)/(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

Senaryo 3: Birden çok yolu tek bir yola yeniden yazın

Aşağıdaki örnek, aynı yeniden yazma hedefi /${2} → /app-c/${2} ile iki yol kuralı tanımlayarak hem /app-a hem de /app-b yollarını /app-c yoluna yönlendirir.

Orijinal yol Eşleşti mi? Yeniden yazılan yol
/app-a/item1 Evet (grup 2: item1) /app-c/item1
/app-a/item2 Evet (grup 2: item2) /app-c/item2
/app-a veya /app-a/ Evet (grup 2 boştur) /app-c/
/drinks/41 Hayır 503
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"
    alb.ingress.kubernetes.io/rewrite-target: /app-c/${2}
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /app-a(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080
      - path: /app-b(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

Senaryo 4: Bir etki alanı adını yeniden yazın

rewrite-target açıklaması yalnızca yolu değiştirir. Etki alanı adı veya sorgu parametreleri gibi URL'nin diğer bölümlerini yeniden yazmak için özel iletim kurallarını kullanın.

Yeniden yazma kurallarını yerel olarak doğrulayın

Dağıtmadan önce yol regex eşleşmelerini test etmek ve yeniden yazılan sonuçları önizlemek için sed kullanın.

Aşağıdaki örnek, Senaryo 2 içindeki /items/(.*)/(.*)/(.*) yol regex'ini ve /${2}?code=${3} yeniden yazma kuralını test eder.

  1. Test yollarını path2.txt dosyasına kaydedin:

    /items/electronics/computers/554
    /items/produce/fruits/12
    /items/headphones/5
    /drinks/41
  2. sed ile yeniden yazmayı simüle edin. Yol regex'inde / karakterini \/ olarak kaçış karakteriyle yazın ve yakalama grupları için ${2} yerine \2 kullanın:

    sed -E 's#\/items\/(.*)\/(.*)\/(.*)#Matched: [&]  --->  Rewritten: [/\2?code=\3]#' path2.txt

    Beklenen çıktı — ilk iki yol yeniden yazma kuralıyla eşleşir; son ikisi eşleşmez:

    Matched: [/items/electronics/computers/554]  --->  Rewritten: [/computers?code=554]
    Matched: [/items/produce/fruits/12]  --->  Rewritten: [/fruits?code=12]
    /items/headphones/5
    /drinks/41

Özel dinleyici bağlantı noktalarını yapılandırın

Bir Hizmeti HTTP 80 ve HTTPS 443 gibi birden çok bağlantı noktasında göstermek için alb.ingress.kubernetes.io/listen-ports açıklamasını kullanın.

Önemli

ALB, Ingress'ten dinleyiciler oluşturmaz. Önce AlbConfig içinde gerekli dinleyici bağlantı noktalarını ve protokollerini oluşturun, ardından bunları Ingress ile ilişkilendirin.

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
   alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
  name: cafe-ingress
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific
Açıklama Açıklama
alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]' Hizmetin hem 80 hem de 443 bağlantı noktasını dinlemesini yapılandırır

İletim kuralı önceliğini yapılandırın

Varsayılan olarak, ALB iletim kurallarını aşağıdaki sıraya göre sıralar:

  • Ingress'ler arasında: namespace/name leksikografik olarak sıralanır. Daha küçük değerler daha yüksek önceliğe sahiptir. Önce ad alanı, sonra ad karşılaştırılır.

  • Aynı Ingress içinde: rules alanındaki sıraya göre sıralanır. Daha önce listelenen kurallar daha yüksek önceliğe sahiptir.

    rules:
      - host: www.example.com   # Higher priority
        http: ...
      - host: www.test.com      # Lower priority
        http: ...

Ingress'i yeniden adlandırmadan varsayılan sıralama düzenini geçersiz kılmak için alb.ingress.kubernetes.io/order açıklamasını kullanın.

Önemli

Aynı dinleyici içindeki öncelikler benzersiz olmalıdır.

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
   alb.ingress.kubernetes.io/order: "2"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "2"
  name: cafe-ingress
spec:
  ingressClassName: alb
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific
Açıklama Aralık Varsayılan Açıklama
alb.ingress.kubernetes.io/order [1, 1000] 10 İletim kuralı önceliği. Daha düşük değerler daha yüksek önceliğe sahiptir

Açıklamalar kullanarak kademeli sürüm yayınlama uygulayın

ALB, istek üstbilgilerine, çerezlere ve trafik ağırlıklarına dayalı kademeli sürüm yayınlamayı destekler. Üretim Ingress'inin yanına ayrı bir kademeli Ingress oluşturun.

Canary routing priority: Üstbilgi > Çerez > Ağırlık (yüksekten düşüğe).

Önemli

Kademeli sürüm yayınlama sırasında üretim Ingress'ini silmeyin. Kademeli sürüm yayınlama doğrulandıktan sonra, üretim Ingress'indeki arka uç Hizmetini yeni sürüme yönlendirecek şekilde güncelleyin ve ardından kademeli Ingress'i silin.

Bkz. ALB Ingress aracılığıyla aşamalı yayınlamaları uygulayın.

Üstbilgiye göre yönlendirin

Belirli bir üstbilgi değeriyle eşleşen istekleri kademeli Hizmete yönlendirmek için canary-by-header ve canary-by-header-value birlikte kullanın. Eşleşmeyen istekler bir sonraki kademeli kurala (çerez veya ağırlık) düşer.

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    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"
  name: demo-canary
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-hello
                port:
                  number: 80
            path: /hello
            pathType: ImplementationSpecific

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    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"
  name: demo-canary
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              serviceName: demo-service-hello
              servicePort: 80
            path: /hello
            pathType: ImplementationSpecific

Bu yapılandırmayla, location: hz içeren istekler kademeli Hizmete yönlendirilir. Diğer tüm istekler bir sonraki kademeli kurala düşer.

Açıklama Açıklama
alb.ingress.kubernetes.io/canary-by-header Eşleştirilecek istek üstbilgisi adı
alb.ingress.kubernetes.io/canary-by-header-value Eşleştirilecek tam üstbilgi değeri. Her iki açıklama da birlikte yapılandırılmalıdır

Çereze göre yönlendirin

İstekleri bir çerez adına göre yönlendirmek için canary-by-cookie kullanın. Çerez değerini her zaman kademeli Hizmete yönlendirmek için always veya hariç tutmak için never olarak ayarlayın.

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "2"
    alb.ingress.kubernetes.io/canary: "true"
    alb.ingress.kubernetes.io/canary-by-cookie: "demo"
  name: demo-canary-cookie
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-hello
                port:
                  number: 80
            path: /hello
            pathType: ImplementationSpecific

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "2"
    alb.ingress.kubernetes.io/canary: "true"
    alb.ingress.kubernetes.io/canary-by-cookie: "demo"
  name: demo-canary-cookie
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              serviceName: demo-service-hello
              servicePort: 80
            path: /hello
            pathType: ImplementationSpecific

Bu yapılandırmayla, Cookie: demo=always içeren istekler kademeli Hizmete yönlendirilir. Cookie: demo=never içeren istekler kademeli Hizmeti tamamen atlar.

Açıklama Değerler Açıklama
alb.ingress.kubernetes.io/canary-by-cookie always Tüm istekler kademeli Hizmete yönlendirilir
never Hiçbir istek kademeli Hizmete yönlendirilmez

Çerez tabanlı kademeli yönlendirme yalnızca always ve never değerlerini destekler. Özel çerez değerleri desteklenmez.

Ağırlığa göre yönlendirin

Trafiğin bir yüzdesini kademeli Hizmete göndermek için canary-weight kullanın. Aşağıdaki örnek, trafiğin %50'sini kademeli sürüme yönlendirir:

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "3"
    alb.ingress.kubernetes.io/canary: "true"
    alb.ingress.kubernetes.io/canary-weight: "50"
  name: demo-canary-weight
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-hello
                port:
                  number: 80
            path: /hello
            pathType: ImplementationSpecific

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "3"
    alb.ingress.kubernetes.io/canary: "true"
    alb.ingress.kubernetes.io/canary-weight: "50"
  name: demo-canary-weight
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              serviceName: demo-service-hello
              servicePort: 80
            path: /hello
            pathType: ImplementationSpecific
Açıklama Aralık Açıklama
alb.ingress.kubernetes.io/canary-weight 0–100 Kademeli Hizmete yönlendirilen isteklerin yüzdesi

Açıklamalar kullanarak oturum kalıcılığı uygulayın

ALB Ingress, çerez tabanlı oturum kalıcılığını destekler. Etkinleştirmek ve yapılandırmak için aşağıdaki açıklamaları ekleyin.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress-v3
  annotations:
    alb.ingress.kubernetes.io/sticky-session: "true"
    alb.ingress.kubernetes.io/sticky-session-type: "Insert"   # Use "Server" for custom cookies
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
  ...

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress-v3
  annotations:
    alb.ingress.kubernetes.io/sticky-session: "true"
    alb.ingress.kubernetes.io/sticky-session-type: "Insert"   # Use "Server" for custom cookies
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - backend:
          service:
            name: tea-svc
            port:
              number: 80
        path: /tea2
        pathType: ImplementationSpecific
      - backend:
          service:
            name: coffee-svc
            port:
              number: 80
        path: /coffee2
        pathType: ImplementationSpecific

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: cafe-ingress-v3
  annotations:
    alb.ingress.kubernetes.io/sticky-session: "true"
    alb.ingress.kubernetes.io/sticky-session-type: "Insert"  # Use "Server" for custom cookies
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /tea2
        pathType: ImplementationSpecific
        backend:
          serviceName: tea-svc
          servicePort: 80
      - path: /coffee2
        pathType: ImplementationSpecific
        backend:
          serviceName: coffee-svc
          servicePort: 80
Açıklama Açıklama Varsayılan
alb.ingress.kubernetes.io/sticky-session Oturum kalıcılığını etkinleştirin: true veya false false
alb.ingress.kubernetes.io/sticky-session-type Çerez işleme modu. Insert: ALB, sonraki istekleri aynı arka uca yönlendirmek için bir SERVERID çerezi ekler. Server: ALB, yönlendirme için özel bir çerezi yeniden yazar. Sunucu grubunda StickySessionEnabled değerinin true olarak ayarlanmasını gerektirir. Bkz. Sunucu grubu oluşturma Insert
alb.ingress.kubernetes.io/cookie-timeout Saniye cinsinden çerez zaman aşımı. Aralık: [1, 86400]. sticky-session-type değeri Insert olduğunda geçerlidir 1000
alb.ingress.kubernetes.io/cookie Özel çerez adı. sticky-session-type değeri Server olduğunda gereklidir ve boş bırakılamaz ""

Bir yük dengeleme algoritması belirtin

Bir arka uç sunucu grubu için yük dengeleme algoritmasını ayarlamak üzere alb.ingress.kubernetes.io/backend-scheduler açıklamasını kullanın.

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

1,19 ve sonraki sürüm kümeler için

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch"
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # Required only for uch
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

1,19'dan eski sürüm kümeler için

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch"
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # Required only for uch
  name: cafe-ingress
spec:
  ingressClassName: alb
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific
Değer Algoritma Açıklama
wrr Ağırlıklı döngüsel sıralama Daha yüksek ağırlığa sahip arka uç sunucuları daha fazla istek alır. Varsayılan algoritma
wlc Ağırlıklı en az bağlantı Sunucu ağırlığına göre ağırlıklandırılmış, en az aktif bağlantısı olan sunucuya yönlendirir
sch Kaynak IP tutarlı karma Aynı istemci IP'sinden gelen istekleri aynı arka uç sunucusuna yönlendirir
uch URL parametresi tutarlı karma URL parametresi karmasına göre yönlendirir. Parametre adını alb.ingress.kubernetes.io/backend-scheduler-uch-value ile ayarlayın

Kaynaklar arası kaynak paylaşımını yapılandırın

Tarayıcıların Hizmete çapraz kaynak istekleri yapmasına izin vermek için CORS açıklamaları ekleyin.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-cors: "true"
    alb.ingress.kubernetes.io/cors-expose-headers: ""
    alb.ingress.kubernetes.io/cors-allow-methods: "GET,POST"
    alb.ingress.kubernetes.io/cors-allow-credentials: "true"
    alb.ingress.kubernetes.io/cors-max-age: "600"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: cloud-nodeport
            port:
              number: 80
Açıklama Açıklama Varsayılan
alb.ingress.kubernetes.io/cors-allow-origin İzin verilen kaynaklar. http:// veya https:// ile başlamalı, ardından geçerli bir etki alanı veya üst düzey joker karakterli etki alanı gelmelidir. Birden çok kaynağı virgülle ayırın. Örnek: "https://example.com:4443, http://aliyundoc.com, https://example.org:1199" *
alb.ingress.kubernetes.io/cors-allow-methods İzin verilen çapraz kaynak yöntemleri. Büyük/küçük harfe duyarsız. Birden çok yöntemi virgülle ayırın. Örnek: "PUT, GET, POST, OPTIONS" GET, PUT, POST, DELETE, PATCH, OPTIONS
alb.ingress.kubernetes.io/cors-allow-headers İzin verilen istek üstbilgileri. Üstbilgiler harf, rakam, alt çizgi (_) ve kısa çizgi (-) içerebilir. Birden çok üstbilgiyi virgülle ayırın. Örnek: "X-Forwarded-For, X-app123-XPTO" DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization
alb.ingress.kubernetes.io/cors-expose-headers Tarayıcıya gösterilen üstbilgiler. Harf, rakam, alt çizgi (_), kısa çizgi (-) ve yıldız işareti (*) içerebilir. Birden çok üstbilgiyi virgülle ayırın. Örnek: "*, X-CustomResponseHeader" Boş
alb.ingress.kubernetes.io/cors-allow-credentials Çapraz kaynak isteklerinde kimlik bilgilerine izin verilip verilmeyeceği. Örnek: "false" true
alb.ingress.kubernetes.io/cors-max-age OPTIONS ön talep yanıtları için maksimum önbellekleme süresi saniye cinsinden. Aralık: [−1, 172800] 172800

Kalıcı arka uç bağlantılarını etkinleştirin

Kalıcı arka uç bağlantıları, arka uç sunucularıyla olan TCP bağlantılarını yeniden kullanarak istek başına bağlantı açma ve kapatma ek yükünü azaltır.

Bu özelliği etkinleştirmek için alb.ingress.kubernetes.io/backend-keepalive: "true" açıklamasını ekleyin:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-keepalive: "true"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: cloud-nodeport
            port:
              number: 80

QPS hız sınırlarını ayarlayın

İletim kuralı düzeyinde QPS kısıtlaması ayarlamak için alb.ingress.kubernetes.io/traffic-limit-qps açıklamasını ekleyin:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/traffic-limit-qps: "50"
spec:
  ingressClassName: alb
  rules:
   - host: demo.alb.ingress.top
     http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      - path: /coffee
        pathType: ImplementationSpecific
        backend:
          service:
            name: coffee-svc
            port:
              number: 80
Açıklama Aralık Açıklama
alb.ingress.kubernetes.io/traffic-limit-qps [1, 100.000] İletim kuralı için maksimum QPS

Yeni pod'lar için yavaş başlatmayı yapılandırın

Yavaş başlatma, yapılandırılan süre boyunca yeni pod'lara giden trafiği kademeli olarak artırarak soğuk bir poda tam trafikin binmesinden kaynaklanan geçici CPU veya bellek artışlarını önler.

Açıklama Açıklama Varsayılan
alb.ingress.kubernetes.io/slow-start-enabled Yavaş başlatmayı etkinleştirin: true veya false false
alb.ingress.kubernetes.io/slow-start-duration Saniye cinsinden artış süresi. Daha uzun süreler trafik artışını yavaşlatır. Aralık: [30, 900] 30

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/slow-start-enabled: "true"
    alb.ingress.kubernetes.io/slow-start-duration: "100"
  name: alb-ingress
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Bağlantı boşaltmayı yapılandırın

Bir pod Terminating durumuna geçtiğinde, ALB onu arka uç sunucu grubundan kaldırır. Bağlantı boşaltma olmadan, mevcut bağlantılardaki devam eden istekler başarısız olabilir.

Bağlantı boşaltma, aktif bağlantıları yapılandırılan bir süre boyunca açık tutarak pod çevrimdışı duruma geçmeden önce devam eden isteklerin tamamlanmasına olanak tanır.

Önemli

Boşaltma zaman aşımı bitmeden önce, ALB pod'un sağlıklı kalacağını garanti edemez. Terminating durumu sırasında pod kullanılabilirliğini kontrol etmek için pod üzerinde spec.terminationGracePeriodSeconds yapılandırın veya preStop hook kullanın.

Bkz. ALB bağlantı boşaltma yoluyla sorunsuz iş çevrimdışı olma sağlayın.

Açıklama Açıklama Varsayılan
alb.ingress.kubernetes.io/connection-drain-enabled Bağlantı boşaltmayı etkinleştirin: true veya false false
alb.ingress.kubernetes.io/connection-drain-timeout Bir pod kaldırıldıktan veya sağlık kontrolünden başarısız olduktan sonra ALB'nin bağlantıları kapatmadan önce beklediği maksimum süre saniye cinsinden. Aralık: [0, 900] 300

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/connection-drain-enabled: "true"
    alb.ingress.kubernetes.io/connection-drain-timeout: "199"
  name: alb-ingress
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: