Microservices Engine:Use MSE Ingress gateways to access services in ACK clusters and ACS clusters

Funcionamiento

Cuando se crea un recurso Kubernetes Ingress con ingressClassName: mse, MSE Ingress Controller lo detecta y lo traduce en una ruta dentro de la puerta de enlace nativa de la nube de MSE. El tráfico entrante pasa por una instancia de load balancer asociada a la puerta de enlace y se reenvía al servicio de destino en el clúster.

Client → CLB/NLB → MSE cloud-native gateway → Kubernetes Service → Pod

Requisitos previos

Antes de empezar, compruebe que cuenta con lo siguiente:

Condiciones que debe verificar:

• Un clúster administrado de ACK, un clúster ACK Serverless o un clúster de Container Compute Service (ACS) que ejecute la versión V1.18 o posterior. Para actualizar un clúster anterior, consulte Manually update ACK clusters.

Acciones que debe completar:

• Permisos otorgados a MSE Ingress Controller:

  • Para clústeres administrados de ACK y clústeres ACK Serverless: Otorgar permisos

  • Para clústeres ACS: Otorgar permisos

Descripción general de los pasos

Este tutorial abarca cuatro pasos:

1. Instalar MSE Ingress Controller

2. Desplegar un servicio de backend

3. Configurar una regla de MSE Ingress

4. Acceder al servicio

Paso 1: Instalar MSE Ingress Controller

1. En la página Add-ons, introduzca mse en el cuadro de búsqueda y haga clic en Install en la tarjeta MSE Ingress Controller.

   

2. En el cuadro de diálogo Install MSE Ingress Controller, configure los parámetros y haga clic en OK.

   Clústeres administrados de ACK o clústeres ACK Serverless

   Clústeres administrados de ACK y clústeres ACK Serverless: se crea automáticamente una puerta de enlace nativa de la nube Professional Edition con modelo pay-as-you-go. Esta incluye un nodo de 4 núcleos de CPU y 8 GB de memoria, además de una instancia de Classic Load Balancer (CLB) Standard I (slb.s2.small) basada en el tipo de red especificado. Estas especificaciones se pueden modificar después de la creación.

   ACS

   Clústeres ACS: se crea automáticamente una puerta de enlace nativa de la nube serverless con una instancia de Network Load Balancer (NLB) basada en el tipo de red especificado.

   Importante

   Si aparece el error Failed to pass the precheck., otorgue permisos a MSE Ingress Controller e inténtelo de nuevo: - Para clústeres administrados de ACK y clústeres ACK Serverless: Grant permissions - Para clústeres ACS: Otorgar permisos

3. Espere a que la puerta de enlace alcance el estado Listening (normalmente entre 3 y 5 minutos). Después de la instalación, el sistema crea un recurso MseIngressConfig llamado mse-ingress-pro/serverless-{clusterid} y un recurso IngressClass llamado mse. La puerta de enlace escucha automáticamente los recursos Ingress con ingressClassName: mse en el clúster. Para comprobar el estado de la puerta de enlace en la consola de ACK, haga clic en el nombre del clúster y luego elija Workloads > Deployments > Custom Resources. En la pestaña Resource Objects, busque mse en la sección API Group para ver el recurso MseIngressConfig. Los estados de la puerta de enlace cambian en este orden: Para comprobarlo con kubectl, ejecute:

   Importante

   • El ciclo de vida de MseIngressConfig está vinculado a la instancia de la puerta de enlace nativa de la nube de MSE. Si elimina un recurso MseIngressConfig, también se elimina la puerta de enlace asociada. No elimine recursos MseIngressConfig a menos que se le indique. - Si ya existe un IngressClass llamado mse en el clúster antes de la instalación, el sistema no crea automáticamente una nueva puerta de enlace ni un recurso MseIngressConfig.

   Estado	Significado
   Pending	La puerta de enlace se está creando. Espere aproximadamente 3 minutos.
   Running	La puerta de enlace se creó y se está ejecutando.
   Listening	La puerta de enlace se está ejecutando y escucha los recursos Ingress.
   Failed	La puerta de enlace se encuentra en un estado no válido. Revise Message en el campo Status para conocer la causa.

   kubectl get mseingressconfig
   kubectl get ingressclass mse

   

4. Inicie sesión en la consola de MSE y confirme que aparece una puerta de enlace nativa de la nube llamada mse-ingress-pro/serverless-{clusterid} en su región.

Paso 2: Desplegar un servicio de backend

1. En la página Deployments, haga clic en Create from YAML y aplique el siguiente manifiesto para desplegar un Deployment y un Service httpbin en el namespace default.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: httpbin
     template:
       metadata:
         labels:
           app: httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse-ingress/go-httpbin
             args:
               - "--version=v1"
             imagePullPolicy: Always
             name: httpbin
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: httpbin
     namespace: default
   spec:
     ports:
       - port: 8080
         protocol: TCP
     selector:
       app: httpbin

2. Compruebe que el Deployment se está ejecutando:

   kubectl get deployment httpbin

   La salida debe mostrar READY 1/1 y AVAILABLE 1:

   NAME      READY   UP-TO-DATE   AVAILABLE   AGE
   httpbin   1/1     1            1           30s

Paso 3: Configurar una regla de MSE Ingress

1. En la página Ingresses, haga clic en Create Ingress.

2. En el cuadro de diálogo Create Ingress:

   • Establezca Gateway Type en MSE Ingress.

   • Establezca Ingress Class en mse.

   • Configure una ruta: seleccione Prefix (Prefix-based Match) en la lista desplegable Rule, introduzca / en el campo Path y seleccione httpbin en la lista desplegable Service.

   • Haga clic en OK.

3. Inicie sesión en la consola de MSE y confirme que la puerta de enlace nativa de la nube tiene una ruta cuyo nombre contiene httpbin.

   

Paso 4: Acceder al servicio

1. Obtenga la dirección IP de la puerta de enlace con cualquiera de estos métodos: Desde la consola de ACK o ACS: Vaya a Network > Ingresses y consulte el endpoint de Ingress. Desde la consola de MSE: Vaya a Cloud-native Gateway > Gateways, haga clic en el nombre de la puerta de enlace y consulte la dirección IP del load balancer en la página Overview.

   Clústeres administrados de ACK o clústeres ACK Serverless

   Clústeres ACK/Serverless:

   ACS

   Clústeres ACS:

   

2. Use un navegador web, cmd u otra herramienta de línea de comandos para enviar una solicitud a <gateway-IP>/version y compruebe que el servicio es accesible.

   

Pasos siguientes

• MSE Ingress management — Conozca cómo funcionan las puertas de enlace MSE Ingress y explore opciones de configuración avanzadas como HTTPS, lanzamientos canary y observability.