Sobre o Cloud Endpoints

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)
  • Cloud Functions (somente ESPv2)
  • Cloud Run (somente ESPv2)
  • Cloud Run for Anthos (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:

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:

  • GKE;
  • Compute Engine
  • Kubernetes
  • Ambiente padrão do App Engine
  • Cloud Functions
  • Cloud Run
  • Cloud Run for Anthos

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

  1. 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).

  2. Grave a configuração do serviço da API gRPC para o Endpoints.

  3. Gere a configuração do ambiente de execução da API e implante-a no Service Management.

  4. 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 sua 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, leia o Guia de início rápido do 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.