Acesso à VPS de Desenvolvimento — dev externo¶

Referência completa para o dev externo acessar e trabalhar na VPS dev. Atualizar sempre que mudar chave, IP ou permissão.

Dados de acesso¶

SSH — configuração inicial (uma vez só)¶

1. Baixar a chave privada¶

Felipe envia a chave privada via link 1Password. Salvar o conteúdo em:

~/.ssh/hostinger_dev_luiz

2. Ajustar permissões¶

chmod 600 ~/.ssh/hostinger_dev_luiz

3. Conectar¶

ssh -i ~/.ssh/hostinger_dev_luiz luiz@2.24.117.172

4. (Opcional) Alias no ~/.ssh/config¶

Host vps-dev
  HostName 2.24.117.172
  User luiz
  IdentityFile ~/.ssh/hostinger_dev_luiz

Com o alias: ssh vps-dev

Estrutura de pastas¶

/home/luiz/
├── gci-go-whatsapp/      ← pipeline GCI Goiás (Lara)
├── cadencia-app/          ← workers Cadência
├── pd-portal/             ← Portal PD
├── ecuro-mcp/             ← MCP integração eCuro
├── claude-dev-skills/     ← skills compartilhadas do time
├── .claude/               ← Claude Code (settings, skills)
│   ├── settings.json
│   └── skills/
├── .nvm/                  ← Node.js e CLIs por usuário
└── .profile               ← variáveis de ambiente (tokens via 1P)

Variáveis de ambiente (.profile)¶

Carregadas automaticamente ao conectar via SSH:

export NVM_DIR="$HOME/.nvm"
export OP_SERVICE_ACCOUNT_TOKEN="..."   # 1P SA read-only (vault Hostinger VPS)
export VERCEL_TOKEN="..."
export SUPABASE_ACCESS_TOKEN="..."
export GH_TOKEN="..."                   # acesso org Posicionamento-Digital

Se um CLI não aparecer no PATH, rodar: source ~/.profile

CLIs disponíveis¶

Sistema (sempre disponíveis)¶

Por sessão (via nvm — carregar com source ~/.profile)¶

1Password na VPS¶

O op está instalado e autenticado com um Service Account read-only no vault Hostinger VPS. O dev externo não vê os valores — só acessa via CLI.

# Pegar credencial pelo nome do item
op item get "Nome da Key" --fields credential

# Exemplos:
op item get "Anthropic API Key" --fields credential
op item get "Supabase - gci-go" --fields credential

Se op retornar erro de autenticação: avisar Felipe para renovar o SA token.

Sessões com tmux (obrigatório)¶

Sempre abrir tmux antes de trabalhar. Se a conexão cair, o processo continua.

tmux              # nova sessão
tmux attach       # retomar após reconectar

Atalhos dentro do tmux: - Ctrl+B, D — desconectar (sessão continua rodando) - Ctrl+B, C — nova janela - Ctrl+B, N — próxima janela - Ctrl+B, " — dividir horizontalmente

Git e Linear¶

Iniciar issue¶

/linear-start-issue PDL-XX
# Claude Code faz checkout da branch automaticamente

Fluxo de commit e push¶

git add .
git commit -m "feat: PDL-XX descrição do que fez"
git push origin feature/pdl-XX

Fechar issue¶

/linear-close-issue PDL-XX
# Verifica critério de aceite, commit final, push

Claude Code¶

Instalado em /home/luiz/.nvm/. Para usar:

claude

Skills disponíveis (20):

Docker¶

dev externo tem acesso ao Docker sem sudo:

docker compose up -d          # subir containers
docker compose down           # derrubar
docker compose logs -f app    # logs em tempo real
docker ps                     # containers rodando
docker stats                  # uso de recurso

Restrições¶

Firewall¶

Somente porta 22 (SSH) está aberta por padrão. Se precisar expor porta para webhook ou teste externo, pedir pro Felipe liberar via UFW.

Problemas comuns¶

Contato¶

Problemas de infra ou acesso: fala com Felipe diretamente. Issues e entregas: Linear via /linear-start-issue e /linear-close-issue.

Notas Relacionadas¶

Infra/VPS-Hostinger/VPS-Dev/VPS-Dev-Documentacao-Tecnica · Infra/VPS-Hostinger/README · Time/Luiz/Manual-VPS-Dev