Carregando
0x50Lição 6 de 15

API gateways e descoberta de serviços

Dê aos clientes uma única porta de entrada com um API gateway ou BFF, e deixe os serviços se encontrarem com descoberta, balanceamento de carga e service meshes.

26 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Explicar o que um API gateway faz: roteamento, autenticação, limitação de taxa e agregação
  • Escolher entre um único gateway e backends-for-frontends
  • Descrever a descoberta de serviços, o balanceamento de carga no cliente e no servidor, e o que uma service mesh acrescenta

O app da Galactic Noodle Express não deveria precisar saber que existem doze serviços, nem em quais endereços. Um API gateway é a porta de entrada única: os clientes chamam api.galacticnoodle.space, e o gateway:

  • roteia cada requisição para o serviço certo (/orders/... → Pedidos, /menu/... → Cardápio),
  • cuida uma única vez das preocupações transversais: autenticação, TLS, limitação de taxa, log das requisições, CORS,
  • pode agregar: uma requisição do cliente, várias chamadas a serviços, uma resposta combinada.

Um backend for frontend (BFF) é um gateway feito sob medida para um tipo de cliente - um para o app mobile, um para a web, um para APIs de parceiros - para que cada um receba exatamente o formato de dados de que precisa, sem um meio-termo que serve para todos.

gateway routes
1routes:
2  - prefix: /api/orders
3    service: ordering
4    rewrite: /orders
5  - prefix: /api/orders/history
6    service: order-history
7    rewrite: /history
8  - prefix: /api/menu
9    service: menu
10    rewrite: /dishes
11rate_limit:
12  per_client: 10        # tokens (requests) in the bucket
13  refill_per_second: 2

O roteamento usa o prefixo mais longo que combina: /api/orders/history/7 vai para order-history, e não para ordering, embora os dois prefixos combinem. A limitação de taxa costuma usar um token bucket: o balde de cada cliente guarda até N tokens e é reabastecido a uma taxa constante; cada requisição gasta um, e um balde vazio significa 429 Too Many Requests. Picos são permitidos até o tamanho do balde, mas a taxa a longo prazo tem um teto.

Como os serviços se encontram

As instâncias dos serviços vêm e vão - escaladas na sexta à noite, substituídas durante os deploys - então os endereços delas mudam o tempo todo. A descoberta de serviços acompanha isso:

  • Um registro (Consul, etcd, Eureka ou o próprio Kubernetes) conhece as instâncias saudáveis de cada serviço.
  • Descoberta no servidor: quem chama usa um nome estável (http://menu), e um balanceador de carga ou o DNS escolhe uma instância. Os Services do Kubernetes funcionam assim.
  • Descoberta no cliente: quem chama pede as instâncias ao registro e faz o balanceamento entre elas por conta própria.

Uma service mesh (Istio, Linkerd) tira tudo isso do código da aplicação e coloca num proxy sidecar ao lado de cada instância: descoberta, balanceamento de carga, novas tentativas, timeouts, TLS mútuo e telemetria - configurados de forma central, para qualquer linguagem. É poderoso, mas é mais um sistema complexo para operar; muitas equipes não precisam de um no começo.

Principais conclusões

  • Um API gateway é o ponto de entrada único: roteamento, autenticação, limitação de taxa e agregação - mas nenhuma lógica de negócio.

  • Backends-for-frontends ajustam um gateway a cada tipo de cliente.

  • A descoberta acompanha as instâncias saudáveis; os Services do Kubernetes oferecem descoberta no servidor por nome.

  • Uma service mesh coloca descoberta, novas tentativas, mTLS e telemetria em proxies sidecar - adote quando precisar.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: simule padrões de microsserviços com Python

Crie pequenas simulações em Python dos padrões, como roteadores, sagas, outboxes, circuit breakers e traces, e execute-as com entradas de exemplo. Elas rodam localmente no navegador; não é preciso ter servidores nem contêineres.

Exercício 1

Roteie como um gateway

+25 XP

A entrada tem linhas de rota prefix service rewrite, uma linha --- e depois linhas de requisição METHOD path. Uma rota combina quando o caminho é igual ao prefixo dela ou continua com /. Escolha o prefixo mais longo que combina e troque esse prefixo pelo rewrite: imprima GET /api/orders/42 -> ordering /orders/42, ou GET /api/unknown -> 404 quando nada combinar.

  • Gateway do lámen
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Um limitador de taxa com token bucket

+25 XP

A primeira linha da entrada é capacity refill_per_second. Cada linha seguinte é uma requisição seconds client (tempos em ordem não decrescente, possivelmente fracionários). Cada cliente tem o próprio balde, que começa cheio. Antes de cada requisição, reabasteça o balde do cliente pelo tempo desde a última requisição dele (até a capacidade); depois gaste um token, se houver. Imprima 0.0 zara: 200 (4 left) - os tokens restantes arredondados para baixo para um número inteiro - ou 0.4 zara: 429. Termine com as contagens de permitidas e rejeitadas de cada cliente, em ordem alfabética: zara: 5 allowed, 2 rejected.

  • Uma rajada
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…