À propos de Cloud Endpoints

Endpoints est un système de gestion d'API distribué. Il fournit une console API, l'hébergement, la journalisation, la surveillance et d'autres fonctionnalités pour vous aider à créer, partager, gérer et sécuriser vos API. Cette page présente Cloud Endpoints pour gRPC. Pour en savoir plus sur les autres types de frameworks d'API compatibles avec Endpoints, consultez toute la documentation sur Endpoints.

Cloud Endpoints est disponible pour une utilisation avec Extensible Service Proxy (ESP) ou Extensible Service Proxy V2 bêta (ESPv2 bêta). Chaque proxy fournit une assistance aux plates-formes décrites ci-dessous :

  • Environnement flexible App Engine (ESP uniquement)
  • Google Kubernetes Engine (ESP ou ESPv2 bêta)
  • Compute Engine (ESP ou ESPv2 bêta)
  • Kubernetes (ESP ou ESPv2 bêta)
  • Environnement standard App Engine (ESPv2 bêta uniquement)
  • Cloud Functions (ESPv2 bêta uniquement)
  • Cloud Run (ESPv2 bêta uniquement)
  • Cloud Run pour Anthos (ESPv2 bêta uniquement)

Endpoints avec ESP

Endpoints utilise le proxy Extensible Service Proxy (ESP) distribué pour fournir une latence faible et des performances de diffusion élevées, même pour les API les plus exigeantes. ESP est un proxy de service basé sur NGINX. Vous pouvez donc être sûr qu'il s'adapte en fonction des besoins afin de traiter les requêtes adressées simultanément à votre API. ESP s'exécute dans son propre conteneur Docker pour une meilleure isolation et une meilleure évolutivité. Il est distribué dans Container Registry. Vous pouvez l'utiliser avec les éléments suivants :

Endpoints avec ESPv2 bêta

ESPv2 bêta est un proxy évolutif hautes performances basé sur Envoy qui s'exécute devant un backend d'API OpenAPI ou gRPC. ESPv2 bêta est compatible avec la version 2 de la spécification OpenAPI et les spécifications gRPC. Vous pouvez l'utiliser avec les éléments suivants :

  • GKE
  • Instance
  • Kubernetes
  • Environnement standard App Engine
  • Cloud Functions
  • Cloud Run
  • Cloud Run pour Anthos

Fonctionnalités de gestion des API d'Endpoints

Que vous utilisiez Endpoints avec ESP ou ESPv2 bêta, elle fournit un certain nombre de fonctionnalités importantes de gestion des API pour vous permettre de développer, surveiller et contrôler l'accès à vos API.

Journaux et métriques

Cloud Endpoints utilise l'infrastructure de service pour gérer les API et générer des rapports de journaux et de métriques. La plupart des API Google Cloud utilisent cette infrastructure. Vous pouvez gérer et surveiller vos API sur la page Services Endpoints de Google Cloud Console.

Hébergement d'API

Cloud Endpoints est optimisé pour l'environnement de conteneurs Docker. Vous pouvez héberger votre API dans n'importe quel emplacement compatible avec Docker, à condition que cet emplacement dispose d'un accès Internet à Google Cloud.

Développer une API gRPC avec Cloud Endpoints

  1. Définissez un service d'API gRPC à l'aide de tampons de protocole et mettez-le en œuvre dans n'importe quel langage compatible avec gRPC.

  2. Rédigez le fichier de configuration du service d'API gRPC pour Endpoints.

  3. Générez le fichier de configuration de l'API d'exécution pour votre API et déployez-le dans Service Management.

  4. Déployez le serveur d'API.

Pour en savoir plus sur l'utilisation de gRPC avec Endpoints, consultez la page Endpoints pour les API gRPC et les tutoriels correspondants.

Contrôler l'accès à l'API

Cloud Endpoints vous permet de configurer l'API de sorte qu'une clé API soit requise pour tout appel et validée par le service. Vous pouvez également utiliser Google Cloud Console pour partager votre API avec d'autres développeurs, afin qu'ils puissent l'activer et générer des clés API pour l'appeler.

Authentifier les utilisateurs de l'API

Un utilisateur est à l'origine de la plupart des appels d'API. Alors que les clés API indiquent l'application qui appelle l'API, le processus d'authentification identifie l'utilisateur qui se sert de cette application.

Notez que votre serveur d'API doit encore décider de ce que l'utilisateur authentifié peut faire avec votre API. Pour plus d'informations, consultez le guide d'authentification Google Cloud.

Étapes suivantes

  • Familiarisez-vous avec les procédures de déploiement et l'utilisation des fonctionnalités de Cloud Endpoints en suivant le guide de démarrage rapide pour Cloud Endpoints. Celui-ci utilise des scripts pour déployer un exemple d'API sur un backend flexible de Google App Engine.

  • Découvrez comment utiliser Cloud Endpoints en parcourant l'un des tutoriels proposés.