Files

T

urieljareth f587a8baa2 Agrega scripts y runbooks: Cloudflare API, autostart Coolify, parche Chatwoot, deploy Solo Leveling + docs de casos

- scripts/Invoke-CloudflareApi.ps1: control de tunnel/DNS via API
- scripts/Install-CoolifyAutostart.ps1 + scripts/host/: autostart de LXC 102 + tunnel tras corte
- scripts/Apply-ChatwootEnterprisePatch.ps1: parche enterprise (autodetecta creds)
- Deploy-SoloLeveling.ps1: deploy build-on-server verificado
- docs/runbooks/cloudflare-tunnel.md y autostart-coolify.md
- docs/casos/chatwoot-enterprise-patch.md (credenciales redactadas)
- docs/AGENTS-coolify-apps.md + issues y reportes
- deploy_skill/references/coolify-4.1.2-notes.md: hallazgos verificados (seccion 7)
- package.json para verify-online.mjs del coolify-deploy skill
- .gitignore: excluye .claude/ y .opencode/ (config local de herramientas)

2026-07-18 11:31:31 -06:00

2.8 KiB

Raw Blame History

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.
deploy_skill/: skill para deployar proyectos nuevos a Coolify de punta a punta (scaffold Dockerfile/compose → checklist → repo GitHub → push → alta via API → deploy → verificacion → rollback). Necesita GITHUB_TOKEN y COOLIFY_TOKEN en .env.local.ps1.
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.
docs/casos/: casos verificados paso a paso (ej. chatwoot-enterprise-patch.md).
docs/AGENTS-coolify-apps.md: guia para agentes/LLMs que desarrollan una app destinada a esta instancia de Coolify (reglas de red, puertos, dominios/TLS, env, volumenes, healthchecks) + checklist pre-deploy.
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:

.\scripts\Set-ProxmoxEnv.example.ps1

Prueba de conexion:

.\scripts\Test-ProxmoxConnection.ps1

Inventario rapido:

.\scripts\Get-ProxmoxInventory.ps1

Comando SSH puntual:

.\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.