Utilisation de services pour créer une communication interne et externe avec Kubernetes

Utilisation du module Passerelle d'API pour exposer des services

Objectives

After completing this lesson, you will be able to:
  • Décrire les composants du module Passerelle d'API
  • Utiliser les composants de la passerelle API pour exposer les services

Module Passerelle d'API

Le projet "Kyma" étend la plate-forme Kubernetes avec des modules qui vous permettent d'exposer vos services et fonctions en dehors du cluster. Vous pouvez utiliser le module Passerelle API pour rendre vos services Kubernetes accessibles depuis l'extérieur du cluster Kyma.

Istio et la passerelle API sont des modules Kyma par défaut, ce qui signifie qu'ils sont ajoutés à votre exécution Kyma une fois que vous le mettez à disposition. Si vous voulez créer des fonctions et les exposer à l'aide de la passerelle API, vous devez également ajouter le module sans serveur. Pour déclencher des services exposés avec des événements, ajoutez le module Eventing. Pour surveiller les charges de travail exposées, ajoutez le module de télémétrie et utilisez les fonctionnalités d'observabilité qu'il fournit.

Fonctionnalités du module Passerelle d'API

Exposition d'un service avec le module Passerelle d'API

La passerelle API est basée sur le projet open source Istio, qui est installé par le module Istio. Le chapitre suivant fournit plus d'informations sur Istio.

Le module Passerelle d'API installe une passerelle d'entrée Istio personnalisée appelée passerelle kyma dans l'espace de noms kyma-system. La passerelle kyma est le point de contact central pour tout le trafic externe qui pénètre dans le cluster Kyma. Il utilise le proxy envoyé comme proxy de service basé sur l'application pour gérer le trafic et le transférer au service approprié.

Le module utilise également des fonctionnalités Istio pour autoriser les requêtes HTTP entrantes. Il fournit une ressource APIRule personnalisée que vous pouvez utiliser pour exposer en toute sécurité vos charges de travail. Avec une règle APIRule, vous pouvez :

  • Regroupez plusieurs charges de travail et exposez-les sous un seul hôte.
  • Utilisez un nom d'hôte court pour simplifier la migration des ressources vers un nouveau cluster.
  • Configurez la stratégie d'accès noAuth, qui offre une configuration simple pour autoriser l'accès à des méthodes HTTP spécifiques.
  • Sécurisez vos charges de travail en configurant des stratégies d'accès jwt ou extAuth. La stratégie d'accès jwt vous permet d'utiliser la configuration JWT d'Istio pour protéger vos services exposés et interagir avec eux à l'aide de jetons Web JSON. La stratégie d'accès extAuth vous permet d'implémenter une logique d'authentification et d'autorisation personnalisée.

Qu'est-ce que la ressource personnalisée APIRule ?

Pour exposer un service à l'aide du module Passerelle d'API, vous devez créer une ressource personnalisée (CR) Kubernetes appelée APIRule (apirules.gateway.kyma-project.io). En créant une APIRule pour un service, API Gateway Controller crée un Istio VirtualService pour vous derrière la passerelle kyma. Ainsi, avec APIRule CR, vous disposez d'une abstraction de niveau supérieur qui vous permet de fournir des services rapidement et en toute sécurité.

Pour définir une règle APIRule, vous devez créer un CR du type apirules.gateway.kyma-project.io. Un manifeste APIRule simple ressemble à ceci:

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

Examinons de plus près la section spec de l'APIRule CR :

  • gateway: passerelle d'entrée Istio pour exposer le service. À des fins de développement, vous pouvez utiliser un domaine Kyma et la passerelle Kyma/Kyma passerelle par défaut. Dans l'environnement de production, utilisez votre domaine personnalisé pour configurer une passerelle TLS.
  • hosts: indique l'hôte ou le sous-domaine de l'hôte sur lequel le service doit être exposé. Vous pouvez exposer plusieurs services derrière le même hôte via Istio VirtualServices.
  • service: indique le service Kubernetes à exposer. Le name est le nom du service Kubernetes que vous souhaitez exposer. Le port est le port du service Kubernetes que vous souhaitez exposer.
  • rules: indique le tableau de règles d'accès. Pour chaque règle, le champ path spécifie le chemin de la requête qui doit être mis en correspondance et le tableau methods spécifie les méthodes HTTP. La règle APIRule vous permet de définir la configuration de sécurité d'un point de terminaison exposé à l'aide du concept de stratégies d'accès. Les stratégies d'accès prises en charge sont noAuth, jwt et extAuth. Définir noAuth sur true désactive l'autorisation. La zone jwt indique la stratégie d'accès JWT Istio et la zone extAuth la stratégie d'accès Autorisation externe Istio.

Pour plus d'informations, voir Ressource personnalisée APIRule.

Ressource personnalisée de règle d'API dans le tableau de bord Kyma

Le tableau de bord Kyma fournit un moyen simple de créer des APIRules pour exposer votre charge de travail. La création d'APIRules est intégrée dans la vue de Fonctions et Services. Cependant, vous pouvez également accéder à la vue APIRules et créer une nouvelle règle APIRule.

APIRules dans le tableau de bord Kyma

Vous pouvez définir la spécification APIRule dans un fichier YAML ou utiliser la vue basée sur un formulaire dans le tableau de bord Kyma.

Créer des règles APIRules à l'aide du tableau de bord Kyma

Synthèse

Le module Passerelle d'API permet l'exposition des services et des fonctions en dehors de votre cluster d'exécution Kyma. Le module est basé sur le projet open source Istio et comprend une passerelle d'entrée Istio personnalisée appelée Kyma Gateway, qui gère le trafic externe entrant dans le cluster Kyma. Pour exposer un service à l'aide du module Passerelle API, vous créez une règle APIRule CR, qui permet de regrouper et de sécuriser les charges de travail, par exemple, à l'aide de jetons JWT ou d'une authentification personnalisée.

Autre lecture