docs: registrar soluciones symlinks, NPM Cache Assets 502 y favicon

This commit is contained in:
2026-06-05 12:41:29 -05:00
parent d13005a3c4
commit efcf9afc32
2 changed files with 30 additions and 0 deletions
+28
View File
@@ -85,8 +85,36 @@ python3 -c "import zipfile,shutil,os; ..."
# Desde el servidor de producción:
curl -s -o /dev/null -w "HTTP %{http_code}" http://127.0.0.1:8081/
curl -sI http://127.0.0.1:8081/?cv_pdf=1 | grep Content-Type
curl -s -o /dev/null -w "favicon: HTTP %{http_code}\n" http://127.0.0.1:8081/favicon.ico
```
## Problemas conocidos y soluciones
### 502 Bad Gateway general
El servicio escucha en `0.0.0.0:8081`. Si queda en `127.0.0.1` NPM no puede alcanzarlo.
### 502 en recursos estáticos (CSS, JS, favicon) con NPM Cache Assets activado
NPM cachéa respuestas de error (502/404). Si un recurso faltaba antes y ahora existe,
NPM sigue sirviendo la respuesta vieja desde caché.
**Solución:** en NPM, desactivar **Cache Assets** → guardar → reactivar → guardar.
Para un sitio CV, **Cache Assets puede quedarse desactivado** sin impacto notable.
### CSS/JS con 404 tras clonar el repo en un servidor nuevo
Los symlinks `persona-cv`, `lumina` y `cvolio` en `wp-content/themes/` usan **rutas relativas**
(`../../../../frontend/...`). Si al clonar quedan rotos, recrearlos:
```bash
THEMES='/opt/apps/pflores.linkedcorp.net/backend/wordpress/wp-content/themes'
FRONTEND='/opt/apps/pflores.linkedcorp.net/frontend'
rm -f $THEMES/persona-cv $THEMES/lumina $THEMES/cvolio
ln -s $FRONTEND/persona-cv-theme $THEMES/persona-cv
ln -s $FRONTEND/lumina-cv-theme $THEMES/lumina
ln -s $FRONTEND/cvfolio-theme $THEMES/cvolio
```
### favicon.ico
El archivo `backend/wordpress/favicon.ico` está en git (foto de Patricia, 16/32/48px).
No hace falta recrearlo manualmente.
## Pendientes
- [ ] Configurar SMTP en WP Mail SMTP