Orion DevOps — Deploy Skills

Ecossistema de deploy skills que transforma qualquer CLI de IA agêntica (Claude Code, Gemini CLI, Codex CLI…) em um assistente DevOps para instalar stacks Docker Swarm no padrão Setup Orion.

Núcleo 100% bash puro — agnóstico de agente. Fonte: SetupOrion · oriondesign.art.br

# 1. instale uma CLI de IA (Claude, Gemini ou Codex — veja abaixo)
# 2. clone o repositório
git clone https://github.com/alltomatos/devops.git && cd devops
# 3. abra a CLI e invoque o assistente DevOps
claude            # ou: gemini   |   codex
> /devops         # (Claude) renderiza o catálogo e conduz o deploy

No Windows? Sem problema: a CLI roda local e faz o deploy remoto na sua VPS via SSH (nada é instalado manualmente no servidor).

O repositório funciona com qualquer agente compatível, porque as skills são scripts bash + metadata.json. As diretivas do projeto ficam em CLAUDE.md (o Claude lê automaticamente; para Gemini/Codex, basta apontá-los para esse arquivo).

# Node 24 via nvm (recomendado)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24 --lts && nvm use 24 && nvm alias default 24
node -v   # v22.x.x

# Git (geralmente já presente)
sudo apt-get install -y git    # Debian/Ubuntu   |   brew install git (macOS)

Alternativa Debian/Ubuntu p/ Node: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs

No Windows a CLI roda localmente e faz o deploy remoto na VPS via SSH. Instale Node 22 e Git for Windows (este traz git, Git Bash, ssh, ssh-keygen e scp — necessários para a orquestração remota).

# Via winget (PowerShell) — recomendado
winget install OpenJS.NodeJS.LTS      # Node.js 22 LTS
winget install Git.Git                # Git for Windows (inclui Git Bash + ssh)

# feche e reabra o terminal, depois verifique:
node -v   # v22.x.x
git --version
ssh -V    # OpenSSH (vem com o Git for Windows / Windows 10+)

Alternativas: instaladores oficiais nodejs.org e git-scm.com, ou choco install nodejs-lts git (Chocolatey). Dica: use o Git Bash (ou PowerShell) para rodar a CLI; o ssh/ssh-keygen do Git for Windows é usado pelo /devops para configurar o acesso por chave à VPS.

npm install -g @anthropic-ai/claude-code
claude --version
claude            # primeiro uso pede login (browser)

Requer conta Anthropic com acesso ao Claude Code. Suporte nativo a skills (/devops, /status-ecossistema, etc.).

npm install -g @google/gemini-cli
gemini --version
gemini            # faça login com sua conta Google pessoal

Plano gratuito generoso logando com conta Google pessoal (sem cartão) — ótimo para começar sem custo. As diretivas ficam em CLAUDE.md; para o Gemini lê-las automaticamente, crie um atalho:

ln -s CLAUDE.md GEMINI.md      # Linux/macOS

npm install -g @openai/codex
codex --version
codex             # primeiro uso pede login/API key

Para o Codex carregar as diretivas, aponte-o ao CLAUDE.md:

ln -s CLAUDE.md AGENTS.md      # Linux/macOS

💡 Por que funciona em qualquer CLI? Os run.sh e o lib-persistence.sh são bash puro (sem Python/Node em runtime). O agente apenas lê o metadata.json, coleta os inputs e executa o run.sh no destino. A inteligência de orquestração está no CLAUDE.md + scripts auxiliares — não em um agente específico.

1. Clone o repositório (local, na sua máquina — Windows/Linux/macOS):

   git clone https://github.com/alltomatos/devops.git && cd devops

2. Abra a CLI escolhida (claude / gemini / codex).
3. Inicie o assistente DevOps:
   • No Claude: digite /devops.
   • No Gemini/Codex: peça "aja como o assistente DevOps do CLAUDE.md e renderize o catálogo".
4. Selecione o ambiente:
   • REMOTO (padrão no Windows): informe SSH_HOST (ex.: root@1.2.3.4). O agente valida o acesso por chave SSH, clona o repo na VPS (/root/devops) e roda tudo via SSH.
   • LOCAL: quando a própria CLI roda na VPS Linux.
5. Escolha a stack pelo número/nome do catálogo. O agente resolve dependências, coleta inputs e faz o deploy.

Comandos do assistente (Claude):

A escolha do modo de deploy não é opcional — replica o comportamento consolidado do Setup Orion:

O app-traefik cria o admin do Portainer via API automaticamente e persiste as credenciais; a partir daí, toda app é criada via deploy_via_portainer (em skills/00-core/lib-persistence.sh).

Cada skill em skills/<nome>/ é atômica e idempotente:

Fluxo: agente coleta inputs → valida deps/pré-flight → injeta variáveis → executa run.sh → deploy (API Portainer) → persiste em /root/dados_vps/dados_<servico>

Os dados de cada instalação ficam em /root/dados_vps/dados_<servico> (sem extensão), no formato:

[ POSTGRES ]

Host: postgres

Port: 5432

Usuario: postgres

Senha: <senha>

• Skills dependentes leem as credenciais via grep "Senha:" dados_<dep> | awk '{print $2}'.
• Arquivos com chmod 600; /root é restrito a root.
• Há um arquivo global dados_vps (nome do servidor, rede interna, email SSL, link do Portainer) e dados_portainer (credenciais do admin para a API).

• Zero hardcode no git: segredos são gerados em runtime (openssl rand) ou recebidos por env — nunca commitados (ADR-002).
• Persistência operacional na VPS: credenciais ficam em /root/dados_vps/dados_<servico> com chmod 600 (necessário para o modelo de dependências entre stacks). Recomenda-se disco criptografado/backup seguro.
• SSH só por chave: o assistente nunca pede senha SSH; guia a configuração de chave.
• Mascaramento: valores sensíveis não aparecem em resumos/logs do chat.

São ~103 skills cobrindo bancos, IA/LLM, WhatsApp, CRM, low-code, produtividade, docs, segurança, monitoramento e utilitários. O catálogo com status real é renderizado pelo /devops.

Detalhes de negócio: Catálogo de Soluções · Roadmap: ORCHESTRATOR-ROADMAP.md

Técnica e catálogo baseados no Setup Orion — oriondesign.art.br. Atribuição ao autor original.