Tutorial: Crie uma aplicação de bate-papo de WebSocket com uma API de WebSocket, o Lambda e o DynamoDB

Como criar uma pilha do AWS CloudFormation

1. Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. Selecione Create stack (Criar pilha) e With new resources (standard) (Com novos recursos (padrão)).

3. Em Specify template (Especificar modelo), escolha Upload a template file (Fazer upload de um arquivo de modelo).

4. Selecione o modelo que você baixou.

5. Escolha Next (Próximo).

6. Em Nome da pilha, insira websocket-api-chat-app-tutorial e escolha Avançar.

7. Para Configurar opções de pilha, escolha Avançar.

8. Para Capabilities (Recursos), reconheça que AWS CloudFormation pode criar recursos do IAM em sua conta.

9. Selecione Enviar.

Como criar uma API WebSocket

1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

2. Selecione Create API (Criar API). Depois, em WebSocket API (API WebSocket), escolha Build (Criar).

3. Em API name (Nome da API), insira websocket-chat-app-tutorial.

4. Em Route selection expression (Expressão de seleção de rota), insira request.body.action. A expressão de seleção de rota determina qual rota o API Gateway invoca quando um cliente envia uma mensagem.

5. Escolha Next (Próximo).

6. Em Predefined routes (Rotas predefinidas), escolha Add $connect (Adicionar $connect), Add $disconnect (Adicionar $disconnect) e Add $default (Adicionar $default). As rotas $connect e $disconnect são rotas especiais que o API Gateway invoca automaticamente quando um cliente se conecta ou se desconecta de uma API. O API Gateway invoca a rota $default quando nenhuma outra rota corresponde a uma solicitação.

7. Em Custom routes (Rotas personalizadas), escolha Add custom route (Adicionar rota personalizada). Em Route key (Chave de rota), insira sendmessage. Essa rota personalizada lida com mensagens enviadas para clientes conectados.

8. Escolha Next (Próximo).

9. Em Attach integrations (Anexar integrações), para cada rota e Integration type (Tipo de integração), escolha Lambda.

   Em Lambda, escolha a função do Lambda correspondente que você criou com o AWS CloudFormation na Etapa 1. O nome de cada função corresponde a uma rota. Por exemplo, para a rota $connect, escolha a função chamada websocket-chat-app-tutorial-ConnectHandler.

10. Revise o estágio criado pelo API Gateway para você. Por padrão, o API Gateway cria um nome de estágio production e implanta automaticamente sua API nesse estágio. Escolha Next (Próximo).

11. Selecione Create and deploy (Criar e implantar).

Como obter a URL para invocar a sua API

1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

2. Selecione a API.

3. Escolha Stages (Estágios) e, depois, production (produção).

4. Observe o URL WebSocket da API. O URL deve ser semelhante a wss://abcdef123.execute-api.us-east-2.amazonaws.com/production.

Como se conectar à sua API

1. Use o comando a seguir para se conectar à sua API. Quando você se conecta à API, o API Gateway invoca a rota $connect. Quando essa rota é invocada, ela chama uma função do Lambda que armazena seu ID de conexão no DynamoDB.

   wscat -c wss://abcdef123.execute-api.us-west-2.amazonaws.com/production

   Connected (press CTRL+C to quit)

2. Abra um novo terminal e execute o comando wscat novamente com os parâmetros a seguir.

   wscat -c wss://abcdef123.execute-api.us-west-2.amazonaws.com/production

   Connected (press CTRL+C to quit)

   Isso fornece dois clientes conectados que podem trocar mensagens.

Para enviar uma mensagem

• O API Gateway determina qual rota invocar com base na expressão de seleção de rotas da API. A expressão de seleção de rotas da sua API é $request.body.action. Como resultado, o API Gateway invoca a rota sendmessage quando você envia a seguinte mensagem:

  {"action": "sendmessage", "message": "hello, everyone!"}

  A função do Lambda associada à rota invocada coleta os IDs do cliente do DynamoDB. Depois, a função chama a API de gerenciamento do API Gateway e envia a mensagem para esses clientes. Todos os clientes conectados recebem a seguinte mensagem:

  < hello, everyone!

Como invocar a rota $default da API

• O API Gateway invocará a rota padrão da API quando um cliente envia uma mensagem que não corresponde às rotas definidas. A função do Lambda associada à rota $default usa a API de gerenciamento do API Gateway para enviar informações do cliente sobre sua conexão.

  test

  Use the sendmessage route to send a message. Your info: {"ConnectedAt":"2022-01-25T18:50:04.673Z","Identity":{"SourceIp":"192.0.2.1","UserAgent":null},"LastActiveAt":"2022-01-25T18:50:07.642Z","connectionID":"Mg_ugfpqPHcCIVA="}

Para se desconectar de sua API

• Pressione CTRL+C para se desconectar de sua API. Quando um cliente se desconecta da sua API, o API Gateway invoca a rota $disconnect de sua API. A integração do Lambda para a rota $disconnect de sua API remove o ID da conexão do DynamoDB.

Como excluir uma API WebSocket

1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

2. Na página APIs, selecione sua API do websocket-chat-app-tutorial. Escolha Ações, escolha Excluir e, em seguida, confirme sua escolha.

Para excluir uma pilha do AWS CloudFormation

1. Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. Selecione sua pilha do AWS CloudFormation.

3. Escolha Excluir e, em seguida, confirme sua escolha.