O DockWatch é um daemon de gerenciamento e auto-healing para containers Docker, projetado em Go. Ele monitora eventos do Docker local em tempo real e reativa automaticamente containers críticos que venham a falhar.
Funcionalidades
- Auto-Healing baseado em Labels: Monitora eventos do Docker e reinicia instantaneamente qualquer container que pare (evento
die) e que possua a labelwatchdog.enable=true. - Servidor HTTP de Status: Expõe uma rota leve de status na porta
49180(endpoint/status) que responde em formato JSON, ideal para monitoramento de saúde do próprio daemon. - Graceful Shutdown: Encerra todas as goroutines e conexões de rede graciosamente ao receber sinais
SIGINTouSIGTERMdo sistema operacional. - Sem Bloqueios: O monitor de eventos, os processos de auto-healing e o servidor de status operam concorrentemente sem bloquear o fluxo principal.
Como Executar os Testes Unitários
Para testar o projeto localmente garantindo que a lógica de status e de auto-healing (com mocks do Docker SDK) permaneça íntegra:
go test -v ./...
Como Compilar (Cross-Compilation para Linux)
Como o desenvolvimento é feito em computadores Mac (Apple Silicon), mas o alvo de execução final são servidores Linux (AMD64 / x86_64), utilize o compilador do Go com as variáveis de ambiente de build cruzado:
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-w -s" -o dockwatch-linux-amd64 .
Explicação dos Parâmetros:
CGO_ENABLED=0: Desabilita o uso de CGO, compilando o binário de forma totalmente estática e independente de bibliotecas dinâmicas C locais do macOS.GOOS=linux: Define o sistema operacional final como Linux.GOARCH=amd64: Define a arquitetura final como AMD64 (64-bits Intel/AMD). Caso vá rodar em servidores Linux ARM64, utilizeGOARCH=arm64.-ldflags="-w -s": Remove tabelas de símbolos e informações de depuração para otimizar o tamanho do binário final gerado.
docker buildx build --platform linux/amd64,linux/arm64 -t lkaranl/dockwatch:latest -f Docker/Dockerfile --push .