# Specsfy Specialist Docker Swarm

> Projetar, implantar e operar stacks Docker Swarm com serviços, overlay networks, secrets, configs, placement, rollout, rollback e recuperação do quorum. Use para swarm init, docker stack, services, managers, workers e arquivos de stack; não use Compose local como evidência de comportamento do Swarm.

- Skill: `promovaweb/specsfy-specialist-docker-swarm-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add promovaweb/specsfy-specialist-docker-swarm-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/promovaweb/specsfy-specialist-docker-swarm-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: promovaweb (https://skillmd.com/u/promovaweb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/promovaweb/specsfy-specialist-docker-swarm-2

---


# Docker Swarm

## Fluxo

1. Mapear managers, workers, zonas, labels, quorum e dependências externas.
2. Validar imagens publicadas e compatibilidade do arquivo com `docker stack deploy`.
3. Definir services, redes, ports, volumes, configs e secrets por owner.
4. Configurar replicas, placement, resources, health e restart policy.
5. Projetar `update_config`, `rollback_config` e compatibilidade durante rollout.
6. Validar a stack em swarm representativo e observar convergência.
7. Documentar deploy, rollback, rotação, backup do estado e recuperação.

## Padrões

- Manter número ímpar de managers e proteger quorum.
- Publicar imagens imutáveis acessíveis por todos os nodes.
- Usar secrets/configs versionados por nome; nunca embutir segredo no YAML.
- Separar ingress, redes internas e tráfego de dados.
- Definir reservations e limits; não depender de capacidade implícita.
- Aplicar constraints somente com labels administradas.
- Não assumir que toda opção moderna do Compose é aceita por stack deploy.

## Validação

- Executar `docker stack config` ou validação equivalente antes do deploy.
- Observar `service ps`, replicas, health, logs e eventos durante rollout.
- Simular falha de worker e, em ambiente autorizado, perda de manager.
- Provar rollback de aplicação e compatibilidade de migrations.

Leia [references/standards.md](references/standards.md) para topologia, serviços,
secrets, redes, rollout e disaster recovery.