Container Compute Service:Konfigurasikan Instans ALB Menggunakan AlbConfig

Prasyarat

• ALB Ingress Controller telah diinstal.

• Anda telah membuat dua vSwitch di zona berbeda. vSwitch tersebut harus berada dalam VPC yang sama dengan kluster. Untuk informasi lebih lanjut, lihat Membuat dan mengelola vSwitch.

Catatan

• Kami merekomendasikan Anda menggunakan perintah kubectl edit untuk langsung memodifikasi dan memperbarui konfigurasi sumber daya. Jika Anda harus menggunakan perintah kubectl apply untuk memodifikasi dan memperbarui sumber daya, sebelum menjalankan perintah kubectl apply, jalankan terlebih dahulu perintah kubectl diff untuk melihat pratinjau perubahan. Pastikan bahwa perubahan sesuai dengan yang diharapkan, lalu jalankan perintah kubectl apply untuk menerapkan perubahan ke kluster Kubernetes.

• Versi lama dari Nginx Ingress Controller tidak dapat mengenali bidang spec.ingressClassName dalam sumber daya Ingress. Jika baik Nginx Ingress maupun ALB Ingress ada dalam sebuah kluster, versi lama dari Nginx Ingress Controller mungkin bertentangan dengan ALB Ingress atau menimpa konfigurasinya. Untuk menghindari masalah ini, lakukan peningkatan Nginx Ingress Controller ke versi terbaru, atau gunakan anotasi untuk menentukan ingressClass untuk ALB Ingress. Untuk informasi lebih lanjut, lihat Fitur lanjutan dari ALB Ingress.

Membuat AlbConfig

Sebuah AlbConfig berkorespondensi dengan satu instans ALB tetapi dapat dikaitkan dengan beberapa Ingress, menciptakan hubungan satu-ke-banyak. Untuk menggunakan beberapa instans ALB, Anda harus membuat beberapa AlbConfig. Ikuti langkah-langkah berikut untuk membuat AlbConfig.

1. Buat file bernama alb-test.yaml dan salin konten berikut ke dalamnya. File ini digunakan untuk membuat AlbConfig.

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: alb-demo
   spec:
     config:
       name: alb-test
       addressAllocatedMode: Dynamic          # Nilainya bisa Dynamic atau Fixed. Parameter ini menentukan mode IP dari instans ALB.
       addressType: Internet
       zoneMappings:                          # Untuk memastikan ketersediaan tinggi, pilih setidaknya dua vSwitch di zona yang berbeda.
       - vSwitchId: vsw-uf6ccg2a9g71hx8go**** # Ganti dengan ID vSwitch sebenarnya (di Zona 1). 
       - vSwitchId: vsw-uf6nun9tql5t8nh15**** # Ganti dengan ID vSwitch sebenarnya (di Zona 2, yang harus berbeda dari yang pertama).  
     listeners:
       - port: 80
         protocol: HTTP

   Parameter	Deskripsi
   spec.config.name	(Opsional) Nama instans ALB.
   spec.config.addressType	(Diperlukan) Jenis alamat load balancer. Nilai valid: Internet (default): Load balancer memiliki alamat IP publik. Nama domain diarahkan ke alamat IP publik. Load balancer dapat diakses melalui Internet. Intranet: Load balancer hanya memiliki alamat IP pribadi. Nama domain diarahkan ke alamat IP pribadi. Load balancer hanya dapat diakses di dalam VPC tempat ia berada.
   spec.config.zoneMappings	(Diperlukan) ID vSwitch untuk ALB Ingress. Di wilayah dengan beberapa zona, tentukan ID setidaknya dua vSwitch di zona yang berbeda. Untuk wilayah dengan satu zona, tentukan satu ID vSwitch. vSwitch yang ditentukan harus berada di zona yang mendukung ALB dan di VPC yang sama dengan kluster. Untuk informasi lebih lanjut tentang wilayah dan zona yang mendukung ALB, lihat Wilayah dan zona yang mendukung ALB. Penting Anda tidak dapat memperbarui jenis alamat dan zona instans ALB. Parameter addressType dan zoneMappings dalam AlbConfig hanya berlaku saat Anda membuat AlbConfig. Mereka tidak dapat diperbarui.
   spec.config.addressAllocatedMode	(Opsional) Dalam ALBConfig, Anda dapat menggunakan parameter addressAllocatedMode untuk menentukan mode IP dari instans ALB. Nilai valid: Dynamic: mode IP dinamis. Fixed: mode IP statis.

   Saat Anda menginstal komponen ALB Ingress Controller untuk sebuah kluster, AlbConfig dibuat secara default. Kecuali untuk vSwitchId, parameter lainnya menggunakan konfigurasi default seperti yang ditunjukkan di bawah ini.

   Klik untuk melihat konfigurasi default dari AlbConfig

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: alb-demo                      # Nama AlbConfig
   spec:
     config:
       accessLogConfig:
         logProject: ""
         logStore: ""
       addressAllocatedMode: Dynamic # Dalam AlbConfig, Anda dapat menggunakan parameter addressAllocatedMode untuk menentukan mode IP dari instans ALB. Nilai valid adalah Dynamic (mode IP dinamis) dan Fixed (mode IP statis).
       addressType: Internet
       billingConfig:
         internetBandwidth: 0
         internetChargeType: ""
         payType: PostPay
       deletionProtectionEnabled: true
       edition: Standard
       forceOverride: false
       zoneMappings:                                 # Untuk memastikan ketersediaan tinggi, pilih setidaknya dua vSwitch di zona yang berbeda.
       - vSwitchId: vsw-wz92lvykqj1siwvif****        # Ganti dengan ID vSwitch sebenarnya (di Zona 1).
       - vSwitchId: vsw-wz9mnucx78c7i6iog****        # Ganti dengan ID vSwitch sebenarnya (di Zona 2, yang harus berbeda dari yang pertama).
   status:
     loadBalancer:
       dnsname: alb-s2em8fr9debkg5****.cn-shenzhen.alb.aliyuncs.com
       id: alb-s2em8fr9debkg5****

2. Jalankan perintah berikut untuk membuat AlbConfig.

   kubectl apply -f alb-test.yaml

   Output yang diharapkan:

   albconfig.alibabacloud.com/alb-demo created

3. Jalankan perintah berikut untuk mengambil nama AlbConfig.

   kubectl -n kube-system get AlbConfig

   Output yang diharapkan:

   NAME       ALBID        DNSNAME                                  PORT&PROTOCOL   CERTID                 AGE
   alb-demo   alb-******   alb-******.<regionID>.alb.aliyuncs.com   443/HTTPS       11055487-cn-<regionID>  2d

Perbarui sebuah AlbConfig

Dalam Kubernetes, perintah kubectl apply melakukan pembaruan dengan menimpa, sedangkan perintah kubectl edit melakukan pembaruan tambahan pada objek yang sudah ada. Untuk mengubah konfigurasi instans Application Load Balancer (ALB) yang dibuat dari AlbConfig, gunakan perintah kubectl edit untuk melakukan pembaruan tambahan. Ikuti langkah-langkah berikut untuk memperbarui sebuah AlbConfig.

1. Jalankan perintah berikut untuk melihat nama AlbConfig.

   kubectl -n kube-system get AlbConfig

   Output yang diharapkan:

   NAME       ALBID        DNSNAME                                  PORT&PROTOCOL   CERTID                 AGE
   alb-demo   alb-******   alb-******.<regionID>.alb.aliyuncs.com   443/HTTPS       11055487-cn-<regionID>  2d

2. Jalankan perintah berikut untuk memperbarui AlbConfig.

   Penting

   • Kami merekomendasikan Anda menggunakan perintah kubectl edit untuk memperbarui konfigurasi sumber daya secara langsung. Jika Anda harus menggunakan perintah kubectl apply untuk memperbarui sebuah sumber daya, jalankan terlebih dahulu perintah kubectl diff untuk melihat pratinjau perubahan. Verifikasi bahwa perubahan sesuai dengan yang diharapkan. Kemudian, gunakan perintah kubectl apply untuk menerapkan perubahan ke kluster Kubernetes.

   • Saat Anda menggunakan perintah kubectl apply untuk menimpa sebuah AlbConfig, pendengar yang ada tidak akan terpengaruh jika file YAML AlbConfig tidak berisi konfigurasi pendengar. Jika konfigurasi ini ada, pendengar akan disesuaikan kembali berdasarkan konfigurasi baru. Oleh karena itu, Anda harus menentukan semua pendengar yang diperlukan, seperti pendengar umum pada port 80 dan 443.

   kubectl -n kube-system edit AlbConfig alb-demo

   Dalam file konfigurasi AlbConfig, perbarui konten sesuai kebutuhan. Sebagai contoh, ubah nama AlbConfig menjadi test.

   ...
    spec:
      config:
        name: test # Masukkan nama yang diperbarui.
   ...

Gunakan IngressClass untuk mengaitkan AlbConfig dengan Ingress

Anda dapat mengaitkan AlbConfig dengan Ingress menggunakan sumber daya IngressClass Kubernetes standar. Pertama, buat IngressClass, lalu gunakan untuk mengaitkan AlbConfig.

1. Buat file bernama alb.yaml dan salin konten berikut ke dalamnya untuk membuat IngressClass.

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: alb
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: alb-demo

2. Jalankan perintah berikut untuk membuat IngressClass.

   kubectl apply -f alb.yaml

   Output yang diharapkan:

   ingressclass.networking.k8s.io/alb created

3. Buat file bernama ingress.yaml dan salin konten berikut ke dalamnya. Parameter ingressClassName digunakan untuk mengaitkan AlbConfig dengan IngressClass bernama alb.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: cafe-ingress 
   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

4. Jalankan perintah berikut untuk membuat Ingress.

   kubectl apply -f ingress.yaml

   Output yang diharapkan:

   ingress.networking.k8s.io/cafe-ingress created

Setelah Anda menyelesaikan langkah-langkah ini, AlbConfig dikaitkan dengan Ingress melalui IngressClass.

Ubah nama instans ALB

kubectl -n kube-system edit AlbConfig alb-demo

...
  spec:
    config:
      name: test   # Masukkan nama yang telah diubah.
...

Menggunakan alamat IPv6

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    addressIpVersion: DualStack
    ...

Tentukan kebijakan keamanan TLS

Saat Anda mengonfigurasi Pendengar HTTPS di AlbConfig, Anda dapat menentukan kebijakan keamanan TLS. Anda dapat memilih dari kebijakan kustom dan kebijakan sistem default. Untuk informasi lebih lanjut, lihat Kebijakan keamanan TLS.

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    #...
  listeners:
  - port: 443
    protocol: HTTPS
    securityPolicyId: tls_cipher_policy_1_1
  #...

Aktifkan log akses di Simple Log Service

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    accessLogConfig:
      logProject: "k8s-log-xz92lvykqj1siwvif****"
      logStore: "alb_****"
    #...

Gunakan kembali instans ALB yang ada

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: reuse-alb
spec:
  config:
    id: **** # ID dari instans ALB Edisi Standar atau instans dengan WAF yang dibuat di konsol ALB.
    forceOverride: false
    listenerForceOverride: false

Membuat dan menggunakan beberapa instans ALB

Untuk menggunakan beberapa instans ALB, tentukan IngressClasses yang berbeda di dalam Ingress menggunakan parameter spec.ingressClassName.

1. Buat file bernama alb-demo2.yaml dan salin konten berikut ke dalamnya untuk membuat AlbConfig.

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: demo
   spec:
     config:
       name: alb-demo2                        # Nama dari instans ALB.
       addressType: Internet                  # Load balancer memiliki alamat IP publik.
       zoneMappings:                          # Untuk memastikan ketersediaan tinggi, pilih setidaknya dua vSwitch di zona yang berbeda.
       - vSwitchId: vsw-uf6ccg2a9g71hx8go**** # Ganti dengan ID vSwitch sebenarnya (di Zona 1).
       - vSwitchId: vsw-uf6nun9tql5t8nh15**** # Ganti dengan ID vSwitch sebenarnya (di Zona 2, yang harus berbeda dari yang pertama).

2. Jalankan perintah berikut untuk membuat AlbConfig.

   kubectl apply -f alb-demo2.yaml

   Output yang diharapkan:

   AlbConfig.alibabacloud.com/demo created

3. Buat file bernama alb.yaml dan salin konten berikut ke dalamnya untuk membuat IngressClass.

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: alb-demo2
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: demo

4. Jalankan perintah berikut untuk membuat IngressClass.

   kubectl apply -f alb.yaml

   Output yang diharapkan:

   ingressclass.networking.k8s.io/alb-demo2 created

5. Buat file bernama ingress.yaml dan salin konten berikut ke dalamnya. File ini menggunakan parameter ingressClassName untuk menentukan instans ALB yang berbeda.

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

Atur periode waktu habis untuk permintaan koneksi Pendengar

Dalam sebuah AlbConfig, Anda dapat mengatur waktu habis untuk permintaan koneksi pada Pendengar. Waktu habis dapat diatur dari 1 hingga 180 detik. Jika server backend tidak merespons dalam periode waktu habis, load balancer akan berhenti menunggu dan mengembalikan kode kesalahan HTTP 504 kepada Klien. Jika Anda tidak menentukan waktu habis, nilai default 60 detik akan digunakan. File YAML berikut memberikan contoh.

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    requestTimeout: 60
  ...

Gunakan fitur kompresi data

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    gzipEnabled: false
  ...

Mendapatkan Alamat IP Asal Klien

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    #...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForEnabled: true
  #...

Memperoleh protokol pendengar dari sebuah instans

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForProtoEnabled: true
  ...

Memperoleh ID dari instans load balancer

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForSLBIdEnabled: true
  ...

Memperoleh port pendengar dari sebuah instans

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForSLBPortEnabled: true
  ...

Memperoleh port klien dari instans load balancer

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForClientSrcPortEnabled: true
  ...

Konfigurasikan kontrol akses berbasis ACL

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
   #...
  listeners:
  - port: 80
    protocol: HTTPS
    aclConfig:
      aclEntries:
      - 127.0.0.1/32
      aclType: White
  #...

Hapus Instans ALB

Sebuah instans ALB berkorespondensi dengan sebuah AlbConfig. Oleh karena itu, Anda dapat menghapus instans ALB dengan menghapus AlbConfig-nya. Sebelum Anda menghapus AlbConfig, Anda harus terlebih dahulu menghapus semua Ingress yang terkait dengannya.

kubectl delete -n kube-system AlbConfig alb-demo

Ganti alb-demo dengan nama AlbConfig yang ingin Anda hapus.

Hapus AlbConfig dari instans ALB yang digunakan kembali

Untuk menghapus AlbConfig dari instans ALB yang digunakan kembali, ikuti langkah-langkah berikut.

1. Hapus semua Ingress yang terkait dengan AlbConfig.

   kubectl delete -n <NAMESPACE> ingress <INGRESS_NAME>  # Ganti <INGRESS_NAME> dan <NAMESPACE> dengan nama dan namespace dari Ingress yang ingin Anda hapus.

2. Jalankan perintah kubectl edit untuk memodifikasi AlbConfig dan menghapus semua Pendengarnya. Ini berarti menghapus semua entri di bawah bidang spec.listeners.

   Penting

   Lakukan langkah ini hanya jika versi Komponen ALB Ingress Controller yang diinstal di kluster adalah v2.10.0-aliyun.1 atau lebih lama. Jika tidak, lewati langkah ini.

3. Hapus AlbConfig.

   kubectl -n kube-system delete AlbConfig alb-demo # Ganti alb-demo dengan nama AlbConfig yang ingin Anda hapus.