Container Service for Kubernetes:Konfigurasikan MseIngressConfig

Cara kerja

MSE Ingress Controller memantau sumber daya MseIngressConfig di kluster Anda dan secara dinamis mengelola siklus hidup gateway cloud-native yang sesuai serta asosiasinya dengan kluster ACK yang dikelola, ACK Serverless, dan ACS. Setelah gateway diasosiasikan dengan server API kluster ACK yang dikelola, ACK Serverless, atau ACS, lapisan kontrolnya menyinkronkan perubahan sumber daya Ingress dan memperbarui aturan routing secara real time. Saat menerima permintaan, gateway mencocokkan permintaan tersebut dengan aturan routing Ingress dan meneruskan traffic ke Pod backend yang sesuai.

Diagram berikut menunjukkan hubungan antar komponen.

Komponen utama meliputi:

• Service: Abstraksi dari layanan backend. Service merepresentasikan sekelompok Pod yang direplikasi.

• Ingress: Berisi aturan reverse proxy yang mengarahkan permintaan HTTP atau HTTPS ke layanan berdasarkan hostname dan path.

• IngressClass: Mendeklarasikan implementasi Ingress controller mana yang menangani sekumpulan sumber daya Ingress. Asosiasikan IngressClass dengan MseIngressConfig untuk mengaktifkan gateway cloud-native MSE bagi sumber daya Ingress tersebut.

• MseIngressConfig: CRD yang menyediakan konfigurasi gateway—spesifikasi instans, pengaturan jaringan, kebijakan global, dan cakupan pendengaran Ingress.

• MSE Ingress Controller: Lapisan kontrol yang mengelola instans gateway cloud-native MSE dan konfigurasinya. Ini bukan bidang data jaringan. Ia memantau sumber daya MseIngressConfig di kluster dan mengoordinasikan instans gateway cloud-native MSE untuk menerapkan aturan manajemen traffic yang dijelaskan oleh sumber daya Ingress.

Satu MseIngressConfig dipetakan tepat ke satu gateway cloud-native MSE. Untuk menjalankan beberapa gateway, buat beberapa MseIngressConfig.

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     MESSAGE
test   Listening

Buat gateway cloud-native MSE

1. Terapkan MseIngressConfig untuk membuat gateway. Contoh berikut membuat gateway bernama mse-ingress dengan 3 replika pada spesifikasi 2c4g.

   apiVersion: mse.alibabacloud.com/v1alpha1
   kind: MseIngressConfig
   metadata:
     name: test
   spec:
     name: mse-ingress
     common:
       instance:
         spec: 2c4g
         replicas: 3

2. Buat sumber daya IngressClass dan hubungkan ke MseIngressConfig.

   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

   Setelah menerapkan kedua sumber daya tersebut, sumber daya Ingress dengan IngressClass mse akan diproses oleh gateway cloud-native yang diasosiasikan.

3. Verifikasi bahwa gateway sedang berjalan.

   kubectl get mseingressconfig test

   Status berlangsung melalui Pending → Running → Listening. Saat status menunjukkan Listening, gateway siap digunakan.

Gunakan kembali gateway cloud-native MSE yang sudah ada

Untuk menggunakan kembali gateway yang sudah ada, atur spec.id ke ID gateway (dalam format gw-xxx) dan kendalikan apakah akan menimpa konfigurasinya dengan spec.override.

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

spec.override perilaku:

Hapus gateway cloud-native MSE

Menghapus MseIngressConfig umumnya juga menghapus gateway yang diasosiasikan. Pengecualian terjadi pada skenario penggunaan kembali, di mana gateway tetap dipertahankan.

Jalankan perintah berikut untuk menghapus MseIngressConfig:

kubectl delete mseingressconfig <nama-konfigurasi-anda>

Perilaku penghapusan berdasarkan skenario:

Konfigurasikan kontrol akses IP

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

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

Aktifkan Simple Log Service

Sebelum mengaktifkan Simple Log Service (SLS), berikan izin SLS kepada MSE Ingress Controller sesuai jenis kluster Anda:

• Untuk kluster ACK yang dikelola atau kluster khusus ACK, ikuti bagian kluster khusus ACK di Berikan izin kepada MSE Ingress Controller.

• Untuk kluster ACK Serverless, ikuti bagian kluster ACK Serverless di Berikan izin kepada MSE Ingress Controller.

• Untuk kluster ACS, ikuti bagian kluster ACS di Berikan izin kepada MSE Ingress Controller.

Contoh berikut mengonfigurasi gateway untuk mengirimkan log akses ke proyek SLS bernama demo. Untuk menggunakan proyek default, biarkan reuseProject kosong.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    logging:
      sls:
        reuseProject: "demo"

Aktifkan Managed Service for OpenTelemetry

Mengonfigurasi Managed Service for OpenTelemetry mengaktifkan pelacakan terdistribusi end-to-end untuk membantu mendiagnosis dan menemukan masalah produksi.

Contoh berikut mengatur laju pengambilan sampel menjadi 100%.

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

Konfigurasi tambahan

Instans gateway cloud-native MSE yang digunakan oleh MSE Ingress mendukung konfigurasi tambahan berikut.

Untuk menerapkan konfigurasi ini, login ke Konsol MSE, buka Cloud-native Gateway > Gateways, temukan instans gateway yang sudah ada atau yang dibuat otomatis oleh MSE Ingress Controller (ID instans menggunakan format mse_ingresspost-*****), klik ID instans tersebut, lalu klik Parameters di panel navigasi sebelah kiri.