Uso de servicios para crear una comunicación interna y externa con Kubernetes

Uso del módulo de gateway de API para exponer servicios

Objectives

After completing this lesson, you will be able to:
  • Describir los componentes del módulo API Gateway
  • Utilizar los componentes de gateway de API para exponer servicios

El módulo de gateway de API

El proyecto "Kyma" amplía la plataforma Kubernetes con módulos que le permiten exponer sus Servicios y Funciones fuera del clúster. Puede utilizar el módulo API Gateway para hacer que sus servicios de Kubernetes sean accesibles desde fuera del clúster de Kyma.

Istio y API Gateway son módulos Kyma predeterminados, lo que significa que se agregan a su tiempo de ejecución de Kyma una vez que lo aprovisiona. Si desea crear funciones y exponerlas mediante API Gateway, también debe añadir el módulo sin servidor. Para desencadenar servicios expuestos con eventos, añada el módulo Eventos. Para supervisar las cargas de trabajo expuestas, añada el módulo Telemetría y utilice las funciones de observabilidad que proporciona.

Características del módulo de gateway de API

Exponer un servicio con el módulo Gateway de API

El API Gateway se basa en el proyecto de código abierto Istio, que se instala mediante el módulo Istio. La siguiente unidad proporciona más información sobre Istio.

El módulo API Gateway instala una Istio Ingress Gateway personalizada llamada kyma-gateway en el área de nombres kyma-system. La puerta de enlace kyma es el punto de contacto central para todo el tráfico externo que entra en el clúster de Kyma. Utiliza Envoy Proxy como un proxy de servicio basado en la aplicación para gestionar el tráfico y reenviarlo al servicio correcto.

El módulo también utiliza funciones Istio para autorizar solicitudes HTTP entrantes. Proporciona un recurso personalizado APIRule que puede utilizar para exponer de forma segura sus cargas de trabajo. Con una APIRule, puede:

  • Agrupar varias cargas de trabajo y exponerlas en un único host.
  • Utilice un nombre de host breve para simplificar la migración de recursos a un clúster nuevo.
  • Configure la estrategia de acceso noAuth, que ofrece una configuración simple para permitir el acceso a métodos HTTP específicos.
  • Asegure sus cargas de trabajo configurando estrategias de acceso jwt o extAuth. La estrategia de acceso jwt le permite utilizar la configuración JWT de Istio para proteger sus servicios expuestos e interactuar con ellos mediante JSON Web Tokens. La estrategia de acceso extAuth le permite implementar una lógica de autenticación y autorización personalizada.

¿Qué es el recurso personalizado APIRule?

Para exponer un servicio con el módulo Gateway de API, debe crear un recurso personalizado de Kubernetes (CR) llamado APIRule (apirules.gateway.kyma-project.io). Al crear una APIRule para un servicio, API Gateway Controller crea un Istio VirtualService para usted detrás de la puerta de enlace kyma. Por lo tanto, con APIRule CR, tiene una abstracción de mayor nivel que le permite proporcionar Servicios de forma rápida y segura.

Para definir una APIRule, debe crear una CR del tipo apirules.gateway.kyma-project.io. Un manifiesto APIRule simple tiene el siguiente aspecto:

YAML
123456789101112131415
apiVersion: gateway.kyma-project.io/v2 kind: APIRule metadata: name: my-api-rule spec: hosts: - my-api-rule.xxxxx.kyma.ondemand.com service: name: hello-kyma-svc port: 80 gateway: kyma-system/kyma-gateway rules: - path: /* methods: ["GET"] noAuth: true

Veamos con más detalle la sección spec del CR APIRule:

  • gateway: La puerta de enlace Istio Ingress para exponer el servicio. Con fines de desarrollo, puede utilizar un dominio Kyma y el gateway kyma-system/kyma-gateway predeterminado. En el entorno de producción, utilice su dominio personalizado para configurar un gateway TLS.
  • hosts: especifica el host o subdominio del host en el que se debe exponer el servicio. Puede exponer varios Servicios detrás del mismo host a través de Istio VirtualServices.
  • service: especifica el servicio de Kubernetes que se va a exponer. El name es el nombre del servicio Kubernetes que desea exponer. El port es el puerto del Servicio Kubernetes que desea exponer.
  • rules: especifica la matriz de reglas de acceso. Para cada regla, el campo path especifica la ruta de la solicitud que debe coincidir, y la matriz methods especifica los métodos HTTP. APIRule le permite definir la configuración de seguridad de un punto final expuesto utilizando el concepto de estrategias de acceso. Las estrategias de acceso admitidas son noAuth, jwt y extAuth. Configurar noAuth en true desactiva la autorización. El campo jwt especifica la estrategia de acceso JWT Istio y el campo extAuth especifica la estrategia de acceso Autorización externa Istio.

Para obtener más información, consulte Recurso personalizado APIRule.

Recurso personalizado APIRule en dashboard Kyma

El panel de Kyma proporciona una forma sencilla de crear APIRules para exponer su carga de trabajo. La creación de APIRules está integrada en la vista de Funciones y Servicios. Sin embargo, también puede ir a la vista APIRules y crear una nueva APIRule.

APIRules en dashboard Kyma

Puede definir la especificación APIRule en un archivo YAML o utilizar la vista basada en formulario en el dashboard Kyma.

Crear APIRules con el dashboard Kyma

Resumen

El módulo API Gateway permite la exposición de servicios y funciones fuera de su clúster de tiempo de ejecución de Kyma. El módulo se basa en el proyecto de código abierto Istio e incluye un Istio Ingress Gateway configurado a medida llamado kyma-gateway, que maneja el tráfico externo que entra en el clúster de Kyma. Para exponer un servicio mediante el módulo Gateway de API, cree un CR APIRule, que permite agrupar y proteger cargas de trabajo, por ejemplo, utilizando tokens JWT o autenticación personalizada.

Lectura adicional