Container Compute Service：Konfigurasi ALB Ingress Tingkat Lanjut

Meneruskan permintaan berdasarkan nama domain

Ikuti langkah-langkah berikut untuk membuat Ingress dengan nama domain dan Ingress tanpa nama domain, lalu gunakan Ingress tersebut untuk meneruskan permintaan.

Meneruskan permintaan berdasarkan jalur URL

Berikut adalah contoh dari ketiga metode pencocokan:

Konfigurasi pemeriksaan kesehatan

Anda dapat mengonfigurasi pemeriksaan kesehatan untuk Ingress ALB menggunakan anotasi berikut. Templat YAML berikut memberikan contoh cara membuat Ingress dengan pemeriksaan kesehatan yang diaktifkan.

Tembakan YAML berikut memberikan contoh cara membuat Ingress yang memiliki pemeriksaan kesehatan diaktifkan:

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

Konfigurasikan pengalihan dari permintaan HTTP ke permintaan HTTPS

Anda dapat menyetel anotasi alb.ingress.kubernetes.io/ssl-redirect: "true" dalam Ingress ALB untuk mengarahkan ulang permintaan HTTP ke Port HTTPS 443.

Contoh:

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

Konfigurasikan HTTPS atau gRPC sebagai protokol backend

ALB mendukung HTTPS dan gRPC sebagai protokol backend. Untuk mengonfigurasi protokol backend untuk Ingress ALB, Anda hanya perlu menyetel alb.ingress.kubernetes.io/backend-protocol: "grpc" atau alb.ingress.kubernetes.io/backend-protocol: "https" anotasi. Untuk menggunakan Ingress guna meneruskan layanan gRPC, nama domain yang sesuai harus memiliki Sertifikat SSL dan menggunakan protokol TLS. Contoh berikut menunjukkan konfigurasi sampel untuk protokol gRPC:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: lxd-grpc-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

Konfigurasikan ekspresi reguler

Untuk mengonfigurasi kondisi penerusan kustom, Anda dapat menulis ekspresi reguler di dalam bidang path. Contoh berikut menunjukkan konfigurasi sampel:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true" # Mendukung ekspresi reguler di dalam bidang path. 
   alb.ingress.kubernetes.io/conditions.service-a: | # Service yang ditentukan dalam anotasi harus merupakan Service yang ada di dalam kluster, dan nama Service harus sama dengan nama Service di backend dari bidang aturan. 
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*^/pathvalue1", # Ekspresi reguler harus mengikuti tanda ekspresi reguler ~ *. 
              "/pathvalue2" # Tidak perlu menambahkan ~ * sebelum path untuk kecocokan eksak. 
           ]
       }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
   - http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: service-a
            port:
              number: 88

Konfigurasikan aturan penulisan ulang

ALB mendukung fitur penulisan ulang. Untuk mengonfigurasi fitur ini untuk Ingress ALB, tambahkan anotasi alb.ingress.kubernetes.io/rewrite-target: /path/${2}. Aturan berikut berlaku:

• Dalam anotasi rewrite-target, variabel dalam format ${number} harus dikonfigurasi pada path yang pathType-nya diatur ke Prefix.

• Secara default, Anda tidak dapat menggunakan simbol ekspresi reguler, seperti * dan ?, di dalam bidang path. Anda harus mengonfigurasi anotasi rewrite-target untuk menggunakan simbol ekspresi reguler.

• path harus dimulai dengan /.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # Mendukung ekspresi reguler di dalam bidang path. 
    alb.ingress.kubernetes.io/rewrite-target: /path/${2} # Variabel yang cocok dengan ekspresi reguler digabungkan untuk membentuk jalur yang menimpa jalur aslinya. 
  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

Konfigurasikan port mendengarkan kustom

ALB Ingress memungkinkan Anda mengonfigurasi port mendengarkan kustom. Ini memungkinkan Anda mengekspos layanan melalui port 80 dan 443 secara bersamaan.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
   alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'  # Mengonfigurasi port mendengarkan kustom
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

Konfigurasikan prioritas aturan pengalihan

Jika Anda tidak ingin memodifikasi namespace/name dari Ingress, Anda dapat mengonfigurasi anotasi Ingress berikut untuk menentukan 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

Gunakan anotasi untuk melakukan rilis bertahap

ALB menyediakan kemampuan pengarahan lalu lintas yang kompleks dan mendukung rilis canary berdasarkan header, cookie, dan bobot. Anda dapat mengimplementasikan rilis canary dengan menyetel anotasi. Untuk mengaktifkan rilis canary, Anda harus menyetel anotasi alb.ingress.kubernetes.io/canary: "true". Anda dapat menggunakan anotasi yang berbeda untuk mengimplementasikan fitur rilis canary yang berbeda:

• alb.ingress.kubernetes.io/canary-by-header dan alb.ingress.kubernetes.io/canary-by-header-value: Aturan ini menentukan nilai dari header permintaan dan harus digunakan bersama dengan alb.ingress.kubernetes.io/canary-by-header.

  • Jika header dan header-value dalam permintaan cocok dengan nilai yang ditetapkan, permintaan dialokasikan ke titik akhir layanan rilis bertahap.

  • Untuk nilai header lainnya, header diabaikan, dan lalu lintas permintaan dialokasikan berdasarkan prioritas rilis bertahap ke layanan rilis bertahap yang ditetapkan oleh aturan lain.

  Jika header permintaan adalah location: hz, permintaan diarahkan ke layanan rilis canary. Permintaan dengan header lainnya diarahkan berdasarkan bobot rilis canary. Contoh berikut menunjukkan konfigurasi sampel:

  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

• alb.ingress.kubernetes.io/canary-by-cookie: Membagi lalu lintas berdasarkan cookie.

  • Jika nilai cookie disetel ke always, lalu lintas permintaan dialokasikan ke titik akhir layanan rilis bertahap.

  • Jika nilai cookie disetel ke never, lalu lintas permintaan tidak dialokasikan ke titik akhir layanan rilis bertahap.

  Catatan

  Rilis canary berbasis cookie hanya mendukung nilai always dan never. Nilai kustom tidak didukung.

  Jika cookie permintaan adalah demo=always, permintaan diarahkan ke layanan rilis canary. Contoh berikut menunjukkan konfigurasi sampel:

  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

• alb.ingress.kubernetes.io/canary-weight: Menentukan persentase permintaan yang diarahkan ke layanan canary. Nilainya harus berupa bilangan bulat dari 0 hingga 100.

  Dalam contoh berikut, persentase permintaan yang diarahkan ke versi aplikasi baru disetel menjadi 50%:

  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 menggunakan anotasi

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

Tentukan algoritma penyeimbangan beban untuk kelompok server backend

Ingress ALB memungkinkan Anda menentukan algoritma penyeimbangan beban untuk sebuah kelompok server dengan mengatur anotasi Ingress alb.ingress.kubernetes.io/backend-scheduler. Contoh berikut menunjukkan konfigurasi sampel. Secara default, versi kluster harus 1.19 atau lebih baru:

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

Konfigurasi CORS

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

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

Konfigurasikan Pembatasan 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