Repolode
Enviar
kimdre

kimdre/doco-cd

Ferramenta GitOps leve que implanta e atualiza projetos Docker Compose e stacks Swarm a partir do Git, por polling ou webhooks.

Ver no GitHubSite
Estrelas
1,767
Forks
66
Issues abertas
19
Último commit
há 13 horas

O que é?

doco-cd é uma ferramenta declarativa de entrega contínua para Docker. Ela monitora repositórios Git ou artefatos OCI e implanta e atualiza projetos Docker Compose e stacks Swarm automaticamente, usando polling ou webhooks como gatilho. É apresentada como uma alternativa mais simples ao Portainer ou ArgoCD para hosts Docker.

O projeto é distribuído como uma imagem distroless, com baixo consumo de RAM e CPU. Os secrets podem ser obtidos de provedores externos ou criptografados com SOPS, e uma única instância pode implantar em vários hosts Docker por meio de Docker Contexts. É possível limitar as implantações a janelas de sincronização que levam o fuso horário em conta, e scripts de pré e pós-implantação são executados a cada atualização.

Para monitoramento e automação, o doco-cd expõe métricas do Prometheus, envia notificações e oferece uma REST API e um servidor MCP.

Recursos principais

  • 01Implanta projetos Docker Compose e stacks Swarm a partir de repositórios Git ou artefatos OCI.
  • 02Aciona implantações por webhooks, polling ou polling agendado com cron.
  • 03Descriptografa arquivos criptografados com SOPS e obtém secrets de provedores externos.
  • 04Implanta em vários hosts Docker por meio de Docker Contexts.
  • 05Expõe métricas do Prometheus, notificações, uma REST API e um servidor MCP.

Casos de uso

  • Executar serviços auto-hospedados em um único host Docker, usando o Git como fonte da verdade.
  • Implantar a mesma stack Compose em vários hosts Docker a partir de uma única configuração.
  • Restringir implantações em produção a janelas de horário específicas.
  • Substituir etapas manuais de docker compose up por atualizações automatizadas no estilo GitOps.

Tópicos

#gitops#docker-compose#continuous-deployment#docker#docker-swarm#webhook#devops#continuous-delivery#doco-cd#swarm-mode

Perguntas frequentes

O que é doco-cd?
Ferramenta GitOps leve que implanta e atualiza projetos Docker Compose e stacks Swarm a partir do Git, por polling ou webhooks. doco-cd é uma ferramenta declarativa de entrega contínua para Docker. Ela monitora repositórios Git ou artefatos OCI e implanta e atualiza projetos Docker Compose e stacks Swarm automaticamente, usando polling ou webhooks como gatilho. É apresentada como uma alternativa mais simples ao Portainer ou ArgoCD para hosts Docker.
doco-cd é gratuito? Qual é a licença?
doco-cd é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
doco-cd ainda é mantido?
Manutenção ativa. O último commit de doco-cd foi em 7 de nov. de 2026.
Para que posso usar doco-cd?
Executar serviços auto-hospedados em um único host Docker, usando o Git como fonte da verdade. Implantar a mesma stack Compose em vários hosts Docker a partir de uma única configuração. Restringir implantações em produção a janelas de horário específicas. Substituir etapas manuais de docker compose up por atualizações automatizadas no estilo GitOps.
Onde consigo doco-cd?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kimdre/doco-cd

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados