Container Service for Kubernetes:Konfigurasikan MseIngressConfig

Cara kerja

MSE Ingress Controller memantau resource MseIngressConfig di kluster Anda dan menjaga agar MSE cloud-native gateway terkait tetap sinkron. Kluster tersebut dapat berupa kluster managed Container Service for Kubernetes (ACK), kluster ACK Serverless, atau kluster ACS.

Setelah cloud-native gateway ditautkan ke server API kluster, lapisan kontrolnya menerima perubahan pada resource Ingress dan memperbarui aturan routing secara dinamis. Saat gateway menerima permintaan, ia mencocokkan permintaan tersebut dengan aturan routing Ingress dan meneruskan traffic ke Pod backend yang sesuai.

Komponen-komponen berikut bekerja sama dalam pengaturan ini:

• Service: Abstraksi atas sekelompok Pod backend yang direplikasi.

• Ingress: Menentukan aturan reverse proxy yang mengarahkan traffic HTTP atau HTTPS ke layanan berdasarkan hostname dan path URL.

• IngressClass: Mendeklarasikan controller Ingress mana yang menangani sekumpulan resource Ingress. Kaitkan MseIngressConfig dengan bidang parameters dari IngressClass untuk menerapkan logika routing MSE pada resource Ingress tersebut.

• MseIngressConfig: CRD yang mendefinisikan konfigurasi gateway—spesifikasi, pengaturan jaringan, kebijakan global, dan opsi observabilitas.

• MSE Ingress Controller: Lapisan kontrol yang mengelola cloud-native gateway berdasarkan definisi MseIngressConfig. Komponen ini tidak menangani traffic bidang data jaringan secara langsung.

Referensi MseIngressConfig

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  common:
    pay:
      payType: POSTPAY
    instance:
      spec: 4c8g
      replicas: 3
    network:
      vSwitches:
      - "vsw-1"
      - "vsw-2"
      publicSLBSpec: slb.s2.small
    securityGroupType: normal
  global:
    tls:
      enableHardwareAcceleration: true
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.2.XX.XX
  monitor:
    logging:
      sls:
        reuseProject: "xxx" # Biarkan kosong untuk menggunakan proyek default.
    tracing:
      openTelemetry:
        sampleRate: "100"
  ingress:
    local:
      ingressClass: mse
      watchNamespace: "" # Biarkan kosong untuk mendengarkan semua namespace.

kubectl get mseingressconfig

NAME   STATUS    AGE
test   Listening 5m

Buat MSE cloud-native gateway

1. Terapkan MseIngressConfig. Contoh berikut membuat gateway bernama mse-ingress dengan 3 replika dan 2 vCPU / 4 GB memori. Sesuaikan bidang lainnya sesuai kebutuhan.

   apiVersion: mse.alibabacloud.com/v1alpha1
   kind: MseIngressConfig
   metadata:
     name: reuse
   spec:
     id: gw-xxxx
     override: false
     ingress:
       local:
         ingressClass: mse

2. Buat resource IngressClass dan kaitkan dengan MseIngressConfig. Ini mendeklarasikan MSE Ingress Controller di kluster, sehingga resource Ingress yang ditautkan ke IngressClass ini akan ditangani oleh cloud-native gateway yang sesuai.

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: mse
   spec:
     controller: mse.alibabacloud.com/ingress
     parameters:
       apiGroup: mse.alibabacloud.com
       kind: MseIngressConfig
       name: test

3. Verifikasi status gateway:

   kubectl get mseingressconfig

   Status harus berubah dari Pending ke Running dan akhirnya ke Listening. Status Listening menegaskan bahwa gateway aktif dan memantau resource Ingress.

Gunakan ulang MSE cloud-native gateway yang sudah ada

Untuk menggunakan ulang gateway yang sudah ada, atur spec.id ke ID gateway (dalam format gw-xxx) dan konfigurasi spec.override untuk mengontrol apakah akan menimpa pengaturan gateway yang sudah ada.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: reuse
spec:
  id: gw-xxxx
  override: false
  ingress:
    local:
      ingressClass: mse

Perilaku berdasarkan `spec.override`:

• `false` (direkomendasikan untuk penggunaan ulang): Opsi pendengaran Ingress, akselerasi perangkat keras TLS, kontrol akses IP, dan pengaturan observabilitas gateway yang sudah ada dipertahankan. Jika gateway belum ditautkan ke kluster, MSE Ingress Controller secara otomatis menautkannya dan mengonfigurasi pendengaran Ingress berdasarkan spec.ingress.local.ingressClass. Jika gateway sudah ditautkan, opsi pendengaran Ingress yang sudah ada tidak diubah.

• `true`: Opsi pendengaran Ingress, akselerasi perangkat keras TLS, kontrol akses IP global, dan pengaturan observabilitas gateway ditimpa dengan nilai dari MseIngressConfig. Jika parameter tidak ditentukan dalam MseIngressConfig, pengaturan parameter asli gateway akan ditimpa dan traffic Anda mungkin terpengaruh. Pastikan semua parameter relevan telah diatur sebelum menerapkan.

Hapus MSE cloud-native gateway

Setiap MseIngressConfig dipetakan ke satu cloud-native gateway. Dalam skenario non-penggunaan ulang, penghapusan MseIngressConfig akan menghapus gateway terkait.

kubectl delete mseingressconfig your-config-name

Perilaku penghapusan bergantung pada metode penagihan dan cara gateway dibuat:

Konfigurasikan kontrol akses IP

Bidang global.ipAccessControl menerapkan filter IP di tingkat gateway, memengaruhi seluruh traffic yang melewati gateway. Anda dapat mengonfigurasi daftar putih, daftar hitam, atau keduanya.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  global:
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  global:
    ipAccessControl:
      blacklist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

Aktifkan Simple Log Service

Simple Log Service (SLS) mengirimkan log akses gateway ke proyek SLS yang ditentukan.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  monitor:
    logging:
      sls:
        # Biarkan kosong untuk mengirimkan log ke proyek default.
        reuseProject: "demo"

Aktifkan Managed Service for OpenTelemetry

Managed Service for OpenTelemetry mengaktifkan pelacakan end-to-end untuk permintaan yang melewati gateway, membantu Anda mendiagnosis dan menemukan masalah produksi.

Managed Service for OpenTelemetry dan OpenTelemetry versi open source tidak dapat diaktifkan secara bersamaan.

Atur monitor.tracing.openTelemetry.sampleRate ke persentase pengambilan sampel yang diinginkan. Contoh berikut mengaktifkan pelacakan dengan pengambilan sampel 100%.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  monitor:
    tracing:
      openTelemetry:
        sampleRate: "100"