O Endpoints é um sistema de gerenciamento de APIs distribuído. Ele oferece um console de APIs, hospedagem, geração de registros, monitoramento e outros recursos para criar, compartilhar, manter e proteger APIs. Nesta página, você terá uma visão geral do Cloud Endpoints para gRPC. Para mais informações sobre outros tipos de frameworks de API compatíveis com o Endpoints, consulte toda a documentação do Endpoints.
O Endpoints está disponível para uso com o Extensible Service Proxy (ESP) distribuído ou o Extensible Service Proxy V2 Beta (ESPv2 Beta). Cada proxy oferece suporte às plataformas descritas abaixo:
- Ambiente flexível do App Engine (somente ESP)
- Google Kubernetes Engine (ESP ou ESPv2)
- Compute Engine (ESP ou ESPv2)
- Kubernetes (ESP ou ESPv2)
- Padrão do App Engine (somente ESPv2)
- Funções do Cloud Run (somente ESPv2)
- Cloud Run (somente ESPv2)
- Knative serving (somente ESPv2)
Endpoints com o ESP
O Endpoints usa o Extensible Service Proxy (ESP) distribuído para oferecer baixa latência e alto desempenho, assim atendendo até as APIs mais exigentes. O ESP é um proxy de serviço baseado em NGINX (em inglês). Isso garante o escalonamento conforme as necessidades do usuário para processar solicitações simultâneas à API. O ESP é executado no próprio contêiner do Docker para oferecer melhor isolamento e escalonabilidade, além de ser distribuído no Container Registry. É possível usá-lo com o seguinte:
Endpoints com o ESPv2
O ESPv2 é um proxy escalonável de alto desempenho baseado no Envoy que é executado em um back-end de uma API OpenAPI ou gRPC. O ESPv2 é compatível com a versão 2 da especificação OpenAPI e das especificações do gRPC. É possível usá-lo com o seguinte:
Recursos de gerenciamento da API Endpoints
O Endpoints pode ser usado com o ESP ou ESPv2 Beta, oferecendo vários recursos significativos de gerenciamento de API para permitir que você desenvolva, monitore e controle o acesso às APIs.
Registros e métricas
O Endpoints usa o Service Infrastructure para gerenciar APIs e gerar relatórios de registros e métricas. A maioria das APIs do Google Cloud usa essa mesma infraestrutura. É possível gerenciar e monitorar as APIs na página Serviços do Endpoint no Console do Google Cloud.
Hospedagem de API
O Cloud Endpoints é otimizado para o ambiente de contêiner do Docker. É possível hospedar sua API em qualquer lugar em que o Docker seja compatível, desde que tenha acesso de Internet ao Google Cloud.
Como desenvolver uma API gRPC com o Endpoints
Defina um serviço da API do gRPC usando buffers de protocolo e implemente-o em qualquer linguagem compatível com gRPC (em inglês).
Grave a configuração do serviço da API gRPC para o Endpoints.
Gere a configuração do ambiente de execução da API e implante-a no Service Management.
Implante o servidor da API.
Saiba mais sobre como usar o gRPC com o Endpoints em Endpoints para APIs do gRPC e nos tutoriais relevantes.
Como controlar o acesso à API
Com o Endpoints, é possível configurar a API para exigir uma chave de API nas chamadas e validá-la. Também é possível usar o console do Google Cloud para compartilhar a API com outros desenvolvedores. Assim, eles podem ativar a API e gerar chaves para chamá-la.
Autenticar usuários da API
Na maioria das chamadas de API, há um usuário na outra extremidade. As chaves de API indicam o app que faz uma chamada para sua API, e o processo de autenticação identifica o usuário que está utilizando esse app.
Seu servidor de API ainda precisa definir o que o usuário autenticado pode fazer com a API. Para mais informações, consulte o guia de autenticação do Google Cloud.
A seguir
Para se familiarizar com as etapas de implantação e ver como os recursos do Endpoints funcionam, execute o Guia de início rápido do Cloud Endpoints, que usa scripts para implantar uma API de amostra em um back-end flexível do App Engine.
Para saber mais sobre como usar o Endpoints, acesse os tutoriais.