docs: formalize static vps identity protocol and agent safety obligations
This commit is contained in:
@@ -15,6 +15,28 @@ Antes de qualquer ação, identifique seu IP interno:
|
|||||||
- **Interface wg0**: É a sua linha de vida. Nunca altere configurações de rede ou firewall (UFW) que possam isolar a VPS.
|
- **Interface wg0**: É a sua linha de vida. Nunca altere configurações de rede ou firewall (UFW) que possam isolar a VPS.
|
||||||
- **Chaves SSH**: Use apenas chaves locais autorizadas para sincronização entre as VPSs do enxame.
|
- **Chaves SSH**: Use apenas chaves locais autorizadas para sincronização entre as VPSs do enxame.
|
||||||
|
|
||||||
|
## 📇 Protocolo de Identidade Estática (`~/.vps_identity`)
|
||||||
|
Para garantir 100% de consciência situacional à prova de falhas sem depender de chamadas de rede externas, cada máquina do enxame possui um arquivo de identidade em `/home/deploy/.vps_identity`.
|
||||||
|
|
||||||
|
### 📄 Estrutura Obrigatória do JSON:
|
||||||
|
Todo arquivo `.vps_identity` deve conter exatamente a seguinte estrutura:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"vps_id": 4,
|
||||||
|
"vps_name": "VPS-4-LABORATORIO",
|
||||||
|
"ip_vpn": "10.99.0.4",
|
||||||
|
"role": "Desenvolvimento, Builds e Staging",
|
||||||
|
"danger_level": "BAIXO - Liberdade para testar e recriar"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🚨 Obrigações das IAs e Agentes:
|
||||||
|
1. **Verificação Obrigatória**: Toda execução de script ou agente deve prioritariamente ler e interpretar o arquivo `/home/deploy/.vps_identity` para calibrar o seu escopo de atuação.
|
||||||
|
2. **Respeito ao Danger Level (Nível de Perigo)**:
|
||||||
|
- **Nível de Perigo ALTO** (ex: VPS 1, VPS 3): Agentes **NÃO PODEM** rodar comandos experimentais, mutações não homologadas de bancos de dados ou reinstalar dependências críticas sem backups nítidos e aprovação explícita.
|
||||||
|
- **Nível de Perigo BAIXO** (ex: VPS 4): O agente possui total autonomia para realizar testes, compilar códigos, reinstalar pacotes e reiniciar contêineres Docker de staging.
|
||||||
|
3. **Resiliência (Fallback)**: Caso o arquivo `.vps_identity` não exista ou esteja ilegível, o agente deve fazer o fallback dinâmico (buscando o IP `10.99.x.x` via `hostname -I`) e assumir o perfil de segurança mais restritivo por padrão.
|
||||||
|
|
||||||
## 🗣️ Comunicação
|
## 🗣️ Comunicação
|
||||||
- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**.
|
- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**.
|
||||||
- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs.
|
- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs.
|
||||||
|
|||||||
Reference in New Issue
Block a user