Endpoints è un sistema di gestione delle API distribuito. Offre una console API, l'hosting, il logging, il monitoraggio e altre funzionalità per aiutarti a creare, condividere, gestire e proteggere le tue API. Questa pagina fornisce una panoramica di Cloud Endpoints per gRPC. Per informazioni su altri tipi di framework API supportati da endpoint, consulta Tutti i documenti di Endpoints.
Gli endpoint possono essere utilizzati con Extensible Service Proxy (ESP) distribuito o Extensible Service Proxy V2 (ESPv2). Ogni proxy fornisce supporto per le piattaforme descritte di seguito:
- App Engine flessibile (solo ESP)
- Google Kubernetes Engine (ESP o ESPv2)
- Compute Engine (ESP o ESPv2)
- Kubernetes (ESP o ESPv2)
- Standard App Engine (solo ESPv2)
- Cloud Functions (solo ESPv2)
- Cloud Run (solo ESPv2)
- Cloud Run for Anthos (solo ESPv2)
Endpoints con ESP
Endpoints utilizza Extensible Service Proxy (ESP) distribuito per fornire bassa latenza e prestazioni elevate per gestire anche le API più esigenti. ESP è un proxy di servizio basato su NGINX, che offre la scalabilità necessaria per gestire le richieste simultanee alla tua API. ESP viene eseguito nel proprio container Docker per migliorare l'isolamento e la scalabilità e viene distribuito in Container Registry. Puoi utilizzarlo con:
Endpoints con ESPv2
ESPv2 è un proxy scalabile ad alte prestazioni basato su Envoy che viene eseguito davanti al backend di un'API OpenAPI o gRPC. ESPv2 supporta la versione 2 della specifica OpenAPI e delle specifiche gRPC. Puoi utilizzarlo con:
Funzionalità di gestione delle API Endpoints
Sia che utilizzi Endpoints con ESP o ESPv2, offre una serie di funzionalità di gestione delle API significative per consentirti di sviluppare, monitorare e controllare l'accesso alle API.
Log e metriche
Endpoints utilizza Service Infrastructure per gestire le API, nonché per generare report su log e metriche. La maggior parte delle API Google Cloud utilizza la stessa infrastruttura. Puoi gestire e monitorare le API nella pagina Servizi endpoint della console Google Cloud.
Hosting API
Gli endpoint sono ottimizzati per l'ambiente dei container Docker. Puoi ospitare la tua API ovunque sia supportato Docker, purché abbia accesso a internet a Google Cloud.
Sviluppo di un'API gRPC con endpoint
Definisci un servizio API gRPC utilizzando i buffer di protocollo e implementalo in qualsiasi linguaggio supportato da gRPC.
Scrivi la configurazione del servizio API gRPC per Endpoints.
Generare la configurazione dell'API runtime per l'API ed eseguirne il deployment in Service Management.
Esegui il deployment del server API.
Puoi trovare ulteriori informazioni sull'utilizzo di gRPC con endpoint in Endpoint per API gRPC e nei tutorial pertinenti.
Controllo dell'accesso alle API
Endpoints consente di configurare l'API in modo che richieda una chiave API per qualsiasi chiamata e convalida la chiave API. Puoi anche utilizzare la console Google Cloud per condividere l'API con altri sviluppatori in modo che possano abilitare l'API e generare chiavi API per chiamarla.
Autenticazione degli utenti API
Per la maggior parte delle chiamate API, c'è un utente all'altro capo di ogni chiamata. Mentre le chiavi API indicano l'app che effettua una chiamata all'API, il processo di autenticazione determina quale utente sta utilizzando l'app.
Tieni presente che il server API deve comunque decidere che cosa può fare l'utente autenticato con l'API. Per ulteriori informazioni, consulta la guida all'autenticazione Google Cloud.
Passaggi successivi
Acquisisci familiarità con la procedura di deployment e vedi le funzionalità di Endpoints in azione con la guida rapida per Endpoints, che utilizza gli script per eseguire il deployment di un'API di esempio in un backend flessibile di App Engine.
Scopri di più sull'utilizzo di Endpoints seguendo uno dei tutorial.