Container Service for Kubernetes：Penggunaan lanjutan layanan ALB Ingress

Indeks

Teruskan permintaan berdasarkan nama domain

Anda dapat membuat Ingress sederhana untuk meneruskan permintaan berdasarkan nama domain standar tertentu atau nama domain kosong. Bagian berikut menyediakan contoh.

Teruskan permintaan berdasarkan jalur URL

Bagian berikut menyediakan contoh ketiga jenis pencocokan tersebut:

Konfigurasikan pemeriksaan kesehatan

ALB Ingress mendukung pemeriksaan kesehatan. Anda dapat mengonfigurasi pemeriksaan kesehatan dengan mengatur anotasi berikut.

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:
      # Konfigurasikan jalur konteks
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      # Konfigurasikan jalur konteks
      - path: /coffee
        pathType: ImplementationSpecific
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

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:
      # Konfigurasikan jalur konteks.
      - path: /tea
        backend:
          serviceName: tea-svc
          servicePort: 80
      # Konfigurasikan jalur konteks.
      - path: /coffee
        backend:
          serviceName: coffee-svc
          servicePort: 80

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

Konfigurasikan pengalihan HTTP ke HTTPS

ALB Ingress menggunakan anotasi berikut untuk mengalihkan permintaan HTTP ke Port HTTPS 443.

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: NodePort
---
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

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: NodePort
---
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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
 ... ...

Dukungan protokol HTTPS dan gRPC untuk backend

ALB mendukung HTTPS dan gRPC sebagai protokol backend. Untuk menggunakannya, Anda dapat menambahkan anotasi berikut ke Ingress Anda.

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

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
... ...

Konfigurasikan ekspresi reguler

Anda dapat menggunakan anotasi alb.ingress.kubernetes.io/use-regex: "true" untuk mengaktifkan mode ekspresi reguler. Kemudian, Anda dapat mengonfigurasi ekspresi reguler dalam kondisi atau aksi pengalihan kustom.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"  ## Mengizinkan penggunaan ekspresi reguler.
   alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME>: | ## Ganti <YOUR-SVC-NAME> dengan nama Service yang sebenarnya. Harus sama dengan backend.service.name di bawah ini.
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*/pathvalue1", ## Tambahkan ~* atau ~ sebelum ekspresi reguler sebagai flag. Konten setelah ~* atau ~ adalah ekspresi reguler yang efektif. ~* menunjukkan pencocokan ekspresi reguler case-sensitive, dan ~ menunjukkan pencocokan ekspresi reguler case-insensitive.
              "/pathvalue2"    ## Tidak perlu ~* untuk pencocokan eksak.
           ]
       }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
   - http:
      paths:
      - path: /test-path-for-alb
        pathType: Prefix
        backend:
          service:
            name: <YOUR-SVC-NAME> ## <YOUR-SVC-NAME> di sini harus sama dengan nama layanan yang ditentukan dalam anotasi kondisi pengalihan kustom untuk menunjukkan hubungan tersebut.
            port:
              number: 88

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"  ## Mengizinkan penggunaan ekspresi reguler.
   alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME>: | ## Ganti <YOUR-SVC-NAME> dengan nama Service yang sebenarnya. Harus sama dengan backend.service.name di bawah ini.
     [{
       "type": "Path",         ## Mendukung Host
       "pathConfig": {
           "values": [
              "~*/pathvalue1", ## Tambahkan ~* atau ~ sebelum ekspresi reguler sebagai flag. Konten setelah ~* atau ~ adalah ekspresi reguler yang efektif. ~* menunjukkan pencocokan ekspresi reguler case-sensitive, dan ~ menunjukkan pencocokan ekspresi reguler case-insensitive.
              "/pathvalue2"    ## Tidak perlu ~* untuk pencocokan eksak.
           ]
       }
      }]
... ...

Aturan pencocokan ekspresi reguler:

Konfigurasikan penulisan ulang (rewrite)

ALB Ingress mendukung fitur penulisan ulang (rewrite). Setelah ALB Ingress menerima permintaan klien, ia memodifikasi jalur permintaan tersebut lalu mengirimkan permintaan ke Service backend. Penulisan ulang diimplementasikan menggunakan dua anotasi berikut:

• alb.ingress.kubernetes.io/rewrite-target: /<path>/${number}: Mengaktifkan penulisan ulang dan menentukan jalur yang ditulis ulang.

  Penting

  • Gunakan format ${number} untuk merepresentasikan variabel yang diperoleh dari jalur asli menggunakan ekspresi reguler. Anda dapat mengonfigurasi satu atau beberapa variabel, seperti ${1}, ${2}, atau ${3}. Anda dapat memperoleh maksimal tiga variabel dari jalur asli.

  • pathType dari Ingress harus diatur ke Prefix.

• alb.ingress.kubernetes.io/use-regex: Menentukan apakah akan menggunakan ekspresi reguler dalam jalur. Ini diaktifkan secara bawaan setelah Anda mengonfigurasi rewrite-target.

  • "true": Gunakan ekspresi reguler.

  • "false": Jangan gunakan ekspresi reguler. Jika jalur berisi karakter khusus, seperti “%#;!()[]^,”\", sumber daya Ingress tidak dapat dibuat.

Contoh konfigurasi

Skenario 1: Hapus awalan

Pada contoh YAML berikut, path: /something(/|$)(.*) menggunakan ekspresi reguler untuk membagi jalur permintaan klien menjadi tiga bagian:

• /something: Mencocokkan awalan yang akan dihapus.

• (/|$): Grup penangkapan pertama, yang mencocokkan karakter / atau akhir jalur ($) yang mengikuti /something.

• (.*): Grup penangkapan kedua, yang mencocokkan semua konten yang mengikuti /something/. Digunakan dalam jalur yang ditulis ulang sebagai ${2}.

Jalur yang ditulis ulang yang dikonfigurasi dalam anotasi alb.ingress.kubernetes.io/rewrite-target adalah / (awalan jalur standar) + ${2} (konten grup penangkapan kedua). Tabel berikut menjelaskan efek penulisan ulang jalur.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # Mengizinkan bidang path menggunakan ekspresi reguler.
    alb.ingress.kubernetes.io/rewrite-target: /${2} # Anotasi ini mendukung penggantian ekspresi reguler.
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /something(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

Skenario 2: Tangkap dan susun ulang beberapa bagian

Contoh berikut menangkap dan menyusun ulang beberapa bagian dari jalur /items/(.*)/(.*)/(.*). Ini juga mengubah format URL menjadi format yang mirip dengan permintaan POST tanpa sepengetahuan pengguna. Jalur yang ditulis ulang adalah / (awalan jalur standar) + ${2} (konten grup penangkapan kedua) + ?code= + ${3} (konten grup penangkapan ketiga). Tabel berikut menjelaskan efek penulisan ulang jalur.

Contoh ini secara eksplisit memerlukan empat segmen dalam jalur. Metode ini mengharuskan klien menggunakan format jalur tetap.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # Mengizinkan bidang path menggunakan ekspresi reguler.
    alb.ingress.kubernetes.io/rewrite-target: /${2}?code=${3} # Anotasi ini mendukung penggantian ekspresi reguler.
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /items/(.*)/(.*)/(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

Skenario 3: Tulis ulang beberapa jalur ke satu jalur

Contoh berikut menulis ulang beberapa jalur ke satu jalur dengan mencocokkan beberapa jalur (/app-a(/|$)(.*) dan /app-b(/|$)(.*)) menggunakan ekspresi reguler. Jalur yang ditulis ulang adalah /app-c/ + ${2} (konten grup penangkapan kedua). Tabel berikut menjelaskan efek penulisan ulang jalur.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # Mengizinkan bidang path menggunakan ekspresi reguler.
    alb.ingress.kubernetes.io/rewrite-target: /app-c/${2} # Anotasi ini mendukung penggantian ekspresi reguler.
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

Skenario 4: Tulis ulang nama domain

Anotasi alb.ingress.kubernetes.io/rewrite-target hanya mendukung perubahan jalur. Untuk mengubah bagian lain dari URL, seperti nama domain dan parameter, Anda dapat menggunakan aturan pengalihan kustom.

Verifikasi pencocokan aturan penulisan ulang

Anda dapat menggunakan perintah sed untuk menguji terlebih dahulu apakah jalur tertentu yang digunakan klien cocok dengan ekspresi reguler yang dikonfigurasi dalam jalur dan untuk melihat jalur baru yang ditulis ulang.

Bagian ini menggunakan jalur penangkapan /items/(.*)/(.*)/(.*) dan aturan penulisan ulang /${2}?code=${3} dari Skenario 2: Tangkap dan susun ulang beberapa bagian sebagai contoh:

1. Simpan perintah contoh berikut ke path2.txt:

   /items/electronics/computers/554
   /items/produce/fruits/12
   /items/headphones/5
   /drinks/41

2. Periksa apakah jalur cocok dan lihat jalur yang ditulis ulang:

   Dalam perintah berikut, ekspresi reguler jalur (/items/(.*)/(.*)/(.*)) dan jalur yang ditulis ulang (/${2}?code=${3}) dari contoh dimodifikasi. Dalam perintah sed, karakter khusus / harus di-escape dengan karakter escape \, dan konten grup penangkapan ditulis sebagai \2 bukan ${2}.

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

   Output yang diharapkan adalah sebagai berikut. Dua jalur pertama cocok dengan aturan penulisan ulang dan ditulis ulang ke jalur baru. Dua jalur terakhir tidak cocok dengan aturan penulisan ulang dan tidak ditulis ulang.

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

Konfigurasikan port listener kustom

ALB Ingress mendukung port listener kustom melalui anotasi. Ini memungkinkan layanan untuk mengekspos port 80 (HTTP) dan port 443 (HTTPS) secara bersamaan.

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

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
   alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
... ...

Konfigurasikan prioritas aturan pengalihan

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

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
   alb.ingress.kubernetes.io/order: "2"
spec:
... ...

Implementasikan rilis bertahap menggunakan anotasi

ALB mendukung routing kompleks dan menyediakan kemampuan rilis bertahap berdasarkan header, cookie, dan bobot. Anda dapat mengonfigurasi anotasi berikut untuk secara fleksibel mengimplementasikan berbagai kebijakan rilis bertahap. Untuk informasi selengkapnya tentang praktik terbaik rilis bertahap, lihat Implementasikan rilis bertahap melalui ALB Ingress.

• Alokasikan traffic canary berdasarkan header tertentu

  Parameter	Deskripsi	Contoh YAML
  alb.ingress.kubernetes.io/canary-by-header	Aturan ini memungkinkan Anda menyesuaikan header permintaan dan nilai yang sesuai. Anda harus mengonfigurasi kedua anotasi. Ketika header dan header-value dalam permintaan cocok dengan nilai yang ditetapkan, traffic permintaan dialokasikan ke titik akhir layanan canary. Permintaan lain yang tidak cocok dialokasikan ke layanan canary berikutnya sesuai dengan prioritas canary.	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 spec: ... ...
  alb.ingress.kubernetes.io/canary-by-header-value

  Jika header permintaan berisi location: hz, traffic diarahkan ke layanan canary. Permintaan lain dialokasikan ke layanan canary berdasarkan kebijakan bobot canary. Berikut adalah contoh konfigurasi.

  Perluas untuk melihat contoh YAML lengkap

  Untuk kluster versi 1.19 dan yang lebih baru

  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

  Untuk kluster versi sebelum 1.19

  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

• Alokasikan traffic canary berdasarkan cookie tertentu

  Parameter	Nilai cookie	Contoh YAML
  alb.ingress.kubernetes.io/canary-by-cookie	always: Semua traffic permintaan dialokasikan ke titik akhir layanan canary. never: Traffic permintaan tidak dialokasikan ke titik akhir layanan canary. Rilis canary berbasis cookie tidak mendukung pengaturan kustom, hanya always dan never.	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 ... ...

  Jika header permintaan berisi Cookie: demo=always, traffic diarahkan ke layanan canary. Jika header permintaan berisi Cookie: demo=never, traffic tidak diarahkan ke layanan canary. Berikut adalah contoh konfigurasi.

  Perluas untuk melihat contoh YAML lengkap

  Untuk kluster versi 1.19 dan yang lebih baru

  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

  Untuk kluster versi sebelum 1.19

  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

• Alokasikan traffic berdasarkan bobot

  Parameter	Deskripsi	Contoh YAML
  alb.ingress.kubernetes.io/canary-weight	Menetapkan persentase permintaan ke layanan yang ditentukan. Nilainya adalah bilangan bulat dari 0 hingga 100.	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

  Contoh berikut mengonfigurasi bobot layanan canary menjadi 50%:

  Perluas untuk melihat contoh YAML lengkap

  Untuk kluster versi 1.19 dan yang lebih baru

  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

  Untuk kluster versi sebelum 1.19

  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

Implementasikan persistensi sesi menggunakan anotasi

ALB Ingress mendukung persistensi sesi melalui anotasi berikut.

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"   # Saat menggunakan cookie kustom, tipe penyisipan cookie harus Server.
    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

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"  # Saat menggunakan cookie kustom, tipe penyisipan cookie harus Server.
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      #Konfigurasikan jalur konteks.
      - path: /tea2
        pathType: ImplementationSpecific
        backend:
          serviceName: tea-svc
          servicePort: 80
      #Konfigurasikan jalur konteks.
      - path: /coffee2
        pathType: ImplementationSpecific
        backend:
          serviceName: coffee-svc
          servicePort: 80

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"   # Saat menggunakan cookie kustom, tipe penyisipan cookie harus Server.
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
... ...

Tentukan algoritma penyeimbangan beban untuk kelompok server backend

ALB Ingress dapat menentukan algoritma penyeimbangan beban untuk kelompok server backend menggunakan anotasi berikut. Nilai yang mungkin dan deskripsinya ditunjukkan dalam tabel berikut.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # Anda dapat mengatur ini ke wrr, sch, atau wlc sesuai kebutuhan.
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # Parameter ini hanya diperlukan saat algoritma penyeimbangan beban adalah uch. Tidak diperlukan untuk wrr, sch, atau wlc.
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # Anda juga dapat mengatur ini ke wrr, sch, atau wlc sesuai kebutuhan.
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # Parameter ini hanya diperlukan saat algoritma penyeimbangan beban adalah uch. Tidak diperlukan untuk wrr, sch, atau wlc.
  name: cafe-ingress
spec:
  ingressClassName: alb
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # Anda dapat mengatur ini ke wrr, sch, atau wlc sesuai kebutuhan.
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # Parameter ini hanya diperlukan saat algoritma penyeimbangan beban adalah uch. Tidak diperlukan untuk wrr, sch, atau wlc.
spec:
... ... 

Konfigurasi lintas domain

ALB Ingress mendukung parameter anotasi berikut untuk mengontrol perilaku lintas domain. Anda dapat menentukan situs yang diizinkan, metode permintaan, header permintaan dan respons, pembawa kredensial, serta waktu cache preflight (OPTIONS) untuk memenuhi persyaratan akses lintas domain dalam berbagai skenario keamanan dan bisnis.

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"
    alb.ingress.kubernetes.io/cors-allow-origin: "Allowed-cross-domain-name"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: cloud-nodeport
            port:
              number: 80

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"
    alb.ingress.kubernetes.io/cors-allow-origin: "Allowed-cross-domain-name"
spec:
... ...

Koneksi persisten backend

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-keepalive: "true"
spec:

Dukungan untuk memasang IPv6 ke kelompok server backend

Setelah Anda mengaktifkan pemasangan IPv6 untuk kelompok server, untuk memasang Pod IPv4 dan IPv6 ke kelompok server tersebut, Anda harus memastikan bahwa kluster telah mengaktifkan kemampuan dual-stack. Untuk informasi selengkapnya, lihat Buat Kluster ACK yang dikelola.

apiVersion: v1
kind: Service
metadata:
  name: tea-svc
  annotations:
spec:
  # Saat mengonfigurasi dual-stack, ipFamilies harus diatur ke IPv4 atau IPv6, dan ipFamilyPolicy harus diatur ke RequireDualStack atau PreferDualStack.
  ipFamilyPolicy: RequireDualStack
  ipFamilies:
  - IPv4
  - IPv6
  ports:
  - port: 80
    targetPort: 80
    protocol: TCP
  selector:
    app: tea
  type: NodePort
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: tea
spec:
  replicas: 2
  selector:
    matchLabels:
      app: tea
  template:
    metadata:
      labels:
        app: tea
    spec:
      containers:
      - name: tea
        image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
        ports:
        - containerPort: 80
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-ipv6: "true"
spec:
  ingressClassName: alb
  rules:
   - host: demo.alb.ingress.top
     http:
      paths:
      - path: /tea
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Service dan ALB Ingress harus dikonfigurasi sesuai persyaratan untuk dual-stack. Setelah Anda membuat instans ALB dual-stack, kelompok server dapat memasang server backend IPv4 dan IPv6.

apiVersion: v1
kind: Service
metadata:
  name: tea-svc
  annotations:
spec:
  # Saat mengonfigurasi dual-stack, ipFamilies harus diatur ke IPv4 atau IPv6, dan ipFamilyPolicy harus diatur ke RequireDualStack atau PreferDualStack.
  ipFamilyPolicy: RequireDualStack
  ipFamilies:
  - IPv4
  - IPv6
... ...

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-ipv6: "true"
spec:
... ...

Dukungan pembatasan kecepatan QPS

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/traffic-limit-qps: "50"
spec:
... ...

Backend mulai lambat

Setelah Pod baru ditambahkan ke backend Service, jika ALB Ingress langsung mengalokasikan traffic ke Pod baru tersebut, hal ini dapat menyebabkan tekanan CPU atau memori tinggi sementara, yang mengakibatkan gangguan akses. Dengan menggunakan mulai lambat, ALB Ingress dapat secara bertahap mentransfer traffic ke Pod baru tersebut, sehingga mengurangi dampak lonjakan traffic mendadak. Blok kode berikut menunjukkan contoh konfigurasi:

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

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

Connection draining

Saat sebuah Pod memasuki status Terminating, ALB Ingress menghapusnya dari kelompok server backend. Koneksi yang sudah terbentuk antara ALB dan Pod tersebut tidak langsung terputus. Akses klien terus meneruskan permintaan ke server backend tersebut. Hal ini dapat menyebabkan bisnis dalam Pod tidak dapat offline dalam waktu lama atau menyebabkan error permintaan. Untuk menghindari masalah ini, Anda dapat menggunakan fitur pengurasan koneksi ALB. Saat sebuah Pod dihapus atau pemeriksaan kesehatan abnormal, ALB Ingress mempertahankan transmisi normal untuk periode waktu tertentu lalu secara aktif memutus koneksi setelah waktu interupsi tercapai. Hal ini memastikan proses offline bisnis yang lancar. Untuk informasi selengkapnya, lihat Capai offline bisnis yang lancar melalui pengurasan koneksi ALB.

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: 80

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

Nonaktifkan penyeimbangan beban cross-zone

Secara bawaan, ALB mengaktifkan penyeimbangan beban cross-zone. Artinya, traffic didistribusikan secara merata ke layanan backend di berbagai zona dalam wilayah yang sama. Jika Anda menonaktifkan penyeimbangan beban cross-zone untuk kelompok server ALB, traffic hanya didistribusikan di antara layanan backend dalam zona yang sama dalam wilayah tersebut.

Anda dapat merujuk pada contoh berikut untuk menonaktifkan penyeimbangan beban cross-zone:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
... ...