Microservices Engine:Configurer un MseIngressConfig

Fonctionnement

MSE Ingress Controller surveille les resources MseIngressConfig dans votre cluster et maintient dynamiquement la passerelle cloud-native correspondante. Une fois la passerelle associée au serveur API de votre cluster, son plan de contrôle synchronise les modifications des resources Ingress et met à jour les règles de routage en temps réel. Lorsqu'elle reçoit une requête, la passerelle la compare aux règles de routage Ingress et transfère le trafic vers le pod backend approprié.

Le diagramme suivant illustre la relation entre les composants.

Les composants clés sont les suivants :

• Service : Abstraction des services backend. Un service représente un ensemble de pods répliqués.

• Ingress : Contient les règles de proxy inverse qui acheminent les requêtes HTTP ou HTTPS vers les services en fonction des noms d'hôte et des chemins d'accès.

• IngressClass : Déclare quelle implémentation de contrôleur Ingress gère un ensemble de resources Ingress. Associez une IngressClass à un MseIngressConfig pour activer la passerelle cloud-native MSE pour ces resources Ingress.

• MseIngressConfig : CRD fournissant la configuration de la passerelle, notamment les spécifications d'instance, les paramètres réseau, les politiques globales et la portée d'écoute Ingress.

• MSE Ingress Controller : Plan de contrôle qui surveille les resources MseIngressConfig et coordonne la passerelle cloud-native. Il n'agit pas comme plan de données réseau.

Un MseIngressConfig correspond exactement à une passerelle cloud-native MSE. Pour exécuter plusieurs passerelles, créez plusieurs MseIngressConfigs.

Référence 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"   # Leave blank to use the default project
    tracing:
      xTrace:
        sampleRate: "100"
  ingress:
    local:
      ingressClass: mse
      watchNamespace: ""      # Leave blank to listen to all namespaces

kubectl get mseingressconfig

NAME   STATUS     MESSAGE
test   Listening

Créer une passerelle cloud-native MSE

1. Appliquez un MseIngressConfig pour créer la passerelle. L'exemple suivant crée une passerelle nommée mse-ingress avec 3 réplicas selon la spécification 2c4g.

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

2. Créez une resource IngressClass et liez-la au 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

   Après l'application des deux resources, les resources Ingress avec l'IngressClass mse sont traitées par la passerelle cloud-native associée.

3. Vérifiez que la passerelle est opérationnelle.

   kubectl get mseingressconfig test

   L'état progresse selon la séquence Pending → Running → Listening. Lorsque l'état affiche Listening, la passerelle est prête.

Réutiliser une passerelle cloud-native MSE existante

Pour réutiliser une passerelle existante, définissez spec.id sur l'ID de la passerelle (au format gw-xxx) et contrôlez l'écrasement éventuel de sa configuration via spec.override.

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

Comportement de spec.override :

Supprimer une passerelle cloud-native MSE

La suppression d'un MseIngressConfig entraîne généralement la suppression de la passerelle associée. L'exception concerne les scénarios de réutilisation, où la passerelle est conservée.

Exécutez la commande suivante pour supprimer un MseIngressConfig :

kubectl delete mseingressconfig <your-config-name>

Comportement de suppression selon le scénario :

Configurer le contrôle d'accès 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

Activer Simple Log Service

Avant d'activer Simple Log Service (SLS), accordez les permissions SLS à MSE Ingress Controller selon votre type de cluster :

• Cluster ACK géré ou dédié : Consultez la section « Accorder des permissions à MSE Ingress Controller dans un cluster ACK dédié » dans Accorder des permissions à MSE Ingress Controller.

• Cluster ACK Serverless : Consultez la section « Accorder des permissions à MSE Ingress Controller dans un cluster ACK Serverless » dans Accorder des permissions à MSE Ingress Controller.

• Cluster ACS : Consultez la section « Accorder des permissions à MSE Ingress Controller dans un cluster ACS » dans Accorder des permissions à MSE Ingress Controller.

L'exemple suivant configure la passerelle pour envoyer les journaux d'accès à un projet SLS nommé demo. Pour utiliser le projet par défaut, laissez reuseProject vide.

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

Activer Managed Service for OpenTelemetry

La configuration de Managed Service for OpenTelemetry permet d'activer le traçage distribué de bout en bout afin de faciliter le diagnostic et la localisation des problèmes en production.

L'exemple suivant définit le taux d'échantillonnage à 100 %.

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