Projeto hands-on baseado no guia "LAB SRE / DEVOPS". Inclui API em Go, worker de analytics em Python, frontend web, CLI em Bash, Lambda de preview, manifests Kubernetes, Helm chart, Terraform/Terragrunt, Ansible e Packer.
- Suba o stack completo:
make compose-up
- (Opcional) garanta as tabelas:
make db-init
- Teste API + worker:
bash cli/linklab.sh shorten https://exemplo.com curl -I http://localhost:8080/<CODIGO>
- Verifique LocalStack (S3 + Lambda local):
make localstack-status make lambda-test
- Derrube tudo:
make compose-down
- Frontend:
http://localhost:8088 - API:
http://localhost:8080 - Prometheus:
http://localhost:9090 - Grafana:
http://localhost:3000(admin/admin) - LocalStack (AWS local):
http://localhost:4566
- API (Go): endpoints
/shorten,/health,/stats/{code}, redirect/<code>. Usa PostgreSQL e Redis. - Worker (Python): consome lista
clicksno Redis e grava eventos na tabelaclicks. - CLI (Bash): wrapper para chamar a API (
shorten,stats,health). - Frontend (Nginx + JS): interface web local para encurtar links e consultar stats.
- Lambda (Python): gera preview e grava no bucket S3 local (LocalStack).
- Prometheus: coleta métricas da API (
/metrics) e aplica regras de alerta. - Grafana: dashboard local com datasource Prometheus provisionado automaticamente.
- LocalStack: emula S3/Lambda para continuar o lab sem conta AWS disponível.
Arquivo docker-compose.yml fornece o stack local completo. Imagens são construídas automaticamente no make compose-up.
- Guia principal:
docs/README.pt-BR.md - Onboarding rapido (5 min):
docs/ONBOARDING-5MIN.pt-BR.md - Guia da aplicacao:
docs/GUIA-APP.pt-BR.md - Guia Git:
docs/GIT-REPO.pt-BR.md
- RDS PostgreSQL -> container
postgres - ElastiCache Redis -> container
redis - Lambda -> LocalStack Lambda (
linklab-preview) - S3 -> LocalStack S3 (
linklab-previews) - CloudWatch/Prometheus stack ->
prometheus+grafana - ECR (build local) -> imagens Docker locais
dockerkubectlhelmkindouk3d
- Suba cluster + deploy Helm local:
make k8s-kind-up
- Verifique workloads:
make k8s-status
- Smoke test:
make k8s-smoke
- Derrube cluster:
make k8s-kind-down
- Suba cluster + deploy Helm local:
make k8s-k3d-up
- Verifique workloads:
make k8s-status
- Derrube cluster:
make k8s-k3d-down
- Instale Argo CD e aplique Application:
REPO_URL=https://github.com/<user>/linklab.git make gitops-bootstrap
- Abra a UI:
make argocd-ui
- Pegue senha inicial:
make argocd-password
Notas:
- O profile local usa
k8s/helm/linklab/values-local.yaml. values-local.yamlhabilita PostgreSQL e Redis dentro do cluster.- API local no Kubernetes fica em
http://localhost:8081.
- Manifests crús em
k8s/*.yaml. - Chart Helm em
k8s/helm/linklabcomvalues-dev.yaml,values-prod.yamlevalues-local.yaml. - Exemplo de VirtualService Istio em
k8s/istio/virtual-service.yaml. - Argo CD Application em
k8s/argocd/linklab-app.yaml, profile local emk8s/argocd/linklab-app-local.yaml, e Crossplane S3 emk8s/crossplane/s3-bucket.yaml.
- Módulos Terraform em
infra/modulespara VPC, EKS, RDS, S3, Lambda, ECR. - Terragrunt em
infra/environments/{dev,prod}. Rode, por exemplo:cd infra/environments/dev/vpc && terragrunt apply
- Alertas Prometheus em
monitoring/alerts.yaml. - Config Thanos S3 em
monitoring/thanos-s3.yaml.
- GitHub Actions pipeline em
.github/workflows/ci.yml(testes Go/Python, build e push para ECR, atualização de Helm).
- API/Worker esperam
DATABASE_URLeREDIS_URL. - Lambda local aceita
AWS_ENDPOINT_URL/S3_ENDPOINT_URLpara apontar para LocalStack/MinIO. - Helm/K8s usam Secret
linklab-secrets(substitua valores antes de aplicar). - Substitua
REPLACE_ECReREPLACE_USERnos manifests com seu registry e repositório.
- Quando AWS estiver disponível, mover para módulos Terraform em
infra/modules. - Popular secrets no cluster e atualizar
values*.yamlcom URLs reais do RDS/ElastiCache. - Trocar endpoint LocalStack por S3/Lambda reais no deploy cloud.