ruicesar/instrucoes_gerais
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add new project auto-config protocol to doutrina_agentes

Browse Source
This commit is contained in:
Rui
2026-05-17 09:38:03 +02:00
parent abb92ad7a0
commit beeea9bab4
1 changed files with 22 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
global/doutrina_agentes.md
+22 -4
View File
@@ -37,15 +37,33 @@ Todo arquivo `.vps_identity` deve conter exatamente a seguinte estrutura:
- **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. - **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. 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
- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**.
- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs.
## 🚫 NUNCA... ## 🚫 NUNCA...
- Nunca tente acessar servidores fora da rede 10.99.0.x. - Nunca tente acessar servidores fora da rede 10.99.0.x.
- Nunca exponha senhas ou chaves privadas em logs ou comentários. - Nunca exponha senhas ou chaves privadas em logs ou comentários.
- Nunca altere o serviço `swarm-listener` sem autorização. - Nunca altere o serviço `swarm-listener` sem autorização.
## 🔄 Protocolo de Criação e Configuração de Novos Projetos (Auto-Config de Webhook)
Sempre que um novo projeto for criado no ecossistema Swarm, os agentes e desenvolvedores **devem** seguir e configurar automaticamente a seguinte rotina de integração de CI/CD para que o GitOps funcione perfeitamente:
### 1. Criação Obrigatória do Webhook de Deploy
Todo novo repositório criado no Gitea **DEVE** possuir um Webhook de deploy ativo configurado da seguinte forma:
* **URL de Destino**: `http://10.99.0.3:5000/webhook` (Se configurado externamente) ou `http://127.0.0.1:5000/webhook` (Se configurado de dentro da VPS 3).
* **Tipo de Conteúdo**: `application/json`
* **Segredo (Secret)**: Em branco ou chave secreta padrão.
* **Eventos que disparam**: Apenas o evento de **Push** (Commit enviado).
> [!IMPORTANT]
> **Autonomia do Agente (Auto-Identificação)**:
> Se você (o Agente de IA) identificar que está trabalhando em um **novo projeto** ou que o repositório do projeto atual **não possui** o webhook do Swarm Dispatcher (`http://127.0.0.1:5000/webhook`) configurado no Gitea:
> 1. Você **DEVE** usar a API REST do Gitea para criar ou corrigir esse webhook automaticamente.
> 2. Você **DEVE** garantir a criação do arquivo `.vps_identity` apropriado nas VPSs correspondentes.
> 3. Você **DEVE** estruturar o `docker-compose.yml` do projeto sob a pasta `/home/deploy/stack/<nome-do-projeto>/` seguindo o padrão rootless.
## 🗣️ Comunicação
- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**.
- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs.
## 📂 Diretórios de Projetos e Stacks Ativos (Mapeamento de Preservação) ## 📂 Diretórios de Projetos e Stacks Ativos (Mapeamento de Preservação)
### 🖥️ VPS 1 - Produção (10.99.0.1) ### 🖥️ VPS 1 - Produção (10.99.0.1)