Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Customize ALB Ingress forwarding rules using console or annotations

Son Güncelleme:Oct 06, 2026

ALB Ingress, yerel Kubernetes Ingress'i özel yönlendirme kurallarıyla genişletir. İstek üstbilgisi, sorgu dizesi, istek yöntemi, çerez ve kaynak IP gibi koşulları belirtmenize ve sabit yanıt, yeniden yönlendirme veya trafik yansıtma gibi özel yönlendirme eylemleri tanımlamanıza olanak tanır. Bu özel yönlendirme kurallarının bir kısmı konsolda yapılandırılabilir.

Nasıl çalışır

ALB özel yönlendirme kuralları, hem istekler hem de yanıtlar için ayrıntılı trafik kontrolü sağlayan yönlendirme koşulları ve yönlendirme eylemlerinden oluşur:

  • Yönlendirme koşulu: alb.ingress.kubernetes.io/conditions.<service_name> ek açıklaması kullanılarak yapılandırılır. Bu koşul, adıyla bir arka uç Service ile ilişkilendirilir ve Ingress içindeki o Service'e yönlendiren tüm yollar için geçerlidir. Yalnızca koşulu karşılayan trafik ilgili eylemi tetikler. Koşul, hem istek hem de yanıt yönündeki trafiği eşleştirebilir.

  • Yönlendirme eylemi: alb.ingress.kubernetes.io/actions.<service_name> ek açıklaması kullanılarak yapılandırılır. Bir ALB örneğinin istek veya yanıtı işlerken gerçekleştireceği belirli davranışı (trafiği yönlendirme veya yeniden yönlendirme yayınlama gibi) tanımlar.

  • Kural yönü: Özel bir yönlendirme kuralının istek mi yoksa yanıt yönüne mi uygulanacağını belirtmek için alb.ingress.kubernetes.io/rule-direction.<service_name> ek açıklamasını kullanın:

    • İstek yönü: Bir istemci isteği ALB Ingress üzerinden bir arka uç Service'e iletilir.

    • Yanıt yönü: Bir arka uç Service yanıtı ALB Ingress üzerinden tekrar istemciye iletilir.

    • Aynı yön için hem bir yönlendirme koşulu hem de bir yönlendirme eylemi yapılandırıldığında, eylem yalnızca yönlendirme koşulunu karşılayan trafik için tetiklenir.

Önemli

alb.ingress.kubernetes.io/rule-direction.<service_name> ek açıklaması mevcut Ingress kaynağı içindeki tüm yapılandırmalara uygulandığından, istek ve yanıt yönleri için yönlendirme kurallarını ayrı Ingress kaynaklarında yapılandırın. Yapılandırma örneği için bkz. Senaryo 7: ResponseHeader'a göre yanıt üstbilgilerini değiştirme.

Önkoşullar

Bileşeni yükleyin

ALB Ingress Denetleyicisini yükleyin veya yüklü sürümün v2.5.0 ya da daha yeni olduğundan emin olun.

Örnek bir Service oluşturun

Aşağıdaki örneği echoserver.yaml adlı bir dosyaya kopyalayın ve örnek bir Deployment ile Service oluşturmak için kubectl apply -f echoserver.yaml komutunu çalıştırın. Bu örnek, alınan istekleri yansıtan bir echoserver görüntüsü kullanır. ALB özel yönlendirme kurallarınızı doğrulamak için bu kurulumu kullanabilirsiniz.

Önemli

Bu konuda kullanılan örnek görüntüler genel görüntülerdir. Bunları çekmek için kümenizin veya düğümlerinizin genel ağ erişimine sahip olması gerekir:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: echoserver
  labels:
    app: echoserver
spec:
  replicas: 2
  selector:
    matchLabels:
      app: echoserver
  template:
    metadata:
      labels:
        app: echoserver
    spec:
      containers:
      - name: echoserver
        image: openkruise-registry.cn-shanghai.cr.aliyuncs.com/openkruise/demo:1.10.2
        imagePullPolicy: IfNotPresent
        ports:
        - containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: echoserver
  labels:
    app: echoserver
spec:
  type: ClusterIP
  ports:
  - port: 80
    targetPort: 8080
    protocol: TCP
    name: http
  selector:
    app: echoserver

Yönlendirme koşullarını yapılandırın

Önemli

ACK konsolunda bir Ingress oluşturduktan ve yol tabanlı yönlendirme koşullarını ayarladıktan sonra, ACK biçim gereksinimlerini karşılamak amacıyla Ingress'e /created-by-<ALB-ID> yoluna sahip iki yönlendirme kuralı otomatik olarak ekler.

Senaryo 1: Kaynak IP ve istek üstbilgisine göre yönlendirme

Önemli

Tek bir özel yönlendirme kuralı için en fazla beş kaynak IP belirtebilirsiniz.

Aşağıdaki örnekte, ALB yalnızca istediğin kaynak IP'si, istek üstbilgisi ve yolu belirtilen koşullarla eşleşiyorsa isteği arka uç hizmetine iletir.

sourceip-header.yaml dosyasını oluşturun ve aşağıdaki örneği içine kopyalayın, ardından Ingress'i oluşturmak için kubectl apply -f sourceip-header.yaml komutunu çalıştırın.

  • İstemci IP'si: 192.168.0.0/16 veya 10.0.0.0/8 ile eşleşir.

  • İstek üstbilgisi headername:headervalue1 veya headername:headervalue2 içerir.

  • Yol: /echo kullanın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/conditions.echoserver: | # The name echoserver must match the name of the backend Service configured in spec.rules.
     [{
       "type": "Header",
       "headerConfig": {
         "key": "headername",
         "values": [
           "headervalue1",
           "headervalue2"
         ]
       }
     },
     {
      "type": "SourceIp",
      "sourceIpConfig": {
        "values": [
          "192.168.0.0/16",
          "10.0.0.0/8"
         ]
       }
     }]
  name: sourceip-header-ingress
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              number: 80

Sonuçları doğrulayın

Özel bir üstbilgi içeren bir istek göndermek için aşağıdaki komutu çalıştırın. ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın.

İstemci IP adresinin SourceIp listesinde olduğundan emin olun.
curl -H "headername:headervalue1" -s ALB_ENDPOINT/echo | grep -A 16 "Request Information"  

Beklenen çıktı:

Request Information:
	client_address=::ffff:10.0.2.93
	method=GET
	real path=/echo # The path that matches the forwarding condition.
	query=
	request_version=1.1
	request_scheme=http
	request_uri=http://alb-jyoefh22rkje******.******-**.alb.aliyuncsslbintl.com:8080/echo

Request Headers:
	accept=*/*
	headername=headervalue1 # The request header that matches the forwarding condition.
	host=alb-jyoefh22rkje******.******-**.alb.aliyuncsslbintl.com
	remoteip=140.205.***.***
	user-agent=curl/8.4.0
	x-forwarded-for=140.205.***.*** # The source IP that matches the forwarding condition.

Senaryo 2: Etki alanına, yönteme ve çereze göre yönlendirme

Aşağıdaki örnekte, ALB yalnızca istediğin etki alanı adı, istek yöntemi, çerezi ve yolu belirtilen koşullarla eşleşiyorsa isteği arka uç hizmetine iletir.

Aşağıdaki örneği host-method.yaml dosyasına kopyalayın ve bir Ingress oluşturmak için kubectl apply -f host-method.yaml komutunu çalıştırın.

  • Etki alanı adı: spec.rules içinde demo.alb.ingress.top olarak ayarlayın.

  • İstek yöntemi: PUT veya HEAD.

  • Çerez: cookiekey1=cookievalue1 içerir.

  • Yol: /echo kullanın.

Etki alanı adı yönlendirme koşulları, joker karakterli etki alanı adlarının (örneğin *.com ) eşleşmesini destekler.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/conditions.echoserver: | # The name echoserver must match the name of the backend Service configured in spec.rules.
     [{
       "type": "Cookie",
       "cookieConfig": {
         "values": [
           {
             "key":"cookiekey1",
             "value":"cookievalue1"
           }
        ]
       }
      },
      {
       "type": "Method",
       "methodConfig": {
         "values": [
           "PUT",
           "HEAD"
         ]
       }
      }]
  name: host-method-ingress
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              number: 80

Sonuçları doğrulayın

Belirli bir etki alanı adı, yöntem ve çerez içeren bir istek göndermek için aşağıdaki komutu çalıştırın. ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın.

curl -H "Host:demo.alb.ingress.top" -X PUT -b "cookiekey1=cookievalue1" -s ALB_ENDPOINT/echo | grep -A 16 "Request Information"

Beklenen çıktı:

Request Information:
	client_address=::ffff:10.0.3.249
	method=PUT # The request method that matches the forwarding condition.
	real path=/echo # The path that matches the forwarding condition.
	query=
	request_version=1.1
	request_scheme=http
	request_uri=http://demo.alb.ingress.top:8080/echo

Request Headers:
	accept=*/*
	cookie=cookiekey1=cookievalue1 # The cookie that matches the forwarding condition.
	host=demo.alb.ingress.top # The domain name that matches the forwarding condition.
	remoteip=140.205.***.***
	user-agent=curl/8.4.0
	x-forwarded-for=140.205.***.***

Senaryo 3: Sorgu dizesine ve üstbilgilere göre yönlendirme

Aşağıdaki örnekte, ALB yalnızca istediğin sorgu dizesi, istek üstbilgileri ve yolu belirtilen koşullarla eşleşiyorsa isteği arka uç hizmetine iletir.

Aşağıdaki örneği bir querystring.yaml dosyasına kopyalayın ve bir Ingress oluşturmak için kubectl apply -f querystring.yaml komutunu çalıştırın.

  • Sorgu dizesi: querystringkey1=querystringvalue2 kullanın.

  • İstek üstbilgisi: headerkey1:headervalue1 veya headerkey1:headervalue2, ve headerkey2:headervalue3 veya headerkey2:headervalue4 içerir.

  • Yol: /echo kullanın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/conditions.echoserver: | # The name echoserver must match the name of the backend Service configured in spec.rules.
    [{
      "type": "QueryString",
      "queryStringConfig": {
        "values": [
          {
            "key":"querystringkey1",
            "value":"querystringvalue2"
          }
        ]
      }
    },
    {
      "type": "Header",
      "headerConfig": {
        "key":"headerkey1",
        "values": [
          "headervalue1",
          "headervalue2"
        ]
      }
    },
    {
      "type": "Header",
      "headerConfig": {
        "key":"headerkey2",
        "values": [
          "headervalue3",
          "headervalue4"
        ]
      }
    }]
  name: querystring-ingress
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              number: 80

Sonuçları doğrulayın

Belirli bir sorgu dizesi ve özel istek üstbilgileri içeren bir istek göndermek için aşağıdaki komutu çalıştırın. ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın.

curl -H "headerkey1:headervalue1" -H "headerkey2:headervalue4" -s "ALB_ENDPOINT/echo?querystringkey1=querystringvalue2" | grep -A 16 "Request Information"

Beklenen çıktı:

Request Information:
	client_address=::ffff:10.0.3.249
	method=GET
	real path=/echo?querystringkey1=querystringvalue2 # The path that matches the forwarding condition.
	query=querystringkey1=querystringvalue2 # The query string that matches the forwarding condition.
	request_version=1.1
	request_scheme=http
	request_uri=http://alb-jyoefh22rkje******.******-**.alb.aliyuncsslbintl.com/echo?querystringkey1=querystringvalue2

Request Headers:
	accept=*/*
	headerkey1=headervalue1 # The request header that matches the forwarding condition.
	headerkey2=headervalue4 # The request header that matches the forwarding condition.
	host=alb-jyoefh22rkje******.******-**.alb.aliyuncsslbintl.com
	remoteip=140.205.***.***
	user-agent=curl/8.4.0
	x-forwarded-for=140.205.***.***

Yönlendirme koşulları

Önemli

Birden çok yönlendirme koşulunun birlikte kullanılmasında uygulanan mantık hakkında bilgi için bkz. Aynı türden birden çok yönlendirme koşulu aynı anda etkili olabilir mi?

Koşul

Açıklama

Etki alanı adı

İsteğin etki alanı adıyla eşleşir. ALB, yalnızca eşleşen etki alanı adına sahip istekleri arka uç hizmetine iletir.

Yönlendirme koşulları, joker karakterli etki alanı adlarının (örneğin, *.com) eşleşmesini destekler.
alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
      [{
          "type": "Host",
          "hostConfig": {
            "values": [
              "anno.example.com"
            ]
          }
      }]
  • type: Yönlendirme koşulunun eşleşme türü. Host, etki alanı adına göre eşleşmeyi gösterir.

  • hostConfig: Eşleştirilecek belirli etki alanı adı. Birden çok etki alanı adı ayarlanırsa, aralarındaki ilişki mantıksal OR'dur.

Önemli

Bu, yerel bir Ingress yapılandırmasındaki spec.rules.host alanına eşdeğerdir. Her ikisini de yapılandırırsanız, iki etki alanı adı arasında bir OR ilişkisi uygulanır. Her ikisi için de aynı değeri belirtmeyin. Aksi takdirde, Parametre yineleniyor sorunu oluşur.

Yol

İsteğin yoluyla eşleşir. ALB, yalnızca eşleşen yola sahip istekleri arka uç hizmetine iletir.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
  [{
    "type": "Path",
    "pathConfig": {
      "values": [
        "/pathvalue1",
        "/pathvalue2"
      ]
    }
  }]
  • type: Yönlendirme koşulunun eşleşme türü. Path, istek yoluna karşı eşleşmeyi gösterir.

  • pathConfig: Eşleştirilecek belirli yol. Birden çok yol ayarlanırsa, mantıksal OR ile değerlendirilirler.

Önemli

Bu, yerel bir Ingress yapılandırmasındaki spec.rules.http.paths.path alanıyla aynı etkiye sahiptir. Her ikisi de yapılandırılırsa, iki yol arasında bir OR ilişkisi vardır. Her iki yol için de aynı içeriği belirtmeyin. Aksi takdirde, Parametre yineleniyor hatası oluşur.

Üstbilgi

İstek üstbilgisiyle eşleşir. ALB, yalnızca belirli bir üstbilgi içeren istekleri arka uç hizmetine iletir.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
  [{
    "type": "Header",
    "headerConfig": {
      "key": "headername",
      "values": [
        "headervalue1",
        "headervalue2"
      ]
     }
  }]
  • type: Yönlendirme koşulunun eşleşme türü. Header, istek üstbilgisiyle eşleşmeyi gösterir.

  • headerConfig: İstek üstbilgisinin içermesi gereken anahtar-değer çiftleri. Birden çok değer belirtirseniz, mantıksal OR kullanılarak değerlendirilirler.

Bir kullanım durumu ve örnek için bkz. Senaryo 1: Kaynak IP ve istek üstbilgisine göre yönlendirme.

Sorgu dizesi

Sorgu dizesiyle eşleşir. ALB, yalnızca belirli bir sorgu dizesi içeren istekleri arka uç hizmetine iletir.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
  [{
    "type": "QueryString",
    "queryStringConfig": {
      "values": [
        {
           "key":"querystringkey1",
           "value":"querystringvalue2"
        }
      ]
    }
  }]
  • type: Yönlendirme koşulunun eşleşme türü. QueryString, isteğin sorgu dizesine karşı eşleşmeyi gösterir.

  • queryStringConfig: Sorgu dizesinin anahtar-değer çiftleri. Birden çok anahtar-değer çifti belirtirseniz, aralarındaki ilişki mantıksal OR'dur.

    Anahtar 1 ila 100 karakter uzunluğunda olmalıdır. Değer 1 ila 128 karakter uzunluğunda olmalıdır. Her ikisi de küçük harfleri, görünür karakterleri ve joker karakterler asterisk (*) ve soru işaretini (?) destekler. Boşluklar ve aşağıdaki karakterlere izin verilmez: #[]{}\|<>&.

Bir kullanım durumu ve örnek için bkz. Senaryo 3: Sorgu dizesine ve üstbilgilere göre yönlendirme.

İstek yöntemi

İstek yöntemiyle eşleşir. ALB, yalnızca belirli bir yöntem kullanan istekleri arka uç hizmetine iletir.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
  [{
    "type": "Method",
    "methodConfig": {
      "values": [
        "GET",
        "HEAD"
      ]
    }
  }]
  • type: Yönlendirme koşulunun eşleşme türü. Method, eşleşmenin istek yöntemine dayandığını belirtir.

  • methodConfig: İstek yöntemi. Desteklenen yöntemler GET, POST, PUT, DELETE, HEAD, OPTIONS ve PATCH'tir. Birden çok istek yöntemi ayarlarsanız, aralarındaki ilişki OR'dur.

Bir kullanım durumu ve örnek için bkz. Senaryo 2: Etki alanına, yönteme ve çereze göre yönlendirme.

Çerez

Çerezle eşleşir ve yalnızca doğru çerezi içeriyorsa isteği arka uç Service'e yönlendirir.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
  [{
    "type": "Cookie",
    "cookieConfig": {
      "values": [
        {
           "key":"cookiekey1",
           "value":"cookievalue2"
        }
      ]
     }
  }]
  • type: Yönlendirme koşulunun eşleşme türü. Cookie, çereze dayalı eşleşmeyi gösterir.

  • cookieConfig: Çerez anahtar-değer çiftleri. Birden çok çerez ayarlanırsa, mantıksal OR ile değerlendirilirler.

    Anahtar ve değer 1 ila 100 karakter uzunluğunda olmalı, küçük harfleri, görünür karakterleri ve joker karakterler asterisk (*) ve soru işaretini (?) desteklemeli, ancak boşlukları veya #[]{}\|<>& karakterlerini desteklememelidir.

Kullanım durumları ve örnekler için bkz. Senaryo 2: Etki alanı adı, istek yöntemi ve çereze göre yönlendirme.

Kaynak IP

Bir isteğin kaynak IP'siyle eşleşir. Yalnızca listedeki istemci kaynak IP'lerinden gelen istekler arka uç Service'e iletilir.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
  [{
    "type": "SourceIp",
    "sourceIpConfig": {
      "values": [
        "192.168.0.0/16",
        "172.16.0.0/16"
      ]
    }
  }]
  • type: Yönlendirme koşulunun eşleşme türü. SourceIp, isteğin kaynak IP'sine dayalı eşleşmeyi gösterir.

  • sourceIpConfig: İstek IP adresi. Birden çok IP adresi belirtirseniz, mantıksal OR ile değerlendirilirler.

Kullanım senaryoları ve örnekler için bkz. Senaryo 1: SourceIp ve istek üstbilgilerine göre yönlendirme.

Önemli

Tek bir yönlendirme koşulundaki SourceIp sayısı 5 ile sınırlıdır.

Yanıt üstbilgisi

Yanıt üstbilgisiyle eşleşir ve yalnızca belirtilen üstbilgiyi içeren yanıtlarda yönlendirme eylemini gerçekleştirir. Bu ayar, alb.ingress.kubernetes.io/rule-direction.<service-name>: Response ek açıklamasıyla birlikte kullanılmalıdır.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
      [{
        "type": "ResponseHeader",
        "responseHeaderConfig": {
          "key": "responseHeader",
          "values": [
            "headervalue1",
            "headervalue2"
          ]
         }
      }]
  • type: Yönlendirme koşulunun eşleşme türü. ResponseHeader, yanıt üstbilgisiyle eşleşmeyi gösterir.

  • responseHeaderConfig: Yanıt üstbilgisine dahil edilecek anahtar-değer çiftleri. Birden çok değer ayarlarsanız, mantıksal OR ile değerlendirilirler.

Senaryolar ve örnekler için bkz. Senaryo 7: ResponseHeader'a göre yanıt üstbilgilerini değiştirme.

Yanıt durum kodu

Yanıt durum koduyla eşleşir. Hizmet yalnızca doğru durum kodu döndürülürse erişilebilir. Bunun, yanıt yönü yönlendirme eylemi ve yanıt yönü yönlendirme kuralı ek açıklaması alb.ingress.kubernetes.io/rule-direction.<service-name>: Response ile birlikte kullanılması gerektiğini unutmayın.

alb.ingress.kubernetes.io/conditions.service-name: | # service-name must match the name of the backend Service configured in spec.rules.
      [{
        "type": "ResponseStatusCode",
        "responseStatusCodeConfig": {
          "values": [
            "statuscode1",
            "statuscode2"
          ]
        }
      }]
  • type: Yönlendirme koşulunun eşleşme türü. ResponseStatusCode, yanıt durum koduna karşı eşleşmeyi gösterir.

  • responseStatusCodeConfig: Belirli yanıt durum kodu. Birden çok yanıt durum kodu ayarlarsanız, aralarındaki ilişki mantıksal OR'dur.

Bir kullanım durumu ve örnek için bkz. Senaryo 8: Yanıt durum koduna göre yanıt üstbilgilerini değiştirme.

Yönlendirme eylemlerini yapılandırın

Senaryo 1: Sabit bir yanıt döndürme

Konsol

  1. Log on to the ACK konsolu. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Network > Ingresses.

  3. On the Ingresses page, click Create Ingress and use the following parameters.

    Parametre

    Değer

    Gateway Type

    ALB Ingress

    Name

    fixed-ingress

    IngressClass

    alb

    Rules

    Varsayılan Mappings öğesini silin.

    Custom Forwarding Rules

    Custom Forwarding Rules seçeneğini etkinleştirin.

    • Add Condition: Path seçeneğini belirleyin ve /echo girin.

    • Action: Return Fixed Response seçeneğini belirleyin.

      • Response Status Code: %503

      • Response Content Type (Optional): text/plain

      • Response Content (Optional): 503 error text

    Diğer parametreler için varsayılan değerleri koruyun.
  4. When you are finished, click OK.

kubectl

Aşağıdaki örnekteki Ingress, bir istek aldığında HTTP %503 durum kodu ve 503 error text döndürür.

Aşağıdaki örneği kopyalayarak fixed-response.yaml dosyasını oluşturun ve bir Ingress oluşturmak için kubectl apply -f fixed-response.yaml komutunu çalıştırın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: fixed-ingress
  annotations:
    alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "FixedResponse",
          "FixedResponseConfig": {
              "contentType": "text/plain",
              "httpCode": "503",
              "content": "503 error text"
          }
      }]
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: Prefix
        backend:
          service:
            name: echoserver
            port:
              name: use-annotation # The name of the service port must be set to use-annotation.

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -si ALB_ENDPOINT/echo | grep "HTTP/" 

Beklenen çıktı:

HTTP/1.1 503 Service Unavailable

Senaryo 2: İstekleri HTTPS bağlantı noktasına yönlendirme

Yeniden yönlendirme

Aşağıdaki Ingress örneği, istekleri yeni bir etki alanı adının 443 numaralı bağlantı noktasına yönlendirmek için HTTP %301 durum kodunu kullanır.

Yeniden yönlendirilen etki alanı adı ALB örnek uç noktasını çözümlüyorsa, bu yöntemi ALB Ingress'in HTTP bağlantı noktasından HTTPS bağlantı noktasına trafiği yönlendirmek için kullanabilirsiniz.

Bir redirect.yaml dosyası oluşturun, aşağıdaki örneği içine kopyalayın ve bir Ingress oluşturmak için kubectl apply -f redirect.yaml komutunu çalıştırın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: redirect-ingress
  annotations:
    alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "Redirect",
          "RedirectConfig": {
              "host": "www.alibabacloud.com",
              "path": "/en",
              "port": "443",
              "protocol": "https",
              "query": "_p_lc=1",
              "httpCode": "301"
          }
      }]
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: Prefix
        backend:
          service:
            name: echoserver
            port:
              name: use-annotation # The name of the service port must be set to use-annotation.

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -LIs ALB_ENDPOINT/echo | grep "HTTP"

Beklenen çıktı, isteğin yeni etki alanı adına yönlendirildiğini gösterir.

HTTP/1.1 301 Moved Permanently
Via: HTTP/1.1 SLB.208
HTTP/2 200 

Birden çok hizmet için yeniden yönlendirme

Aşağıdaki Ingress örneği, birden çok Service için trafiği yeniden yönlendirir.

  1. echoserver2 adlı bir Service oluşturun. Daha fazla bilgi için bkz. Örnek bir Service oluşturun.

  2. multi-redirect.yaml adlı bir dosya oluşturun ve aşağıdaki örneği içine kopyalayın. Bir Ingress oluşturmak için kubectl apply -f multi-redirect.yaml komutunu çalıştırın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: multi-redirect-ingress
  annotations:
    alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "Redirect",
          "RedirectConfig": {
              "host": "www.alibabacloud.com",
              "path": "/en",
              "port": "443",
              "protocol": "https",
              "query": "_p_lc=1",
              "httpCode": "301"
          }
      }]
    alb.ingress.kubernetes.io/actions.echoserver2: | # The name echoserver2 must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "Redirect",
          "RedirectConfig": {
              "host": "www.alibabacloud.com",
              "path": "/en",
              "port": "443",
              "protocol": "https",
              "query": "_p_lc=1",
              "httpCode": "301"
          }
      }]
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: Prefix
        backend:
          service:
            name: echoserver
            port:
              name: use-annotation # The name of the service port must be set to use-annotation.
      - path: /echo2
        pathType: Prefix
        backend:
          service:
            name: echoserver2
            port:
              name: use-annotation # The name of the service port must be set to use-annotation.

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -LIs ALB_ENDPOINT/echo | grep "HTTP" ;
curl -LIs ALB_ENDPOINT/echo2 | grep "HTTP"

Beklenen çıktı, her iki Service'e yapılan isteklerin de yeni etki alanı adına yönlendirildiğini gösterir.

HTTP/1.1 301 Moved Permanently
Via: HTTP/1.1 SLB.208
HTTP/2 200
HTTP/1.1 301 Moved Permanently
Via: HTTP/1.1 SLB.208
HTTP/2 200

Senaryo 3: Özel bir istek üstbilgisi ekleme

Aşağıdaki örnekteki Ingress, bir istek alındığında istek üstbilgisine source:alibaba ekler.

Aşağıdaki örnek içeriğe sahip insert-header.yaml adlı bir dosya oluşturun ve bir Ingress oluşturmak için kubectl apply -f insert-header.yaml komutunu çalıştırın.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: insert-header-ingress
  annotations:
    alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "InsertHeader",
          "InsertHeaderConfig": {
              "key": "source",
              "value": "alibaba",
              "valueType": "UserDefined"
          }
      }]
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: Prefix
        backend:
          service:
            name: echoserver
            port:
              number: 80

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -s ALB_ENDPOINT/echo | grep -A 6 "Request Headers"

Beklenen çıktı:

Request Headers:
	accept=*/*
	host=alb-jyoefh22rkjeerxmcg.us-west-1.alb.aliyuncsslbintl.com
	remoteip=140.205.***.***
	source=alibaba # Custom request header
	user-agent=curl/8.4.0
	x-forwarded-for=140.205.***.***

Senaryo 4: Trafiği bir sunucu grubuna yansıtma

Trafik yansıtma, bir ALB Ingress'in gelen istekleri kopyalayıp başka bir sunucu grubuna göndermesine olanak tanır.

  1. Log on to the Application Load Balancer (ALB) konsolu. Sol gezinme bölmesinde ALB > Server Group seçeneklerini belirleyin. Server Group sayfasında sunucu grubunun kimliğini alın.Server Groups

  2. Aşağıdaki örnekle bir traffic-mirror.yaml dosyası oluşturun ve bir Ingress oluşturmak için kubectl apply -f traffic-mirror.yaml komutunu çalıştırın.

    Aşağıdaki Ingress örneği, gelen istekleri sgp-2auud2fxj1r46***** sunucu grubuna yansıtır.
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: traffic-mirror-ingress
      annotations:
        alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
           [{
               "type": "TrafficMirror",
               "TrafficMirrorConfig": {
                  "TargetType" : "ForwardGroupMirror",
                  "MirrorGroupConfig": {
                      "ServerGroupTuples" : [{
                          "ServerGroupID": "sgp-2auud2fxj1r46*****"
                      }]
                  }
               }
           }]
    spec:
      ingressClassName: alb
      rules:
      - host: demo.domain.ingress.top
        http:
          paths:
          - path: /echo
            pathType: Prefix
            backend:
              service:
                name: echoserver
                port:
                  number: 80

Senaryo 5: Birden çok arka uç hizmetine yönlendirme

Bir ALB Ingress istek aldığında, isteği özel ağırlıklara göre birden çok arka uç Service'e iletir.

  1. echoserver2 adlı bir Service oluşturun. Daha fazla bilgi için bkz. Örnek bir Service oluşturun.

  2. Bir Ingress kaynağı oluşturun.

    Konsol

    1. Log on to the ACK konsolu. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

    2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Network > Ingresses.

    3. On the Ingresses page, click Create Ingress and use the following parameters.

      Parametre

      Değer

      Gateway Type

      ALB Ingress

      Name

      forward-ingress

      IngressClass

      alb

      Rules

      Varsayılan Mappings öğesini silin.

      Custom forwarding rule

      Custom Forwarding Rules seçeneğini etkinleştirin.

      • Add Condition:

        • Domain Name: demo.alb.ingress.top

        • Path: /echo

      • Action: Forward To seçeneğini belirleyin.

        • Service: echoserver

          • Port: 80

        • Service: echoserver2

          • Port: 80

      Diğer parametreler için varsayılan değerleri koruyun.
    4. When you are finished, click OK.

    kubectl

    Aşağıdaki örnekle bir forward.yaml dosyası oluşturun ve bir Ingress oluşturmak için kubectl apply -f forward.yaml komutunu çalıştırın.

    Aşağıdaki Ingress örneği, gelen istekleri echoserver ve echoserver2 Service'lerine 80:20 ağırlık oranıyla iletir.
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: forward-ingress
      annotations:
        alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
           [{
               "type": "ForwardGroup",
               "ForwardConfig": {
                 "ServerGroups" : [{
                   "ServiceName": "echoserver",
                   "Weight": 80,
                   "ServicePort": 80
                 },
                 {
                   "ServiceName": "echoserver2",
                   "Weight": 20,
                   "ServicePort": 80
                 }]
               }
           }]
    spec:
      ingressClassName: alb
      rules:
      - host: demo.alb.ingress.top
        http:
          paths:
          - path: /echo
            pathType: Prefix
            backend:
              service:
                name: echoserver
                port:
                  name: use-annotation # This must be set to use-annotation.

Senaryo 6: İstek yapılandırmalarını yeniden yazma

ALB Ingress, özel yönlendirme kurallarını kullanarak bir isteğin etki alanı adını, yolunu ve sorgu parametrelerini değiştirmenize olanak tanır. rewrite-target ek açıklamasından farklı olarak, bu özellik etki alanı adını değiştirmenize olanak tanır. Bu özellik, URL basitleştirme, istemci şeffaf yeniden yazmalar ve arka uç uygulama ayrıntılarını gizleme senaryolarında kullanışlıdır.

Aşağıdaki örneği rewrite.yaml adlı bir dosyaya kopyalayın ve bir Ingress oluşturmak için kubectl apply -f rewrite.yaml komutunu çalıştırın.

Aşağıdaki örnekte, istemcinin URL'si https://example.com/api/echo şu şekilde yeniden yazılır: https://example.org/echo .
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/actions.echoserver: | # The name echoserver must match the name of the backend Service that is configured in spec.rules.
       [{
           "type": "Rewrite",
           "RewriteConfig": {
               "host": "example.org", 
               "path": "/echo", 
               "query": "${query}"
           }
       }]
spec:
  ingressClassName: alb
  rules:
  - host: example.com
    http:
      paths:
      - path: /api/echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port: 
              number: 80

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -H "Host:example.com" -s "ALB_ENDPOINT/api/echo?querystring=request" | grep -A 7 "Request Information"

Beklenen çıktı:

Request Information:
	client_address=::ffff:10.0.2.93
	method=GET
	real path=/echo?querystring=request
	query=querystring=request
	request_version=1.1
	request_scheme=http
	request_uri=http://example.org:8080/echo?querystring=request # The domain name and path are rewritten.

Senaryo 7: ResponseHeader'a göre yanıt üstbilgilerini değiştirme

Aşağıdaki örnekteki Ingress, yanıt üstbilgisini değiştirir. Yanıt üstbilgisi Content-Type: text/plain içerdiğinde, Ingress yanıt üstbilgisine source: alibaba ekler.

Aşağıdaki örnekle response-header.yaml adlı bir dosya oluşturun ve bir Ingress oluşturmak için kubectl apply -f response-header.yaml komutunu çalıştırın.

Önemli
  • Yanıt yönü için bir yönlendirme kuralı oluştururken, alb.ingress.kubernetes.io/rule-direction.<service-name> ek açıklamasını Response olarak ayarlamanız gerekir. Bu ek açıklamasının varsayılan değeri Request'tir.

  • Yanıt yönü için tek başına bir yönlendirme kuralı istek yönlendirmeyi işleyemez. Aşağıdaki örnek ayrıca istek yönü için ayrı bir Ingress yapılandırır.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: response-header-ingress
  annotations:
    alb.ingress.kubernetes.io/rule-direction.echoserver: Response # For response-direction rules, this must be set to Response.
    alb.ingress.kubernetes.io/conditions.echoserver: | # Used with a forwarding condition for the response direction. A custom response header is inserted only for responses that meet the forwarding condition.
     [{
         "type": "ResponseHeader",
         "responseHeaderConfig": {
            "key": "Content-Type",
            "values": [
               "text/plain"
            ]
         }
     }]
    alb.ingress.kubernetes.io/actions.echoserver: | # Inserts a custom response header.
     [{
         "type": "InsertHeader",
         "InsertHeaderConfig": {
             "key": "source",
             "value": "alibaba",
             "valueType": "UserDefined"
         }
     }]
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              name: use-annotation # This must be set to use-annotation.

---
# Ingress for the request direction
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: request-ingress
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              number: 80

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -sI ALB_ENDPOINT/echo | grep "source"

Beklenen çıktı:

source: alibaba

Senaryo 8: Durum koduna göre yanıt üstbilgilerini değiştirme

Aşağıdaki örnekteki Ingress, yanıt durum kodu 200 veya 300 olduğunda yanıt üstbilgisinden Content-Type kaldırarak yanıt üstbilgisini değiştirir.

Bir response-code.yaml dosyası oluşturun, aşağıdaki örneği içine kopyalayın ve bir Ingress oluşturmak için kubectl apply -f response-code.yaml komutunu çalıştırın.

Önemli
  • Yanıt yönü için bir yönlendirme kuralı oluştururken, alb.ingress.kubernetes.io/rule-direction.<service-name> ek açıklamasını Response olarak ayarlamanız gerekir (bu ek açıklaması varsayılan olarak Request olarak ayarlanır).

  • Yanıt yönü için tek başına bir yönlendirme kuralı istek yönlendirmeyi işleyemez. Aşağıdaki örnek ayrıca istek yönü için ayrı bir Ingress yapılandırır.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/rule-direction.echoserver: Response # For response-direction rules, this must be set to Response.
    alb.ingress.kubernetes.io/conditions.echoserver: | # Used with a forwarding condition for the response direction. The response header is removed only for responses that meet the forwarding condition.
     [{
       "type": "ResponseStatusCode",
       "responseStatusCodeConfig": {
         "values": [
             "200",
             "300"
         ]
       }
     }]
    alb.ingress.kubernetes.io/actions.echoserver: | # Removes a response header.
     [{
         "type": "RemoveHeader",
         "RemoveHeaderConfig": {
             "key": "Content-Type"
         }
     }]
  name: response-code-ingress
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              name: use-annotation # This must be set to use-annotation.
              
---
# Ingress for the request direction
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: request-ingress
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /echo
        pathType: ImplementationSpecific
        backend:
          service:
            name: echoserver
            port:
              number: 80

Sonuçları doğrulayın

ALB_ENDPOINT yerine ALB örnek uç noktanızı yazın ve aşağıdaki komutu çalıştırın:

curl -sI ALB_ENDPOINT/echo

Beklenen çıktı:

HTTP/1.1 200 OK
Date: Thu, 29 Jan 2026 09:46:20 GMT
Connection: keep-alive
Vary: Accept-Encoding
# The Content-Type: text/plain header is removed.

Yönlendirme eylemi referansı

İstek yönü

Yönlendirme eylemi

Açıklama

Sabit yanıt

İstemciye sabit içerikli bir yanıt döndürür.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
  [{
      "type": "FixedResponse",
      "FixedResponseConfig": {
          "contentType": "text/plain",
          "httpCode": "503",
          "content": "503 error text"
      }
  }]
  • type: Yönlendirme eyleminin türü. FixedResponse, sabit bir yanıtı gösterir.

  • contentType: Yanıt gövdesinin içerik türü.

  • httpCode: Yanıt durum kodu. Desteklenen değerler 2XX, 4XX veya 5XX formatındaki sayısal dizelerdir.

  • content: Yanıt gövdesi.

Önemli

backend.service.port.name, use-annotation olarak ayarlanmalıdır.

Bir kullanım durumu için bkz. Senaryo 1: Sabit bir yanıt döndürme.

Yeniden yönlendirme

HTTP %3xx durum kodu kullanarak istemcileri başka bir URL'ye yönlendirir.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
  [{
      "type": "Redirect",
      "RedirectConfig": {
          "host": "${host}",
          "path": "/test",
          "port": "443",
          "protocol": "https",
          "query": "querystring",
          "httpCode": "301"
      }
  }]
  • type: Yönlendirme eyleminin türü. Redirect değeri yeniden yönlendirmeyi belirtir.

  • host: Hedef etki alanı adı.

  • path: Hedef yol.

  • port: Hedef bağlantı noktası.

  • protocol: Yeniden yönlendirme protokolü.

  • query: Yeniden yönlendirme için sorgu dizesi.

  • httpCode: Yeniden yönlendirme durum kodu. Geçerli değerler: 301, 302, 303, 307 veya 308.

Önemli
  • host, path, port, protocol ve query özel parametrelerdir. Orijinal istekten gelen değerleri kullanacak şekilde yapılandırabilirsiniz ancak en az bir parametre varsayılan olmayan bir değere ayarlanmalıdır. Örneğin, host parametresi için ${host} olarak ayarlamak, boş bırakmak (örneğin "host": "") veya parametreyi belirtmemek, orijinal istekteki değerin kullanıldığını gösterir.

  • backend.service.port.name, use-annotation olarak ayarlanmalıdır.

Bir kullanım durumu için bkz. Senaryo 2: İstekleri HTTPS bağlantı noktasına yönlendirme.

Trafik yansıtma

Sunucu grubu kimliğini belirterek istekleri bir sunucu grubuna yansıtır.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "TrafficMirror",
          "TrafficMirrorConfig": {
              "TargetType" : "ForwardGroupMirror",
              "MirrorGroupConfig": {
                  "ServerGroupTuples" : [{
                      "ServerGroupID": "sgp-2auud2fxj1r46*****"
                  }]
              }
           }
      }]
  • type: Yönlendirme eyleminin türü. TrafficMirror, trafik yansıtma özelliğinin yapılandırıldığını belirtir.

  • TargetType: Yansıtma için hedef türü. Şu anda desteklenen tek tür, istekleri bir sunucu grubuna yansıtan ForwardGroupMirror'dir.

  • ServerGroupID: Trafik yansıtma sunucu grubunun kimliği.

Önemli
  • Trafik yansıtma eylemi, yönlendirme, istek üstbilgisi ekleme, istek üstbilgisi kaldırma ve QPS kısıtlama ile birleştirilebilir. Yeniden yazma, sabit yanıt veya yeniden yönlendirme ile uyumlu değildir.

  • Trafik yansıtma sunucu grupları yalnızca ServerGroupID kullanılarak eklenebilir.

Bir kullanım durumu için bkz. Senaryo 4: Trafiği bir sunucu grubuna yansıtma.

Birden çok arka uç sunucu grubuna yönlendirme

Bir ALB arka ucuna birden çok sunucu grubu ekleyebilir ve trafik dağıtım oranını kontrol etmek için ağırlıklarını ayarlayabilirsiniz. Bir sunucu grubunu ServerGroupID belirterek ekleyebilir veya ServiceName+ServicePort belirterek yeni bir tane oluşturup ekleyebilirsiniz.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
           [{
               "type": "ForwardGroup",
               "ForwardConfig": {
                 "ServerGroups" : [{
                   "ServiceName": "tea-svc",
                   "Weight": 30,
                   "ServicePort": 80
                 },
                 {
                   "ServiceName": "coffee-svc",
                   "Weight": 20,
                   "ServicePort": 80
                 },
                 {
                   "ServerGroupID": "sgp-71aexb9y93ypo*****",
                   "Weight": 20
                 },
                 {
                   "ServerGroupID": "sgp-slygpbvm2cydo*****",
                   "Weight": 30
                 }],
                 "ServerGroupStickySession": {
                  "Enabled": true,
                  "Timeout": 80
                 }
               }
           }]
  • type: Yönlendirme eyleminin türü. ForwardGroup, isteklerin birden çok arka uç sunucu grubuna iletildiğini belirtir.

  • ForwardConfig: Arka uç yönlendirme sunucu grupları için belirli parametreler. Birden çok sunucu grubu yapılandırılırsa, istekler ağırlıklarına göre sunucu gruplarına iletilir.

  • ServerGroupID: Sunucu grubunun kimliği.

  • ServiceName: Hizmetin adı.

  • ServicePort: Hizmetin bağlantı noktası.

  • Weight: İstekleri bir sunucu grubuna yönlendirmek için ağırlık. Değer aralığı [1, 100]'dür.

  • Enabled: Sunucu grupları arasında oturum kalıcılığının etkinleştirilip etkinleştirilmeyeceğini belirtir.

  • Timeout: Sunucu grubu için oturum kalıcılığı zaman aşımı (saniye cinsinden). Değer aralığı: [1, 86400].

Önemli
  • Standart bir ALB örneğine en fazla beş sunucu grubu veya Service eklenebilir.

  • Hem ServerGroupID hem de ServiceName+ServicePort belirterek bir sunucu grubu eklerseniz, ServerGroupID daha yüksek önceliğe sahiptir.

  • Sunucu grupları arasında oturum kalıcılığını etkinleştirdikten sonra, ALB Ingress aynı oturumdaki istekleri aynı arka uca iletir.

  • backend.service.port.name, use-annotation olarak ayarlanmalıdır.

  • Sunucu grupları arasında oturum kalıcılığını etkinleştirebilirsiniz. Eklenen tüm sunucu grupları için oturum kalıcılığının etkinleştirildiğinden emin olun.

Bir kullanım durumu için bkz. Senaryo 5: Birden çok arka uç hizmetine yönlendirme.

Yeniden yazma

Bu eylem, gelen bir isteğin etki alanı adını, yolunu ve sorgu dizesini arka uç Service'e yönlendirmeden önce yeniden yazar.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
       [{
           "type": "Rewrite",
           "RewriteConfig": {
               "host": "demo.domain.ingress.top",
               "path": "/test",
               "query": "querystring"
           }
       }]
  • type: Yönlendirme eyleminin türü. Yeniden yazmayı etkinleştirmek için bu parametreyi Rewrite olarak ayarlayın.

  • host: İstek yeniden yazıldıktan sonra kullandığı etki alanı adı.

  • path: İstek yeniden yazıldıktan sonra kullandığı yol.

  • query: Yeniden yazılan isteğin sorgu dizesi.

Önemli
  • Yeniden yazma yönlendirme eylemi ile rewrite-target ek açıklaması birbirini dışlar.

  • Yeniden yazma eylemi, sabit yanıt veya yeniden yönlendirme yönlendirme eylemleriyle birlikte kullanılamaz.

  • host, path ve query, orijinal istekteki değerlerini kullanacak şekilde yapılandırılabilen özel parametrelerdir ancak bunlardan en az biri varsayılan olmayan bir değere ayarlanmalıdır. Örneğin, host parametresini ${host} olarak ayarlamak, boş bırakmak ("host": "") veya parametreyi tamamen atlamak, orijinal istekteki değerin kullanılacağını gösterir.

Bir kullanım durumu için bkz. Senaryo 6: İstek yapılandırmalarını yeniden yazma.

İstek üstbilgisi ekle

İsteğe bir üstbilgi ekler. Aynı ada sahip bir üstbilgi zaten varsa değeri üzerine yazılır.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
  [{
      "type": "InsertHeader",
      "InsertHeaderConfig": {
          "key": "key",
          "value": "value",
          "valueType": "UserDefined"
      }
  }]
  • type: Yönlendirme eyleminin türü. InsertHeader, bir istek üstbilgisinin eklendiğini belirtir.

  • key: Eklenecek üstbilgi alanının adı.

  • value: Eklenecek üstbilgi alanının içeriği.

  • valueType: Üstbilgi alanının içerik türü.

Bir kullanım durumu için bkz. Senaryo 3: Özel bir istek üstbilgisi ekleme.

İstek üstbilgisini kaldır

Bir istek üstbilgisini kaldırır.

alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
     [{
         "type": "RemoveHeader",
         "RemoveHeaderConfig": {
             "key": "key"
         }
     }]
  • type: Yönlendirme eyleminin türü. Bir istek üstbilgisini kaldırmak için değeri RemoveHeader olarak ayarlayın.

  • key: Kaldırılacak üstbilgi alanının adı.

QPS kısıtlama

Genel bir istek hızı sınırı ve istemci başına kaynak IP istek hızı sınırı yapılandırır.

 annotations:
alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
      [{
          "type": "TrafficLimit",
          "TrafficLimitConfig": {
              "QPS": "1000",
              "QPSPerIp": "100"
          }
      }]
  • type: Yönlendirme eyleminin türü. TrafficLimit değeri bir QPS kısıtlama yapılandırmasını belirtir.

  • QPS: Saniyede işlenebilecek istek sayısı olan genel istek hızı sınırı. Değer aralığı [1, 1.000.000]'dir. İstek hızı yapılandırılan sınırı aştığında, aşırı yeni bağlantı istekleri reddedilir ve istemci HTTP %503 durum kodu alır.

  • QPSPerIp: Her istemcinin kaynak IP adresine göre istek hızı sınırını belirtir. Geçerli aralık [1, 1.000.000]'dir. Hem QPS (genel hız sınırlama) hem de QPSPerIp (IP başına hız sınırlama) ayarlandığında, QPSPerIp değeri QPS değerinden düşük olmalıdır. İstek hızı belirlenen sınırı aştığında, aşırı istekler reddedilir ve istemci HTTP %503 durum kodu alır.

Önemli
  • QPS kısıtlama yönlendirme eylemi, bir sunucu grubuna yönlendirme ile birlikte kullanılmalıdır.

  • X-Forwarded-For istek üstbilgisi X-Forwarded-For: <client-ip-address>, <proxy1>, <proxy2>, ... gibi birden çok IP adresi içerdiğinde, en soldaki adres gerçek istemci IP adresidir. İstemci kaynak IP'sine göre QPS kısıtlamayı kullanmak için dinleyici ayarlarında gerçek istemci IP adresini alma özelliğini etkinleştirmeniz gerekir. Bu, ALB örneğinin X-Forwarded-For üstbilgi alanından gerçek istemci IP adresini bulmasına olanak tanır. Daha fazla bilgi için bkz. XForwardedForConfig.

Yanıt yönü

Yönlendirme eylemi

Açıklama

Yanıt üstbilgisi ekle

Yanıta bir üstbilgi ekler. Aynı ada sahip bir üstbilgi zaten varsa değeri üzerine yazılır.

alb.ingress.kubernetes.io/rule-direction.service-name: Response # For response-direction rules, this must be set to Response.
alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
  [{
      "type": "InsertHeader",
      "InsertHeaderConfig": {
          "key": "key",
          "value": "value",
          "valueType": "UserDefined"
      }
  }]
  • type: Yönlendirme eyleminin türü. InsertHeader, bir yanıt üstbilgisinin eklendiğini belirtir.

  • key: Eklenecek üstbilgi alanının adı.

  • value: Eklenecek üstbilgi alanının içeriği.

  • valueType: Üstbilgi alanının içerik türü.

Yanıt yönünde yanıt üstbilgilerini değiştirme kullanım durumları için bkz. Senaryo 7: ResponseHeader'a göre yanıt üstbilgilerini değiştirme ve Senaryo 8: Durum koduna göre yanıt üstbilgilerini değiştirme.

Yanıt üstbilgisini kaldır

Bir yanıt üstbilgisini kaldırır.

alb.ingress.kubernetes.io/rule-direction.service-name: Response # For response-direction rules, this must be set to Response.
alb.ingress.kubernetes.io/actions.service-name: | # The service-name must match the name of the backend Service that is configured in spec.rules.
     [{
         "type": "RemoveHeader",
         "RemoveHeaderConfig": {
             "key": "key"
         }
     }]

type: Yönlendirme eyleminin türü. Bir yanıt üstbilgisini kaldırmak için RemoveHeader olarak ayarlayın.

key: Kaldırılacak üstbilgi alanının adı.

Kota ve sınırlar

  • Bir hizmet için yönlendirme kuralı, spec.rules içinde belirtilen etki alanı adı ve Yol dahil olmak üzere en fazla 10 yönlendirme koşuluna sahip olabilir.

  • Bir yönlendirme kuralı, bir hız sınırlama eylemiyle birleştirilebilen yeniden yönlendirme, sabit yanıt veya birden çok sunucu grubuna yönlendirme gibi tek bir sonlandırıcı yönlendirme eylemini destekler.

  • Yeniden yönlendirme, sabit yanıt veya birden çok sunucu grubuna yönlendirme yapılandırırken, backend.service.port.name öğesi use-annotation olarak ayarlanmalıdır.

SSS

Aynı türden yönlendirme koşullarının çalışma şekli

Farklı yönlendirme kuralı blokları mantıksal AND kullanırken, aynı yönlendirme kuralı bloğu içindeki değerler mantıksal OR kullanır. Örneğin:

  • İki farklı Header kuralı bloğu mantıksal AND kullanır. İstek, istek üstbilgisi hem headervalue1 hem de headervalue2 ile eşleştiğinde yalnızca iletilir.

    
    alb.ingress.kubernetes.io/conditions.service-name: |
      [{
        "type": "Header",
        "headerConfig": {
          "key": "headername",
          "values": [
            "headervalue1"
          ]
         }
      },
      {
        "type": "Header",
        "headerConfig": {
          "key": "headername",
          "values": [
            "headervalue2"
          ]
         }
      }]
  • Aynı Header kuralı bloğu içindeki değerler mantıksal OR kullanır. İstek üstbilgisinin yalnızca headervalue1 veya headervalue2 ile eşleşmesi yeterlidir.

    
    alb.ingress.kubernetes.io/conditions.service-name: |
      [{
        "type": "Header",
        "headerConfig": {
          "key": "headername",
          "values": [
            "headervalue1",
            "headervalue2"
          ]
         }
      }]

Neden The param of Rules.1.RuleConditions.2.HostConfig.Values.2 is duplicated hatası alıyorum?

Yönlendirme koşullarında bir Host koşulu yapılandırırsanız ve ayrıca spec.rules içindeki host alanında aynı etki alanı adını belirtirseniz, Ingress yapılandırması başarısız olur. Lütfen etki alanı adını bu konumlardan yalnızca birinde yapılandırın.