DockWatch - Daemon de gerenciamento e auto-healing para containers Docker

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 label watchdog.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 SIGINT ou SIGTERM do 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, utilize GOARCH=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 .
1 curtida