rdd-cicd-workflow
Cria e mantém o pipeline de deploy GitHub Actions dos repos de produto da organização (deploy.yml): build da imagem → push para o registry do perfil (ex.: ghcr.io/<org>) → deploy via appleboy/ssh-action → scripts/deploy.sh na VPS (git pull + docker compose pull/up). Dois modos: gerar workflow novo para repo sem CI/CD e auditar/diagnosticar workflow existente com sintomas conhecidos (secret SSH errado, chave deploy_action_key trocada com a Deploy Key, registry denied no push, nome de secret case-sensitive, workflow silenciosamente não disparando). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-cicd (IMP-105). Use quando o usuário pedir "criar pipeline de deploy", "deploy.yml", "github actions de deploy", "workflow de deploy", "CI/CD do repo", "pipeline não dispara" ou "auditar workflow de deploy".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-cicd-workflow
- description
- Cria e mantém o pipeline de deploy GitHub Actions dos repos de produto da organização (deploy.yml): build da imagem → push para o registry do perfil (ex.: ghcr.io/<org>) → deploy via appleboy/ssh-action → scripts/deploy.sh na VPS (git pull + docker compose pull/up). Dois modos: gerar workflow novo para repo sem CI/CD e auditar/diagnosticar workflow existente com sintomas conhecidos (secret SSH errado, chave deploy_action_key trocada com a Deploy Key, registry denied no push, nome de secret case-sensitive, workflow silenciosamente não disparando). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-cicd (IMP-105). Use quando o usuário pedir "criar pipeline de deploy", "deploy.yml", "github actions de deploy", "workflow de deploy", "CI/CD do repo", "pipeline não dispara" ou "auditar workflow de deploy".
03 SKILL.md 正文
rdd-cicd-workflow — Pipeline de Deploy GitHub Actions
Cria o deploy.yml padrão da organização em repos de produto
(<PROJETO>-API, -FE, etc., branch main) e audita workflows existentes
contra os padrões validados em produção. Base de conhecimento validada:
pack rules/<pack-da-organizacao>.md §infra-cicd (IMP-105) — template do deploy.yml,
tabela de secrets e matriz de diagnóstico por sintoma. Org/registry/hostnames
vêm do rules/client-profile.md (org_github, ghcr_registry); para outra
organização, derive os valores do perfil da org.
Diferenciação
| Skill | Escopo |
|---|---|
rdd-cicd-workflow (esta) |
O arquivo de workflow no repo (deploy.yml, secrets do GitHub, gatilhos, audit) |
rdd-vps-setup |
A infra na VPS que o workflow consome (deploy key, chave SSH da action, registry login, tunnel) |
rdd-vps-troubleshoot |
Sintomas na VPS depois que o deploy rodou (unhealthy, porta, banco vazio) |
rdd-gh-setup |
gh CLI na máquina local — autenticação, não workflows |
Regra de fronteira: se o workflow nem disparou ou falhou no build/push/SSH,
é esta skill; se o deploy.sh rodou e o container ficou doente na VPS, é a
rdd-vps-troubleshoot.
Lê (upstream)
rules/client-profile.md(IMP-103/IMP-105) —org_github,ghcr_registry,dns_domain(hostnames de validação)- Pack da organização (
rules/<pack-da-organizacao>.md§infra-cicd; IMP-105) — template validado do workflow, tabela de secrets e matriz de diagnóstico por sintoma - O repo alvo (local): existência de
Dockerfile,docker-compose.prod.yml,scripts/deploy.sh, estrutura do projeto — para adaptar o template ghCLI para secrets existentes:gh secret list -R <org>/<repo>(lista NOMES apenas — nunca valor)
Gera (downstream)
.github/workflows/deploy.ymlno repo alvo (escrito com confirmação prévia do operador — dry-run mostrando o YAML antes de gravar)- Checklist de secrets a cadastrar no GitHub (nomes + onde obter o valor — nunca o valor em si no chat)
- Relatório de auditoria (modo diagnóstico): causa raiz + correção por sintoma
Fluxo de Trabalho
Modo 1 — Gerar workflow novo
- Inventário do repo: confirmar Dockerfile, compose de produção e
scripts/deploy.sh(executável na VPS). Se deploy.sh não existir, orientar criação seguindo o padrão do pack §infra-cicd item 3 (git pull + compose pull/up) ANTES do workflow — o workflow assume deploy.sh presente. - Coletar contexto (uma
questionagrupada): org/repo (org_githubdo perfil como default), servidor VPS de destino (host, user, porta), nome do serviço no compose, branch de deploy (padrãomain), registry de imagens (ghcr_registrydo perfil; ex.:ghcr.io/<org>). - Gerar deploy.yml a partir do template do pack (§infra-cicd item 1)
— tags da imagem
<ghcr_registry>/<projeto>:latest— dry-run: mostrar o YAML completo e o checklist de secrets (SSH_HOST,SSH_USERNAME,SSH_PRIVATE_KEY, token do registry comwrite:packages). - Confirmar → gravar
.github/workflows/deploy.yml. - Validar ponta a ponta: push de teste → rodada da Action →
docker psna VPS mostrando o container(healthy)(o operador cola o output).
Modo 2 — Auditar workflow existente
- Ler o
deploy.ymldo repo egh secret list(nomes apenas). - Triar pela matriz de sintomas do pack (§infra-cicd item 5):
- Action nem dispara → trigger/path/filial errada ou workflow desabilitado
- Falha no SSH (handshake, ParsePrivateKey) → secret
SSH_PRIVATE_KEYtruncado ou sem BEGIN/END; chave trocada com a Deploy Key da VPS - Conecta na mão mas falha no workflow → secret colado errado, não a VPS
deniedno push do registry → token semwrite:packages/ permissão do pacote- Deploy roda mas nada muda → deploy.sh não executável ou compose errado
- Corretivas que alteram o workflow ou secrets: mostrar diff/explicação e confirmar antes de aplicar.
Nunca edita
scripts/deploy.shna VPS (remoto) — orientar o operador; edição local de deploy.sh no repo só com confirmação explícita- Valor de secrets — nunca imprimir, logar ou commitar token/chave privada
- Workflows de outros repos fora do alvo confirmado
Tools disponíveis
read,glob,grep— inventário do repo, leitura de workflows e do packwrite/edit— criar/atualizar.github/workflows/deploy.yml(com confirmação)bash— apenasghlocal de leitura (gh secret list,gh run list)question— coleta de contexto e confirmaçõeswebsearch/webfetch— versões de actions (appleboy/ssh-action) quando necessário
Modo de erro
- Repo sem Dockerfile → ABORTAR modo 1 com orientação (workflow sem imagem para build não faz sentido; sugerir rdd-dev para criar o Dockerfile)
ghnão autenticado → encaminharrdd-gh-setupe parar- Servidor de destino indefinido → não gerar workflow com placeholder de host
- Perfil sem
ghcr_registry/org_github→ pergunte ao operador (umaquestionagrupada) antes de gerar o workflow — nunca assuma org
Casos de borda
- Repo FE sem Docker (build estático) → workflow de build+deploy de artefatos só se houver padrão validado no pack §infra-cicd; senão sinalizar como gap
- Monorepo multi-serviço → um job de deploy por serviço, secrets compartilhados
- Operador pede deploy em push de tag → aceitável, documentar no workflow
- Workflow com actions de terceiros desconhecidas → auditar pinning por SHA e sinalizar, não reescrever por gosto
- Organização sem pack (
rules/<pack-da-organizacao>.mdausente) → derive o template do §infra-cicd adaptando registry/org para o perfil; lições de produção novas devem nascer no pack da org (proponha criá-lo via rdd-workflow-builder)
Formato de commit
ci(<repo>): adiciona/ajusta pipeline de deploy (build → registry → ssh-action)
04 同仓库更多 Skills
rdd-wiki-lint
Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir "lint dos documentos", "verificar integridade dos artefatos", "wiki lint", "contradições nos docs" ou "validar estrutura".
rdd-vps-troubleshoot
Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy / healthcheck expirando, GHCR denied/unauthorized no pull, git "could not read Username for 'https://github.com'", GitHub Actions (appleboy/ssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl / docker logs), conectividade (curl local vs público, ss, nc) e banco vazio / migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules/<pack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar "container unhealthy", "deploy falhou", "ssh action erro", "ghcr denied", "tunnel não responde", "banco vazio", "sem tabelas", "service duplicado", "vps com problema" ou pedir troubleshooting de deploy.
rdd-vps-setup
Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy/ssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir "setup de VPS", "configurar VPS nova", "preparar servidor para deploy", "tunnel cloudflare", "ghcr", "deploy key", "backup rclone", "docker compose na vps" ou "pipeline de deploy na VPS".
rdd-validate
Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir "validar integridade", "checar a DAG", "validar referências cruzadas" ou "validação do módulo".
rdd-ui-spec
Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".
rdd-ui-capture
Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota/estado, requisições de rede observadas e erros de console, gravados em reverse/ui/ com manifesto reverse/UI_CAPTURE.md e candidatas visuais na fila reverse/CANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir "captura visual", "golden master de UI", "screenshots do legado", "captura de UI" ou "ui capture".