Commit inicial - estructura base del proyecto

2026-05-31 08:24:12 -06:00
commit cd998ce6b0
143 changed files with 18354 additions and 0 deletions
@@ -0,0 +1,70 @@
+# Proxmox & Coolify Manager
+
+Proyecto local para operar Proxmox con ayuda agentica desde Codex.
+
+La idea practica es simple: este repo guarda el contexto, los runbooks y los
+scripts seguros para que Codex pueda diagnosticar y ayudarte a gestionar el host
+Proxmox local sin depender de memoria suelta ni de secretos pegados en Markdown.
+
+## Estado verificado
+
+Verificado el 2026-05-30 desde esta maquina:
+
+- Host Proxmox: `192.168.0.200`
+- Nodo: `thinkcentre`
+- Version: Proxmox VE `9.1.1`
+- Kernel: `6.17.2-1-pve`
+- LXC detectados: `100 hermes`, `102 coolify`
+- Docker corre dentro del LXC `102`
+- SSH con clave local funciona
+- API REST autenticada funciona cuando el token se carga desde entorno
+
+## Estructura
+
+- `agent/SKILL.md`: reglas operativas para que Codex actue como agente Proxmox.
+- `agent/TOOLS.md`: comandos seguros y patrones de uso.
+- `coolify_skill/`: skill local para operar Coolify, Docker en LXC `102` y API
+  de Coolify sin guardar secretos.
+- `docs/proxmox-inventory.md`: inventario verificado y notas de arquitectura.
+- `docs/runbooks/`: procedimientos concretos para conexion, diagnostico y Coolify.
+- `docs/runbooks/nextcloud.md`: recuperacion y fix HTTPS para Nextcloud.
+- `docs/runbooks/baserow.md`: puesta en vivo de Baserow y fix red/Traefik.
+- `scripts/`: wrappers PowerShell para SSH, API e inventario.
+- `PROXMOX/`, `proxmox-agent/`, `proxmox-skill/`: carpetas legacy que ahora apuntan a la documentacion viva.
+
+## Configuracion local
+
+Los secretos no viven en el repo. Usa variables de entorno o un archivo privado
+ignorado por Git, por ejemplo `.env.local.ps1`.
+
+Plantilla:
+
+```powershell
+.\scripts\Set-ProxmoxEnv.example.ps1
+```
+
+Prueba de conexion:
+
+```powershell
+.\scripts\Test-ProxmoxConnection.ps1
+```
+
+Inventario rapido:
+
+```powershell
+.\scripts\Get-ProxmoxInventory.ps1
+```
+
+Comando SSH puntual:
+
+```powershell
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct list"
+```
+
+## Reglas de operacion
+
+- Primero diagnostico de solo lectura.
+- Cambios destructivos requieren confirmacion explicita: borrar, reiniciar,
+  apagar, editar red, mover discos, actualizar paquetes o modificar servicios.
+- Preferir scripts del repo antes que comandos manuales largos.
+- No registrar tokens, passwords ni claves privadas en Markdown.