Remote
Gerencie máquinas remotas definidas em infra/remotes/*.yaml.
Leia o arquivo referenciado SOMENTE quando acionado.
Guarda
remotes.enabled deve ser true em bridge-config.yaml. Caso contrário: informe e saia.
Argumentos
| Argumento | Efeito | Padrão |
|---|---|---|
(nenhum) | Painel de todos os remotos | — |
{hostname} | Visão detalhada de um remoto | — |
health {hostname} | Verificação de saúde SSH | — |
logs {hostname} {service} | Mostrar logs recentes | — |
restart {hostname} {service} | Reiniciar serviço | — |
sync {hostname} | Sincronizar arquivos de configuração | — |
wake {hostname} | Wake-on-LAN | — |
connect {hostname} | Abrir sessão SSH / RDP | — |
shutdown {hostname} | Desligar (requer [y]) | — |
reboot {hostname} | Reiniciar máquina (requer [y]) | — |
Árvore de Decisão
Usuário quer...
├── Visão geral / painel de remotos → Ler references/workflow.md (§ Painel)
├── Visão detalhada de uma máquina → Ler references/workflow.md (§ Painel, host único)
├── Ligar / ativar uma máquina → Ler references/fleet.md (§ Etapa 3 WoL)
├── Conectar via SSH / RDP → Ler references/fleet.md (§ Etapa 4 Conectar)
├── Reiniciar ou desligar → Ler references/fleet.md (§ Etapa 5)
├── Verificar acessibilidade / online? → Ler references/fleet.md (§ Etapa 2)
├── Atualizar inventário após mudança → Ler references/fleet.md (§ Etapa 6)
├── Verificação de saúde de uma máquina → Ler references/workflow.md (§ Verificação de Saúde)
├── Visualizar logs de serviço → Ler references/workflow.md (§ Logs)
├── Reiniciar um serviço → Ler references/workflow.md (§ Reiniciar)
├── Sincronizar configuração para remoto → Ler references/workflow.md (§ Sincronizar)
├── Implantar serviços em um remoto → Ler references/workflow.md (§ Implantar)
├── Identificar "meu PC" / apenas intenção → Ler references/fleet.md (§ Etapa 1 + Roteamento aprendido)
└── Perguntas sobre remotos → Responder a partir de CLAUDE.md § Remotos
Mapa de referência
| Arquivo | É responsável por |
|---|---|
references/fleet.md | Inventário, WoL, conectar, desligar, acessibilidade, roteamento "meu PC" |
references/workflow.md | Painel de serviços, saúde, logs, reiniciar, sincronizar, implantar |
Regras rígidas (não negociáveis)
- Tailscale primeiro, LAN como fallback — LAN falha em VPN ou redes estrangeiras
- Nenhuma operação destrutiva (desligar, reiniciar, formatar) sem
[y]por ação - Nunca armazene credenciais em
infra/remotes/*.yaml— apenas URIs do KeyVault / 1Password - Respeite
wake_on_lan.enabled: false— nunca force ativação de uma máquina que optou por não participar - Leia
infra/remotes/{target}.yamlantes de qualquer operação — sem adivinhações