diff --git a/.gitea/workflows/deploy.yml b/.gitea/workflows/deploy.yml index e7e63aa..e60f27d 100644 --- a/.gitea/workflows/deploy.yml +++ b/.gitea/workflows/deploy.yml @@ -33,17 +33,16 @@ jobs: # better-sqlite3 (v12) requiere C++20; el GCC 8 del sistema (AlmaLinux 8) no lo soporta. # gcc-toolset-12 (GCC 12) ya está instalado en /opt/rh. source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado" - # Config por entorno en el host (la misma que usará el despliegue): - # /etc/localesp/.env define LOCALESP_ADMIN_PREFIX, que el build - # incrusta en el bundle. Sin ella el build falla (sin valor por defecto). + # Config por entorno EN EL REPO (la misma que usará deploy.sh): + # scripts/entornos.env mapea =, que el build + # incrusta en el bundle. Sin entrada para la rama, falla (sin default). . scripts/lib/env.sh slug="$(Slug::from "$BRANCH")" - config="/etc/localesp/${slug}.env" - if [ ! -f "$config" ]; then - echo "::error::Falta $config en el host: crea el fichero con LOCALESP_ADMIN_PREFIX= y relanza" >&2 + prefix="$(Config::admin_prefix "$slug" scripts/entornos.env)" || { + echo "::error::Falta entrada '$slug=' en scripts/entornos.env — añádela y relanza" >&2 exit 1 - fi - set -a; . "$config"; set +a + } + export LOCALESP_ADMIN_PREFIX="$prefix" npm ci npm run build diff --git a/README.md b/README.md index 000a023..6156ae5 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,10 @@ cp .env.example .env # y rellena LOCALESP_ADMIN_PREFIX `envPrefix` (`.env` o entorno en dev/build); `npm run build` falla si falta. - **Desarrollo:** `npm run dev` proxya `/api` y el prefijo admin al backend en `localhost:3000`, leyendo ambos del entorno o de `.env`. +- **Despliegue CI (entorno por rama):** el prefijo de cada entorno se declara + en `scripts/entornos.env` (mapping `slug=prefijo`, en el repo): el workflow + de deploy lo incrusta en el build y `deploy.sh` lo materializa como + `/.env`. Sin entrada para la rama, el deploy falla con mensaje claro. > Nota: sin prefijo configurado el servidor no arranca (no existe modo sin > ocultación). El prefijo viaja en el bundle del frontend, así que esto es diff --git a/openspec/changes/hide-admin-route/design.md b/openspec/changes/hide-admin-route/design.md index d3374ee..0e63488 100644 --- a/openspec/changes/hide-admin-route/design.md +++ b/openspec/changes/hide-admin-route/design.md @@ -26,6 +26,11 @@ > administración también se oculta: vive en la **raíz del prefijo** > (`$LOCALESP_ADMIN_PREFIX`, p. ej. `/administrador`) y la ruta fija `/admin` > pasa a mostrar la web pública. Una sola variable define URL del panel y API. +> +> **Actualización 5 (2026-10-03, petición del usuario):** la config por entorno +> pasa del host (`/etc/localesp/.env`) **al repo**: `scripts/entornos.env` +> mapea `slug=prefijo`. El workflow de deploy la aplica al build y `deploy.sh` +> la materializa como `/.env`. Sin entrada para la rama: fail-fast. ## Context diff --git a/openspec/changes/hide-admin-route/tasks.md b/openspec/changes/hide-admin-route/tasks.md index 78c2425..23faef8 100644 --- a/openspec/changes/hide-admin-route/tasks.md +++ b/openspec/changes/hide-admin-route/tasks.md @@ -24,6 +24,13 @@ > **Actualización 3 (2026-10-02):** eliminada la redundancia `VITE_ADMIN_PREFIX`: > **una sola variable** (`LOCALESP_ADMIN_PREFIX`) para servidor, proxy de dev > y frontend (Vite la expone vía `envPrefix`; `npm run build` falla si falta). +> +> **Actualización 4 (2026-10-03):** el panel admin vive en la raíz del prefijo +> (`/administrador` en prototipo-yb01) y `/admin` muestra la web pública. +> +> **Actualización 5 (2026-10-03):** config por entorno movida del host al repo +> (`scripts/entornos.env`, mapping `slug=prefijo`): el workflow la aplica al +> build y `deploy.sh` genera `/.env` desde ella. Fail-fast sin entrada. ## 1. Revisión de rutas existentes diff --git a/scripts/entornos.env b/scripts/entornos.env new file mode 100644 index 0000000..6b46426 --- /dev/null +++ b/scripts/entornos.env @@ -0,0 +1,11 @@ +# entornos.env — prefijo admin por entorno de rama (una línea: =) +# +# El slug es el nombre de rama normalizado (minúsculas, [a-z0-9-]), igual que +# Slug::from en scripts/lib/env.sh. LOCALESP_ADMIN_PREFIX es obligatoria: sin +# entrada para el slug, build y deploy fallan (sin valor por defecto). +# El prefijo NO es secreto: viaja igualmente en el bundle del frontend. +# +# Nuevos entornos: añade una línea con el slug de tu rama. +prototipo-yb01=/administrador +# master=/administrador +# prototipo-yb01-ef=/administrador diff --git a/scripts/lib/env.sh b/scripts/lib/env.sh index 3aed0d2..1fa7f10 100644 --- a/scripts/lib/env.sh +++ b/scripts/lib/env.sh @@ -24,7 +24,7 @@ DOMAIN="localesp.es" PORT_BASE=8082 # 8080/8081 son entornos legacy -ENV_CONFIG_DIR="/etc/localesp" # config por entorno: .env (ver Env::require_config) +ENV_CONFIG_FILE="scripts/entornos.env" # mapping slug=prefijo admin (fichero del repo) LOGGER_TAG="env" # --------------------------------------------------------------------------- @@ -62,6 +62,25 @@ Host::resolved_ip() { getent hosts "$host" | awk '{print $1}' | head -1 || true } +# --------------------------------------------------------------------------- +# Config — servicio estático: config por entorno desde el REPO. +# --------------------------------------------------------------------------- +# scripts/entornos.env mapea = (una línea por +# entorno de rama; comentarios con #). Al vivir en el repo, la config viaja +# con el código que despliega y se revisa en PR. El prefijo no es secreto +# (el bundle del frontend lo contiene igualmente). +Config::admin_prefix() { + local slug="$1" + local file="${2:-$ENV_CONFIG_FILE}" + local value + + value="$(grep -E "^[[:space:]]*${slug}[[:space:]]*=" "$file" 2>/dev/null | tail -1 | cut -d= -f2- | tr -d '[:space:]')" + if [ -z "$value" ]; then + return 1 + fi + printf '%s' "$value" +} + # --------------------------------------------------------------------------- # Port — servicio estático: asigna/reutiliza puerto para una unit+dest. # --------------------------------------------------------------------------- @@ -382,7 +401,6 @@ Env::new() { fi s[host]="${s[slug]}.$DOMAIN" s[dest]="/opt/localesp/${s[slug]}" - s[config]="$ENV_CONFIG_DIR/${s[slug]}.env" s[unit_name]="localesp-${s[slug]}" s[port]="$(Port::acquire "${s[unit_name]}" "${s[dest]}")" @@ -392,24 +410,27 @@ Env::new() { TlsCert::new "${self}__cert" "${s[host]}" } -# Config por entorno: /etc/localesp/.env debe existir y definir al menos -# LOCALESP_ADMIN_PREFIX (obligatoria para servidor y build). Es config del -# operador (no viaja en el repo): la creación es manual y teardown NO la borra. +# Config por entorno: scripts/entornos.env (en el repo) debe definir el +# prefijo admin del slug. LOCALESP_ADMIN_PREFIX es obligatoria para servidor +# y build; no hay valor por defecto. Env::require_config() { local self="$1" local -n s="$self" + local config="${s[root]}/$ENV_CONFIG_FILE" - if [ ! -f "${s[config]}" ]; then - Logger::error "falta ${s[config]}: crea el fichero en el host con LOCALESP_ADMIN_PREFIX=" - Logger::error "p. ej.: mkdir -p $ENV_CONFIG_DIR && echo 'LOCALESP_ADMIN_PREFIX=/administrador' > ${s[config]}" + if ! prefix="$(Config::admin_prefix "${s[slug]}" "$config")"; then + Logger::error "falta entrada '${s[slug]}=' en $ENV_CONFIG_FILE (repo)" + Logger::error "añade una línea: ${s[slug]}=/administrador" exit 1 fi - Logger::info "config por entorno: ${s[config]}" + Logger::info "prefijo admin de ${s[slug]}: $prefix" } Env::deploy() { local self="$1" local -n s="$self" + local prefix + local config="${s[root]}/$ENV_CONFIG_FILE" Artifacts::require_built "${s[root]}" Env::require_config "$self" @@ -418,8 +439,9 @@ Env::deploy() { # El servidor autocarga /.env (no pisa variables del entorno); # rsync --delete sólo afecta a dist/ y server/, así que sobrevive, pero - # se recopia en cada despliegue para seguir los cambios de la config. - cp "${s[config]}" "${s[dest]}/.env" + # se regenera en cada despliegue desde la config del repo. + prefix="$(Config::admin_prefix "${s[slug]}" "$config")" + printf 'LOCALESP_ADMIN_PREFIX=%s\n' "$prefix" > "${s[dest]}/.env" Logger::info "instalando dependencias (prod)" Deps::install "${s[root]}" "${s[dest]}"