ci(deploy): config por entorno en el repo (scripts/entornos.env)
deploy-branch / deploy (push) Successful in 3m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m15s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped

La config de prefijo admin pasa del host (/etc/localesp/<slug>.env) al
repo, para que viaje con el código que despliega y se revise en PRs:

- scripts/entornos.env: mapping <slug>=<prefijo> (prototipo-yb01=
  /administrador; master y prototipo-yb01-ef como plantilla comentada)
- env.sh: servicio Config::admin_prefix lee el mapping; require_config
  falla con mensaje claro si la rama no tiene entrada; Env::deploy
  regenera <dest>/.env desde el repo (el servidor lo autocarga)
- deploy.yml: el build exporta el prefijo del mapping antes de compilar
This commit is contained in:
2026-10-03 14:56:08 +02:00
parent 4d7d9e19dc
commit 695d59d31e
6 changed files with 67 additions and 19 deletions
+11
View File
@@ -0,0 +1,11 @@
# entornos.env — prefijo admin por entorno de rama (una línea: <slug>=<prefijo>)
#
# 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
+33 -11
View File
@@ -24,7 +24,7 @@
DOMAIN="localesp.es"
PORT_BASE=8082 # 8080/8081 son entornos legacy
ENV_CONFIG_DIR="/etc/localesp" # config por entorno: <slug>.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 <slug>=<LOCALESP_ADMIN_PREFIX> (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/<slug>.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=<prefijo>"
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 <dest>/.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]}"