MemoriaGCP

tekio.org

Cloud Endpoints

DéconseilléProduit hérité : il ne se justifie que devant un backend déjà équipé d'ESP ou d'ESPv2. Pour une nouvelle API, préférer API Gateway ou, si la gestion du cycle de vie compte, Apigee.
Projet GCPClientsclé d'APIService Managementconfig de serviceCloud EndpointsESPv2Service Controlquotas et rapportsCloud Runbackend sans serveurBackend GKEAPI REST ou gRPC12345
  1. La description OpenAPI ou le descripteur gRPC est déployé dans Service Management ; le proxy y lit sa configuration au démarrage.
  2. Tous les appels passent d'abord par le proxy, qui valide la clé d'API ou le jeton JWT avant tout traitement.
  3. La requête validée part vers le backend, ici un conteneur du même pod que le proxy déployé en side-car.
  4. En mandataire distant, le même ESPv2 tourne comme service Cloud Run devant un backend sans serveur.
  5. Le proxy interroge Service Control pour les quotas, puis lui remet les rapports d'usage qui alimentent métriques et facturation.

Ce que c'est

Système de gestion d'API construit autour d'un mandataire que l'on déploie soi-même devant son backend. Le proxy applique les règles décrites dans une configuration de service — authentification, clés, quotas — et rend compte de chaque appel à l'infrastructure de services de Google.

  • Quatre composants. Le proxy (ESP ou ESPv2) intercepte les requêtes. Service Management stocke la configuration de service, produite à partir d'une description OpenAPI ou d'un fichier de configuration gRPC et déployée par gcloud. Service Control applique les règles à l'exécution : vérification des clés, quotas, remontée des métriques et des journaux. La console sert de vue de suivi.
  • Deux proxys. ESP repose sur NGINX et ne se déploie qu'en conteneur, devant un backend GKE, Kubernetes, Compute Engine ou App Engine flexible. ESPv2, fondé sur Envoy, est celui qu'on utilise aujourd'hui : il ajoute Cloud Run, les fonctions, Knative serving et App Engine standard.
  • Deux modes de déploiement. En side-car, le proxy tourne dans le même pod ou la même VM que le backend : pas de saut réseau supplémentaire. En mandataire distant, ESPv2 est déployé comme service Cloud Run et gère plusieurs backends sans serveur désignés par x-google-backend.
  • Trois options d'API. Endpoints for OpenAPI décrit l'API en OpenAPI 2.0 ou 3.0. Endpoints for gRPC part des fichiers .proto et sait transcoder HTTP/JSON en gRPC ; gRPC n'est pas disponible sur App Engine ni sur les fonctions, faute de HTTP/2. Endpoints Frameworks déconseillé est un cadre applicatif limité aux exécutions Java 8 et Python 2.7 d'App Engine standard de 1re génération, hors support, avec sa propre passerelle intégrée.
  • Contrôle d'accès. Clés d'API pour identifier le projet appelant et compter les quotas, jetons JWT signés par un compte de service, jetons d'identité Google, ou fournisseur tiers (Firebase, Auth0). Les quotas se définissent par méthode et par consommateur.
  • Exploitation. Il n'existe pas de portail développeur : la documentation et la distribution des clés sont à la charge du projet. Les métriques et les traces sont visibles dans la page Endpoints Services de la console.
  • Facturation identique à celle d'API Gateway, par appels comptés par Service Control : deux premiers millions d'appels mensuels gratuits, puis 3 $ par million jusqu'à un milliard et 1,50 $ au-delà. Le calcul et le réseau du proxy s'ajoutent, puisque c'est l'utilisateur qui l'héberge.

Le proxy est à la charge du projet : il faut le dimensionner, le mettre à jour et le surveiller. C'est la différence de fond avec API Gateway, qui exploite le même moteur Envoy mais sous la responsabilité de Google.

À quoi ça sert

  • Maintenir une API déjà gérée par ESP ou ESPv2, sans réécrire sa description ni changer son modèle d'authentification.
  • Placer une gestion d'API devant un backend qui n'est pas sans serveur — un service GKE ou une VM — là où API Gateway n'atteint qu'un point d'entrée HTTPS public.
  • Exposer en HTTP/JSON une API gRPC hébergée ailleurs que sur Cloud Run, seul cas que la passerelle managée ne couvre pas.
  • Garder le contrôle de la version et de la configuration du mandataire, par exemple pour des options Envoy particulières.

À éviter pour toute API nouvelle. API Gateway rend le même service — mêmes extensions OpenAPI, même transcodage gRPC, mêmes clés et quotas — sans proxy à exploiter ni à mettre à jour, et au même tarif à l'appel. Dès qu'il faut un portail développeur, des produits d'API, des transformations de message ou une politique de sécurité partagée, c'est Apigee qu'il faut regarder. Et pour du trafic interne entre services d'un cluster, Cloud Service Mesh évite le passage par une passerelle.

Alternatives en logiciel libre

  • ESPv2 (Apache 2.0) : le proxy lui-même est publié en logiciel libre et s'utilise devant n'importe quel backend, même sans les services de gestion Google.
  • Envoy (Apache 2.0) : la brique sous-jacente, qui sait seule valider un JWT, limiter le débit et transcoder gRPC-JSON.
  • grpc-gateway (BSD 3 clauses) : génère un mandataire REST depuis un fichier .proto, l'équivalent direct du transcodage d'Endpoints for gRPC.
  • Kong Gateway (Apache 2.0) et Apache APISIX (Apache 2.0) : passerelles à plugins couvrant clés d'API, quotas et authentification, déployables en side-car comme en point central.
  • Emissary-ingress (Apache 2.0) : passerelle Kubernetes sur Envoy, configurée par ressources déclaratives, pour les backends en cluster.

Documentation