urieljarethandClaude Opus 4.8 e7d1c33cd5 deploy_skill: soporte para Coolify v4.1.2 (API /applications 404) + flujo UI Playwright
Aprendido desplegando cotizador (Next.js+FastAPI+Postgres, Docker Compose,
repo privado) en coolify.urieljareth.org (v4.1.2):

- Documenta que /applications/* devuelve 404 en esta instancia y que configurar
  apps git build-from-source solo es posible por la UI web.
- Nuevos scripts scripts/coolify-ui/: coolify-login.mjs (guarda storageState) y
  Configure-CoolifyComposeApp.mjs (build pack -> Docker Compose, Reload Compose
  File, env vars por Developer view, dominios por servicio).
- references/coolify-4.1.2-notes.md: mapa de API funcional/404, gotchas (BOM
  UTF-8 rompe el parser YAML de Coolify; Reload Compose File obligatorio; pin de
  dominios por servicio o 503; no encolar deploys concurrentes; PowerShell
  [IO.File]::ReadAllText para payloads de llaves).
- env.local.template.ps1: COOLIFY_EMAIL/COOLIFY_PASSWORD para la UI.
- SKILL.md/TOOLS.md: seccion "instance reality" y flujo UI paso a paso.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-07-08 00:42:12 -06:00

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:

.\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.
S
Description
No description provided
Readme
230 KiB
Languages
PowerShell 69%
Shell 21.7%
JavaScript 8.5%
PHP 0.8%