Container Compute Service:Konfigurasi ALB Ingress tingkat lanjut

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

• Kluster ACS. Untuk informasi lebih lanjut, lihat Create an ACS cluster.

• Objek AlbConfig. Untuk informasi lebih lanjut, lihat Getting started with ALB Ingress.

Referensi cepat anotasi

Semua konfigurasi ALB Ingress menggunakan anotasi Kubernetes. Tabel berikut mencantumkan anotasi yang dibahas dalam topik ini.

Alihkan permintaan berdasarkan nama domain

ALB Ingress mengarahkan permintaan masuk ke layanan berdasarkan bidang host dalam aturan Ingress. Bagian ini menunjukkan cara mengalihkan permintaan menggunakan domain bernama dan tanpa domain.

Alihkan permintaan berdasarkan path URL

Atur bidang pathType untuk mengontrol cara ALB Ingress mencocokkan path URL. Tiga jenis pencocokan didukung: Exact, ImplementationSpecific (default), dan Prefix.

Kebijakan pencocokan URL dapat bertentangan satu sama lain. Ketika terjadi bentrokan, permintaan dicocokkan berdasarkan urutan menurun prioritas kebijakan. Untuk detail selengkapnya, lihat Mengatur prioritas aturan pengalihan.

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

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

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

curl <ADDRESS>/hello

{"hello":"coffee"}

Konfigurasikan pemeriksaan kesehatan

Tambahkan anotasi pemeriksaan kesehatan ke Ingress agar ALB dapat memeriksa server backend dan secara otomatis menghapus server yang tidak sehat dari rotasi.

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

Alihkan HTTP ke HTTPS

Atur alb.ingress.kubernetes.io/ssl-redirect: "true" untuk mengalihkan semua 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: 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

Tetapkan protokol backend

ALB mendukung HTTPS dan gRPC sebagai protokol backend. Atur anotasi alb.ingress.kubernetes.io/backend-protocol menjadi "https" atau "grpc".

Protokol backend tidak dapat diubah setelah Ingress dibuat. Untuk mengubah protokol, hapus Ingress dan buat ulang.

Untuk gRPC, domain harus memiliki Sertifikat SSL dan menggunakan TLS. Contoh berikut mengonfigurasi backend gRPC:

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

Gunakan ekspresi reguler

Atur alb.ingress.kubernetes.io/use-regex: "true" untuk mengaktifkan pencocokan ekspresi reguler dalam bidang path. Gunakan anotasi alb.ingress.kubernetes.io/conditions.<service-name> untuk menentukan kondisi path kustom.

Layanan yang disebutkan dalam anotasi harus ada dalam kluster dan sesuai dengan nama layanan dalam bidang backend aturan.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"
   alb.ingress.kubernetes.io/conditions.service-a: |
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*^/pathvalue1",
              "/pathvalue2"
           ]
       }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
   - http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: service-a
            port:
              number: 88

Pola ekspresi reguler harus menggunakan awalan flag ~* (misalnya, ~*^/pathvalue1). Path pencocokan eksak tidak memerlukan awalan ~*.

Konfigurasikan aturan penulisan ulang

Gunakan alb.ingress.kubernetes.io/rewrite-target bersama dengan alb.ingress.kubernetes.io/use-regex: "true" untuk menulis ulang path permintaan sebelum mencapai backend.

Aturan:

• Variabel dalam format ${number} harus digunakan pada path yang pathType-nya Prefix.

• Maksimal tiga variabel grup tangkapan didukung: ${1}, ${2}, dan ${3}.

• path harus dimulai dengan /.

• Secara default, * dan ? tidak diperbolehkan dalam bidang path. Aktifkan use-regex untuk menggunakannya.

Contoh berikut menulis ulang path yang cocok dengan /something(/|$)(.*):

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

Variabel ${2} menangkap segmen path setelah /something/. Backend menerima path berikut:

Untuk penulisan ulang multi-grup, pertimbangkan contoh ini: path diatur ke /sys/(.*)/(.*)/aaa dan rewrite-target diatur ke /${1}/${2}. Permintaan ke /sys/ccc/bbb/aaa cocok dengan pola — ${1} diganti dengan ccc dan ${2} dengan bbb — sehingga backend menerima /ccc/bbb.

Konfigurasikan port pendengar kustom

Atur alb.ingress.kubernetes.io/listen-ports untuk mengekspos layanan pada beberapa port secara bersamaan — misalnya, HTTP pada port 80 dan HTTPS pada port 443.

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

Tetapkan prioritas aturan pengalihan

Secara default, ALB Ingress memprioritaskan aturan pengalihan sebagai berikut:

• Ingress diberi peringkat berdasarkan urutan leksikografis namespace/nama. Nilai yang lebih rendah berarti prioritas lebih tinggi.

• Dalam Ingress yang sama, aturan dicocokkan dari atas ke bawah sesuai urutan kemunculannya dalam bidang rules.

Untuk mengganti peringkat default tanpa mengganti nama Ingress, gunakan anotasi alb.ingress.kubernetes.io/order.

Prioritas harus unik dalam pendengar yang sama. Nilainya harus berupa bilangan bulat dari 1 hingga 1.000. Nilai yang lebih rendah berarti prioritas lebih tinggi. Default-nya adalah 10.

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

Rilis canary

ALB Ingress mendukung rilis canary yang mengarahkan sebagian kecil trafik ke versi baru layanan Anda. Tiga metode pemisahan trafik tersedia: berbasis header, berbasis cookie, dan berbasis bobot.

Aktifkan rilis canary pada Ingress dengan mengatur alb.ingress.kubernetes.io/canary: "true", lalu tambahkan anotasi pengarahan yang sesuai.

Canary rule priority: berbasis header > berbasis cookie > berbasis bobot.

Selama pengujian canary, jangan ubah aturan Ingress asli — hal ini dapat mengganggu trafik. Setelah versi baru lolos pengujian, perbarui layanan backend dalam Ingress asli dan hapus Ingress 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
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - backend:
              service:
                name: demo-service-hello
                port:
                  number: 80
            path: /hello
            pathType: ImplementationSpecific

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

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

Konfigurasikan persistensi sesi

ALB Ingress mengarahkan permintaan dari klien yang sama ke server backend yang sama melalui beberapa koneksi. Konfigurasikan persistensi sesi menggunakan 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"
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - path: /tea2
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      - path: /coffee2
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

Tetapkan algoritma penyeimbangan beban

Gunakan alb.ingress.kubernetes.io/backend-scheduler untuk menetapkan algoritma penyeimbangan beban untuk grup server backend. Versi kluster harus 1.19 atau lebih baru.

Empat algoritma didukung:

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

Konfigurasikan CORS

Atur alb.ingress.kubernetes.io/enable-cors: "true" untuk mengaktifkan Cross-Origin Resource Sharing (CORS) pada ALB Ingress.

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

Aktifkan koneksi persisten backend

Secara default, ALB menggunakan koneksi singkat ke grup server backend — setiap permintaan membuka lalu menutup koneksi TCP. Koneksi persisten menggunakan kembali koneksi TCP yang ada untuk beberapa permintaan, mengurangi overhead koneksi dan meningkatkan throughput di bawah beban tinggi.

Atur alb.ingress.kubernetes.io/backend-keepalive: "true" untuk mengaktifkan fitur ini:

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

Konfigurasikan pembatasan kecepatan QPS

Atur alb.ingress.kubernetes.io/traffic-limit-qps untuk membatasi jumlah permintaan per detik (QPS) untuk aturan pengalihan. Nilainya harus berupa bilangan bulat dari 1 hingga 100.000.

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

Langkah selanjutnya

• Use AlbConfigs to configure ALB listeners

• Getting started with ALB Ingress

• Create an ACS cluster