Create an ASM ingress gateway to unify access to a Kubernetes cluster - Alibaba Cloud Service Mesh

Despliegue una puerta de enlace de entrada de ASM en su clúster de Kubernetes para crear un punto de entrada público o privado unificado para su aplicación. Una puerta de enlace de entrada simplifica la gestión del tráfico al funcionar como un único punto de acceso. Utiliza balanceo de carga de capa 7 para enrutar el tráfico hacia los servicios de backend según atributos como las rutas de solicitud HTTP o los encabezados de host.

Requisitos previos

The cluster is added to the ASM instance..

Procedimiento

Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, elija Service Mesh > Mesh Management.
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, elija ASM Gateways > Ingress Gateway.

En la página Ingress Gateway, haga clic en Create y configure los ajustes básicos de la puerta de enlace.

A continuación se describen los elementos de configuración de la puerta de enlace. También puede hacer clic en Create from YAML en la página Ingress Gateway para definir una puerta de enlace de entrada. Para obtener más información, consulte Use KubeAPI to manage an ingress gateway.

Parámetro	Descripción
Name	Un nombre personalizado para la puerta de enlace.
Cluster	Seleccione el clúster donde se desplegará la puerta de enlace.
Service Type	Admite LoadBalancer, ClusterIP y NodePort. Para obtener más información sobre estos tipos, consulte Service. Nota Si selecciona LoadBalancer para un clúster registrado, el clúster debe ser compatible con servicios de tipo LoadBalancer. De lo contrario, la creación de la puerta de enlace fallará.
CLB/NLB	Este parámetro es obligatorio solo cuando Service Type se establece en LoadBalancer. Admite Internet Access y Private Access.
Create SLB Instance	Este parámetro es obligatorio solo cuando Service Type se establece en LoadBalancer. Create SLB Instance: Si selecciona CLB, seleccione una especificación en la lista desplegable Select CLB Specifications. Si selecciona NLB, seleccione los vSwitches de como mínimo dos zonas en la lista desplegable Select Zones for NLB Instance. Use Existing CLB Instance: Seleccione un load balancer de la lista de instancias existentes. Importante Se recomienda asignar un load balancer dedicado a cada servicio de Kubernetes. Compartir un load balancer entre varios servicios de Kubernetes introduce los siguientes riesgos y limitaciones: El uso de un load balancer existente sobrescribe sus listeners de forma forzosa, lo que puede dejar sus aplicaciones inaccesibles. No es posible reutilizar un load balancer creado automáticamente por Kubernetes mediante un servicio. Solo se pueden reutilizar los load balancers creados manualmente en la consola o mediante una llamada a una openapi. Varios servicios que comparten el mismo load balancer no pueden usar el mismo puerto de escucha de frontend. De lo contrario, se produce un conflicto de puertos. Cuando se reutiliza un load balancer, Kubernetes usa los nombres del listener y del grupo de vServer como identificadores únicos. No modifique estos nombres. No se admite la reutilización de load balancers entre clústeres ni entre regiones.
Port Mapping	Configure el Protocol y el Service Port. Nota La consola proporciona de forma predeterminada dos puertos de Istio de uso común. Puede modificarlos según sea necesario.
Resources Limits	Establezca los límites de recursos de CPU y memoria para los pods de la puerta de enlace.
Gateway instances	Establezca el número de réplicas de la puerta de enlace.

Opcional: Haga clic en Advanced Options para configurar más ajustes.

Parámetro	Descripción
External Traffic Policy	Establezca la directiva de tráfico externo. Local: El tráfico se enruta únicamente a los pods del nodo local. Cluster: El tráfico se puede reenviar a pods de otros nodos del clúster.
HPA	Seleccione HPA y luego configure los siguientes parámetros: metrics: Establezca los Monitoring items y el Threshold. La puerta de enlace escala horizontalmente si se supera el umbral y reduce su capacidad si la métrica cae por debajo de este. Si configura umbrales tanto de CPU como de memoria, el escalado automático se activa cuando se cruza cualquiera de ellos. Maximum replicas: El número máximo de réplicas para el escalado horizontal. Minimum number of replicas: El número mínimo de réplicas para la reducción de capacidad. Nota Esta función solo está disponible en las ediciones Enterprise y Ultimate.
Rolling Upgrade	Seleccione Rolling Upgrade y luego configure los siguientes parámetros: Maximum number of unavailable instances: El número máximo de réplicas que pueden estar no disponibles durante una actualización continua. Exceeding the desired number of instances: El número máximo de réplicas adicionales permitidas durante una actualización continua. Por ejemplo, un valor del 25 % significa que el número total de réplicas no puede superar el 125 % de la cantidad deseada.
TLS performance optimization	Seleccione TLS performance optimization para acelerar el cifrado y descifrado TLS. supported nodeaffinity: Seleccione las etiquetas de nodo para identificar los nodos adecuados para esta optimización. Poll Delay(ms): Configure este parámetro para reducir la latencia de las operaciones de cifrado y descifrado. Para obtener más información, consulte Parameter description. Nota Esta función solo está disponible en las ediciones Enterprise y Ultimate.
Deploy ASM Gateway replicas as widely as possible	Cuando se establece `podAntiAffinity`, los pods se despliegan preferentemente en nodos distintos.
Custom Deployment Policy	Puede personalizar `nodeSelector`, `tolerations` y `affinity` para la puerta de enlace. Para ver descripciones detalladas de estos campos, consulte ASM gateway CRD description.
SLB graceful offline	Seleccione SLB graceful offline para garantizar que las conexiones activas no se interrumpan cuando finalice un pod de la puerta de enlace. Connection timeout (seconds): Cuando se quita un pod de la puerta de enlace del load balancer, este espera el tiempo de espera indicado antes de finalizar las conexiones existentes. Esto permite que el pod termine de procesar las solicitudes activas. El tiempo de espera no debe superar el periodo de apagado controlado del pod (predeterminado: 30 segundos). Nota Esta función solo está disponible en las ediciones Enterprise y Ultimate.

Una vez completada la configuración, haga clic en Create.

La creación de la puerta de enlace finaliza cuando su estado cambia a Running. El campo Service address muestra la dirección IP de la puerta de enlace de entrada.

Operaciones relacionadas

Después de crear la puerta de enlace de entrada, puede gestionarla en la consola de ASM o consultarla en la consola de ACK.

Gestionar la puerta de enlace de entrada en la consola de ASM

Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, elija Service Mesh > Mesh Management.
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, elija ASM Gateways > Ingress Gateway.

En la página Ingress Gateway, gestione la puerta de enlace de entrada.

Acciones	Descripción
Consultar o editar una puerta de enlace de entrada	Método 1: En la fila de la puerta de enlace objetivo, haga clic en View Details y modifique la configuración según sea necesario. Método 2: En la fila de la puerta de enlace objetivo, haga clic en View YAML. En el cuadro de diálogo Edit, modifique los campos según sea necesario y luego haga clic en OK. Para ver descripciones detalladas de los campos, consulte ASM gateway CRD description.
Eliminar una puerta de enlace de entrada	En la fila de la puerta de enlace objetivo, haga clic en Delete. En el cuadro de diálogo Confirm, haga clic en OK. Importante Al eliminar una puerta de enlace de entrada, los servicios externos ya no podrán acceder a los servicios internos de ASM a través de ella. Esta acción no se puede deshacer y será necesario volver a crear la puerta de enlace. Proceda con precaución.

Consultar la puerta de enlace de entrada en la consola de ACK

Consulte la información básica de la puerta de enlace de entrada recién agregada.
1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Network > Services.
3. En la parte superior de la página Services, seleccione istio-system en la lista desplegable Namespace.
  
  Ahora puede consultar la información básica de la puerta de enlace objetivo. La dirección IP de la columna External IP corresponde a la puerta de enlace de entrada.
Consulte la información de los pods de la puerta de enlace de entrada recién agregada.
1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Pods.
3. En la parte superior de la página Pods, seleccione istio-system en la lista desplegable Namespace.
4. Haga clic en el pod objetivo para consultar sus detalles.

Documentos relacionados

Para crear una puerta de enlace de entrada mediante una API, consulte Create an ASM gateway.
Para proporcionar una salida de tráfico unificada para las aplicaciones de la malla, consulte Create an egress gateway.
Para distribuir el tráfico entre distintas versiones de un servicio según un porcentaje ponderado, como en despliegues canary o pruebas A/B, consulte Use Istio resources to implement version-based traffic routing.
Para visualizar las relaciones de llamadas y los flujos de tráfico entre aplicaciones, servicios y versiones de aplicaciones, utilice la función Mesh Topology de ASM. Para obtener más información, consulte View the mesh topology of an application.
Para obtener más información sobre las funciones de las puertas de enlace, consulte ASM gateway overview.