Este projeto demonstra como construir uma API em Python que produz mensagens em uma fila SQS do AWS, tudo rodando localmente usando Docker e LocalStack.

• Docker: 20.10.7 (Certifique-se de ter a Docker Engine instalada para construir e rodar contêineres)
• Docker Compose: 1.29.2 (Usado para definir e rodar múltiplos contêineres Docker)
• LocalStack: 0.12.10 (Simula serviços da AWS localmente)
• Python: 3.8 (Linguagem de programação usada para desenvolver a aplicação)
• Flask: 1.1.2 (Framework web utilizado para criar a API)
• Boto3: 1.17.49 (SDK da AWS para Python, utilizado para interagir com o SQS)

• app/: Contém os arquivos da aplicação Flask.
  • app.py: O arquivo principal da aplicação Flask. Define a API que envia mensagens para a fila SQS.
  • requirements.txt: Lista todas as dependências Python necessárias para a aplicação.
• localstack/: Contém scripts e configurações para o LocalStack, que simula serviços da AWS localmente.
  • init.sh: Script de inicialização para criar recursos AWS necessários (como filas SQS) no LocalStack.
• Dockerfile: Define como construir a imagem Docker da aplicação Flask.
• docker-compose.yml: Arquivo de configuração do Docker Compose. Orquestra a aplicação Flask e o LocalStack para rodar juntos em contêineres Docker.

Se preferir criar a fila SQS manualmente em vez de usar o script init.sh, siga estes passos após iniciar o LocalStack:

1. Abra um terminal e execute o seguinte comando para acessar o shell do contêiner do LocalStack:

docker exec -it <nome_do_container_localstack> /bin/bash

2. Dentro do contêiner, use o awslocal para criar a fila SQS com tempo de retenção das mensagens (86400segs = 24h):

awslocal sqs create-queue --queue-name my-queue --attributes MessageRetentionPeriod=86400

Para iniciar o projeto, execute o seguinte comando no diretório raiz:

docker-compose up --build

Isso iniciará tanto a aplicação Flask quanto o LocalStack em contêineres Docker separados.

Para testar a API usando o Insomnia, siga estes passos:

1. Instale e Abra o Insomnia: Se ainda não o fez, baixe e instale o Insomnia a partir do site oficial.

1. Faça o download do arquivo Insomnia_poc-sqs que se encontra na estrutura de pastas \poc-python-sqs\tests\collection
2. Abra a ferramenta Insomnia
3. No menu superior clique em Application
4. Depois clique em Preferences, no menu cliquem em Data
5. E por fim clique em Import, e escolha o arquivo baixado na etapa um deste processo

1. Crie um Novo Request:

   • Abra o Insomnia e crie um novo Request clicando no botão "New Request".
   • Nomeie o Request como "Enviar Mensagem SQS" e selecione o método POST.
   • Clique em "Create".

2. Configure o Request:

   • Na barra de URL, insira http://localhost:5000/send.
   • Vá para a aba "Body", selecione "JSON" e insira o seguinte JSON no corpo do request:

{
  "message": "Sua mensagem aqui"
}

3. Envie o Request:
   • Clique no botão "Send" para enviar o request.
   • Se tudo estiver configurado corretamente, você receberá uma resposta indicando que a mensagem foi enviada com sucesso para a fila SQS.

Repita estes passos sempre que quiser testar o envio de mensagens para a fila SQS através da sua API.

5. Verificando se a mensagem foi criada:

6. Abra um terminal e execute o seguinte comando para acessar o shell do contêiner do LocalStack:

docker exec -it <nome_do_container_localstack> /bin/bash

2. Dentro do contêiner, use o awslocal para verificar se existem mensagens na fila SQS:

awslocal sqs receive-message --queue-url http://localhost:4566/000000000000/my-queue