Como faço para implantar e gerenciar uma API do API Gateway em várias regiões?

Resolução

Crie e implante APIs em várias regiões

Para implantar uma API do API Gateway em várias regiões, você deve criar uma API idêntica em cada região na qual você deseja implantar a API.

Observação: para automatizar suas implantações de API em várias regiões, é uma prática recomendada usar ferramentas de infraestrutura como código (IaC), como o AWS CloudFormation ou o AWS Cloud Development Kit (AWS CDK).

Para APIs REST, consulte Create a REST API (Criar uma API REST). Em seguida, implante sua API REST. Para obter mais informações, consulte Desenvolver APIs REST no API Gateway e Implantar APIs REST no API Gateway.

Para APIs HTTP, consulte Criar uma API HTTP. Em seguida, publique sua API HTTP.

Para APIs de WebSocket, consulte Criar uma API WebSocket usando o console do API Gateway. Em seguida, implante sua API de WebSocket.

Para APIs REST privadas, consulte Criar uma API privada. Em seguida, implante sua API privada.

Crie nomes de domínio personalizados regionais

Em cada região em que você implantou sua API, crie um nome de domínio personalizado. Em seguida, use o console do AWS Certificate Manager (ACM) para solicitar um certificado TLS/SSL público para cada um dos seus domínios.

Crie registros de aliases do Route 53

Para rotear o tráfego, você deve ter uma zona hospedada pública. Se você não tiver uma, consulte Criar uma zona hospedada pública.

Configure o Route 53 para rotear tráfego para os nomes de domínio personalizados regionais. Certifique-se de escolher o roteamento por failover para a política de roteamento.

Para obter mais informações, consulte Encaminhar o tráfego para uma API do Amazon API Gateway por meio do seu nome de domínio.

Crie verificações de integridade do Route 53

No Route 53, crie verificações de integridade para cada endpoint do API Gateway regional. Associe as verificações de integridade aos registros de alias do Route 53 que você criou. Se uma verificação de integridade da região primária falhar, o Route 53 direcionará automaticamente o tráfego de entrada para a região secundária.

Implante serviços de backend

Implante seus serviços de backend nas mesmas regiões das implantações do API Gateway. Certifique-se de que seus serviços de backend retornem respostas consistentes e idênticas em todas as regiões.

Observação: para integrações HTTP do API Gateway, configure seus endpoints de integração para usar nomes DNS do Route 53, como backend.example.com, em vez de URLs regionais codificados. Para rotear automaticamente as solicitações para o backend regional correto, certifique-se de configurar o Route 53 com roteamento por geolocalização ou baseado em latência. Em seguida, é possível usar configurações de API idênticas em todas as regiões, e o tráfego permanece na mesma região quando possível.

Gerencie e monitore suas implantações

Para gerenciar e monitorar suas implantações do API Gateway em várias regiões, realize as seguintes ações:

• Use o ACM para gerenciar os certificados para seus nomes de domínio personalizados.
• Use o ACM para renovar seus certificados.
• Ative o registro em log de API do Amazon CloudWatch.
• Ative o rastreamento do AWS X-Ray.

Informações relacionadas

Implementing multi-Region failover for Amazon API Gateway (Implementação de failover multirregional no Amazon API Gateway)

Como o Amazon Route 53 determina a integridade de uma verificação de integridade

Opções de recuperação de desastres na nuvem