Translate project documentation to English

This commit is contained in:
2026-04-20 16:50:39 -03:00
parent 248fd37942
commit 707852bb3a
4 changed files with 38 additions and 38 deletions
+25 -25
View File
@@ -1,30 +1,30 @@
# aws-localstack
Projeto OpenTofu para provisionar recursos AWS simulados no LocalStack da aplicacao ficticia Quantum.
OpenTofu project for provisioning simulated AWS resources on LocalStack for the fictional Quantum application.
Endpoint LocalStack:
LocalStack endpoint:
```text
https://localstack.paulononato.com.br
```
## Recursos
## Resources
- S3 bucket para artefatos da aplicacao Quantum.
- SQS fila principal e DLQ.
- Lambda Python para processar eventos.
- IAM role e policies ficticias para a Lambda.
- S3 bucket for Quantum application artifacts.
- SQS main queue and DLQ.
- Python Lambda function for event processing.
- IAM role and fictional policies for the Lambda function.
- CloudWatch Log Group.
- Secrets Manager com credenciais simuladas.
- Secrets Manager secret with simulated credentials.
- Event source mapping SQS -> Lambda.
## Pre-requisitos
## Prerequisites
- OpenTofu instalado.
- AWS CLI opcional para testes.
- Acesso ao endpoint LocalStack.
- OpenTofu installed.
- AWS CLI, optional for testing.
- Access to the LocalStack endpoint.
Credenciais usadas pelo LocalStack:
Credentials used by LocalStack:
```bash
export AWS_ACCESS_KEY_ID=test
@@ -32,7 +32,7 @@ export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1
```
No PowerShell:
On PowerShell:
```powershell
$env:AWS_ACCESS_KEY_ID="test"
@@ -40,41 +40,41 @@ $env:AWS_SECRET_ACCESS_KEY="test"
$env:AWS_DEFAULT_REGION="us-east-1"
```
## Como usar
## Usage
Inicializar:
Initialize:
```bash
tofu init
```
Planejar:
Plan:
```bash
tofu plan
```
Aplicar:
Apply:
```bash
tofu apply
```
Destruir:
Destroy:
```bash
tofu destroy
```
## Testes rapidos
## Quick Tests
Listar buckets:
List buckets:
```bash
aws --endpoint-url https://localstack.paulononato.com.br s3 ls
```
Enviar mensagem para a fila Quantum:
Send a message to the Quantum queue:
```bash
aws --endpoint-url https://localstack.paulononato.com.br sqs send-message \
@@ -82,13 +82,13 @@ aws --endpoint-url https://localstack.paulononato.com.br sqs send-message \
--message-body '{"event":"quantum.order.created","orderId":"QTM-1001"}'
```
Ver segredo:
Read the secret:
```bash
aws --endpoint-url https://localstack.paulononato.com.br secretsmanager get-secret-value \
--secret-id "$(tofu output -raw quantum_secret_name)"
```
## Observacao sobre RDS
## RDS Note
RDS nao esta incluido na edicao Community do LocalStack provisionada no servidor. Este projeto evita RDS e usa apenas os servicos disponiveis na stack atual.
RDS is not included in the LocalStack Community edition provisioned on the server. This project avoids RDS and uses only the services available in the current stack.