Skip to content
BranchesTags

Repository files navigation

DevOps Essentials Lab — 523

Lab GitOps 100% local do curso DevOps Essentials (523) da 4Linux.

Você vai construir um ambiente completo de GitOps — repositório Git, operador de deploy automático, aplicação web e emulador AWS — tudo rodando na sua máquina, sem conta em cloud, sem cartão de crédito.

O que você vai aprender

  • Subir um cluster Kubernetes local com Kind
  • Hospedar um repositório Git com Gitea (self-hosted)
  • Fazer deploys automáticos via ArgoCD (GitOps)
  • Escalar e fazer rollback de aplicações usando apenas git push
  • Emular serviços AWS localmente com Floci
  • Provisionar infraestrutura como código com OpenTofu

Arquitetura

┌─────────────────────────────────────────────────────────┐
│ VM Vagrant │
│ (192.168.56.10) │
│ │
│ Browser / Terminal (do host) │
│ 192.168.56.10:3000 → Gitea (Git server) │
│ 192.168.56.10:8080 → ArgoCD (GitOps operator) │
│ 192.168.56.10:9090 → Aplicação Flask │
│ 192.168.56.10:4566 → Floci (AWS local) │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Cluster Kind (Docker) │ │
│ │ │ │
│ │ namespace: gitea │ │
│ │ └─ gitea-http (Git server via Helm) │ │
│ │ │ │
│ │ namespace: argocd │ │
│ │ └─ argocd-server │ │
│ │ └─ observa gitea/devops-lab.git │ │
│ │ └─ aplica k8s/ no cluster │ │
│ │ │ │
│ │ namespace: devops-lab │ │
│ │ └─ devops-app (Flask — DevOpsLab HelloWorld) │ │
│ │ │ │
│ │ namespace: tools │ │
│ │ └─ floci (S3, SQS, DynamoDB, Lambda...) │ │
│ └──────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

Fluxo GitOps

git push → Gitea → ArgoCD detecta (~3 min) → kubectl apply → app atualizada

Rollback = git revert — o cluster nunca é modificado diretamente.

Pré-requisitos

FerramentaVersão mínimaInstalação
Docker24+docs.docker.com
kind0.27+kind.sigs.k8s.io
kubectl1.32+kubernetes.io/docs/tasks/tools
helm3.16+helm.sh

Hardware recomendado: 8 GB RAM, 4 CPUs, 20 GB de disco livre.

Início rápido

Com Vagrant (recomendado para o curso)

# 1. Subir a VM (~10-15 minutos na primeira vez — instala todas as ferramentas)
vagrant up
# 2. Entrar na VM
vagrant ssh
# 3. Subir o lab completo (~5-10 minutos)cd~/523
bash setup.sh

Após o setup, acesse pelo host (sua máquina física):

ServiçoEndereçoCredenciais
Giteahttp://192.168.56.10:3000gitadmin / gitadmin123
ArgoCDhttp://192.168.56.10:8080admin / (ver abaixo)
Aplicaçãohttp://192.168.56.10:9090—
Flocihttp://192.168.56.10:4566test / test

Sem Vagrant (máquina com Docker + ferramentas já instaladas)

git clone https://github.com/4linux/523.git
cd 523
bash setup.sh
ServiçoEndereçoCredenciais
Giteahttp://localhost:3000gitadmin / gitadmin123
ArgoCDhttp://localhost:8080admin / (ver abaixo)
Aplicaçãohttp://localhost:9090—
Flocihttp://localhost:4566test / test

Senha inicial do ArgoCD:

kubectl -n argocd get secret argocd-initial-admin-secret \
-o jsonpath="{.data.password}"| base64 -d &&echo

Estrutura do repositório

523-devops-essentials-lab/
│
├── setup.sh # Sobe cluster Kind + instala Gitea, ArgoCD, Floci
├── teardown.sh # Destrói o cluster completamente
├── lab.sh # Helpers para o lab guiado
│
├── app/ # Aplicação Flask (DevOpsLab HelloWorld)
│ ├── app.py # Rotas: / e /health
│ ├── Dockerfile
│ ├── requirements.txt
│ ├── static/ # CSS e imagens
│ └── templates/ # HTML (index.html)
│
├── k8s/ # Manifests Kubernetes (gerenciados pelo ArgoCD)
│ ├── deployment.yaml
│ ├── service.yaml
│ ├── configmap.yaml
│ └── kustomization.yaml
│
├── argocd/
│ └── application.yaml # ArgoCD Application apontando para o Gitea
│
└── aws-lab/ # Lab AWS local com Floci
├── test_aws.py # Testes com boto3
└── terraform/
├── main.tf # Provider AWS → Floci (SQS via OpenTofu)
├── variables.tf
└── outputs.tf

Exercícios do lab

Vagrant VM: use 192.168.56.10 no lugar de localhost para acessar os serviços pelo browser do host.

Exercício 1 — Ciclo GitOps completo

Altere a mensagem de boas-vindas da aplicação e veja o ArgoCD fazer o deploy automaticamente.

# 1. Editar o alert bar em app/templates/index.html# Linha: <div class="alert">DevOps Essentials Lab — ...</div># 2. Build da nova imagem
docker build -t devops-app:v2 app/
kind load docker-image devops-app:v2 --name devops-lab
# 3. Atualizar a imagem no deployment
sed -i 's|devops-app:.*|devops-app:v2|' k8s/deployment.yaml
# 4. Commitar e enviar ao Gitea
git add .
git commit -m "feat: atualiza mensagem do alert bar"
git push
# 5. Aguardar o ArgoCD sincronizar (~3 minutos)# Acompanhe em: http://192.168.56.10:8080 (Vagrant) | http://localhost:8080 (direto)# Resultado em: http://192.168.56.10:9090 (Vagrant) | http://localhost:9090 (direto)

Exercício 2 — Escalar a aplicação

sed -i 's/replicas: 1/replicas: 3/' k8s/deployment.yaml
git add k8s/deployment.yaml
git commit -m "scale: aumenta réplicas para 3"
git push
# Verificar os pods subindo
kubectl get pods -n devops-lab -w

Exercício 3 — Rollback via Git

git revert HEAD --no-edit
git push
# O ArgoCD reverte o cluster automaticamente# Sem kubectl, sem acesso direto ao cluster

Exercício 4 — selfHeal: o Git sempre vence

# Tente modificar o cluster diretamente (fora do Git)
kubectl scale deployment devops-app -n devops-lab --replicas=5
# Aguarde ~3 minutos — o ArgoCD vai reverter para o que está no Git
kubectl get pods -n devops-lab

Exercício 5 — SQS com OpenTofu

Os comandos abaixo são executados dentro da VM (vagrant ssh). O Floci está acessível em localhost:4566 de dentro da VM.

cd aws-lab/terraform
tofu init
tofu plan
tofu apply -auto-approve
# Verificar a fila criadaexport AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1
aws sqs list-queues
# Enviar e receber mensagem
aws sqs send-message \
--queue-url http://localhost:4566/000000000000/devops-essentials-lab-queue \
--message-body "Olá do DevOps Essentials!"
aws sqs receive-message \
--queue-url http://localhost:4566/000000000000/devops-essentials-lab-queue
# Destruir a fila
tofu destroy -auto-approve

Exercício 6 — S3 com AWS CLI

Os comandos abaixo são executados dentro da VM (vagrant ssh).

export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1
# Criar bucket e fazer upload
aws s3 mb s3://devops-essentials-lab
echo"Olá do DevOps Essentials!"| aws s3 cp - s3://devops-essentials-lab/hello.txt
# Listar e ler
aws s3 ls s3://devops-essentials-lab/
aws s3 cp s3://devops-essentials-lab/hello.txt -
# Limpar
aws s3 rb s3://devops-essentials-lab --force

Ferramentas do lab

FerramentaPapel no lab
KindCria um cluster Kubernetes dentro do Docker — sem precisar de VM
GiteaServidor Git self-hosted — o "GitHub" local do lab
ArgoCDOperador GitOps — observa o Gitea e sincroniza o cluster automaticamente
FlociEmulador local de serviços AWS (S3, SQS, DynamoDB, Lambda)
OpenTofuIaC open source — fork do Terraform pela Linux Foundation (Apache 2.0)
FlaskFramework web Python — base da aplicação de demonstração
HelmGerenciador de pacotes Kubernetes — instala Gitea e ArgoCD

Troubleshooting

Pod em Pending ou ImagePullBackOff

kubectl describe pod -n devops-lab <nome-do-pod># Imagem não carregada no Kind
kind load docker-image devops-app:latest --name devops-lab

ArgoCD não conecta no Gitea

kubectl exec -n argocd deploy/argocd-server -- \
curl -sf http://gitea-http.gitea.svc.cluster.local:3000
kubectl get pods -n gitea

Floci não responde

kubectl get pods -n tools
kubectl logs -n tools deploy/floci
curl http://localhost:4566/_localstack/health # de dentro da VM

Porta já em uso (sem Vagrant)

lsof -i :3000
lsof -i :8080
# Pare o processo ou rode: bash teardown.sh

Vagrant: VM não inicia

vagrant status
vagrant reload # reinicia a VM
vagrant destroy -f && vagrant up # recria do zero

ArgoCD não sincroniza automaticamente

# Force sync manual
kubectl -n argocd patch app devops-app \
--type merge -p '{"operation":{"initiatedBy":{"username":"admin"},"sync":{"revision":"HEAD"}}}'

Destruir o lab

bash teardown.sh

Remove o cluster Kind e todos os recursos. Não deixa nada para trás.

Sobre o curso

Este lab faz parte do curso DevOps Essentials (523) da 4Linux.

Próximos passos na trilha:

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages