compose: unir migrate y api a la red coolify

El host qzegekm3sr2bevgxl4wh4th2 es el UUID interno de Postgres;
solo resuelve en esa red. Sin ella Liquibase lanza UnknownHostException.

Co-authored-by: alberto.martinez <alberto.martinez@mrdev.mx>

db/update.sh

@@ -9,6 +9,7 @@
 #   DATABASE_URL_CORE_OWNER       (jdbc: panels_product, schema core)
 #
 # Formato esperado: postgresql://usuario:password@host:puerto/basededatos
+# (también se acepta postgres://). El host NO puede ser un CONTAINER ID.
 #
 # Uso:
 #   set -a && source .env.dev-local && set +a && ./db/update.sh all
@@ -39,12 +40,52 @@ done
 # postgresql://user:pass@host:port/db -> jdbc:postgresql://host:port/db + user/pass
 parse_url() {
   local url="$1"
+  url="${url#"${url%%[![:space:]]*}"}"
+  url="${url%"${url##*[![:space:]]}"}"
+  url="${url#\'}"; url="${url%\'}"
+  url="${url#\"}"; url="${url%\"}"
+  if [[ "$url" == postgres://* ]]; then
+    url="postgresql://${url#postgres://}"
+  fi
+  if [[ "$url" != postgresql://* ]]; then
+    echo "ERROR: la URL debe empezar por postgresql:// o postgres://" >&2
+    exit 1
+  fi
   local rest="${url#postgresql://}"
   local userinfo="${rest%%@*}"
   local hostpart="${rest#*@}"
+  if [[ "$userinfo" == "$rest" || -z "$hostpart" ]]; then
+    echo "ERROR: URL sin host (falta user:pass@host)" >&2
+    exit 1
+  fi
   PARSED_USER="${userinfo%%:*}"
   PARSED_PASS="${userinfo#*:}"
   PARSED_JDBC="jdbc:postgresql://${hostpart}"
+  local hp="${hostpart%%\?*}"
+  hp="${hp%%/*}"
+  PARSED_HOST="${hp%%:*}"
+}
+
+preflight_host() {
+  echo "==> host JDBC: ${PARSED_HOST}"
+  if [[ "$PARSED_HOST" =~ ^[0-9a-f]{12}$ ]]; then
+    echo "ERROR: '${PARSED_HOST}' es un CONTAINER ID de Docker, no un hostname." >&2
+    echo "En Coolify copia Postgres URL (internal): el texto entre @ y :5432." >&2
+    echo "Pon ese hostname en las 6 DATABASE_URL_* (mismo host) y conecta el" >&2
+    echo "compose a la red predefined 'coolify'." >&2
+    exit 1
+  fi
+  if [[ "$PARSED_HOST" =~ ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    return 0
+  fi
+  if command -v getent >/dev/null 2>&1; then
+    if ! getent hosts "$PARSED_HOST" >/dev/null 2>&1; then
+      echo "ERROR: no se resuelve el host '${PARSED_HOST}' (DNS)." >&2
+      echo "Usa el hostname de Postgres URL (internal), no el ID del contenedor." >&2
+      echo "El stack PANELS debe estar en la misma red Docker que Postgres (coolify)." >&2
+      exit 1
+    fi
+  fi
 }
 
 run_one() {
@@ -57,6 +98,7 @@ run_one() {
   fi
   parse_url "$url"
   echo "==> Liquibase $LB_COMMAND: $name ($PARSED_JDBC)"
+  preflight_host
   (
     cd "$ROOT/db/$name"
     "$LIQUIBASE" \

docker-compose.yml

@@ -4,12 +4,18 @@
 #
 # Coolify: un solo archivo — docker-compose.yml. No añadir overlays.
 # Local: docker compose -f docker-compose.yml -f overlays/compose.local.yml up --build
+#
+# `data` = red donde viven Postgres/Redis de Coolify (UUID tipo
+# qzegekm3sr2bevgxl4wh4th2). Sin esta red, Liquibase da UnknownHostException.
 services:
   migrate:
     build:
       context: .
       dockerfile: Dockerfile.migrate
     restart: "no"
+    networks:
+      - default
+      - data
     environment:
       DATABASE_URL_PLATFORM_OWNER: ${DATABASE_URL_PLATFORM_OWNER:?}
       DATABASE_URL_IAM_OWNER: ${DATABASE_URL_IAM_OWNER:?}
@@ -53,6 +59,9 @@ services:
       S3_REGION: ${S3_REGION:-auto}
       S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:-}
       S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:-}
+    networks:
+      - default
+      - data
     volumes:
       - panel-data:/app/data
     expose:
@@ -98,3 +107,8 @@ services:
 
 volumes:
   panel-data:
+
+networks:
+  data:
+    name: ${PANELS_DOCKER_NETWORK:-coolify}
+    external: true

docs/coolify.md

@@ -98,11 +98,27 @@ En Coolify el servicio de PANELS se llama **`web-panel`** (FQDN ej. `panels.mrde
 
 El host de las 6 `DATABASE_URL_*` y de las 2 `REDIS_URL_*` **no** es el ID corto del contenedor (`docker exec -it c72dde7d6b47 …`). Docker DNS en Coolify **no** resuelve ese ID; Liquibase falla con `UnknownHostException`.
 
-Usa el hostname de **Postgres URL (internal)** / **Redis URL (internal)** en Coolify: el segmento entre `@` y `:5432` (o `:6379`). Suele ser un UUID o el nombre de servicio de Coolify, no los 12 caracteres del `CONTAINER ID`.
+Usa el hostname de **Postgres URL (internal)** / **Redis URL (internal)** en Coolify: el segmento entre `@` y `:5432` (o `:6379`). Un UUID tipo `qzegekm3sr2bevgxl4wh4th2` **es el host correcto**; un CONTAINER ID de 12 caracteres (`c72dde7d6b47`) no.
 
-Además, el recurso Docker Compose de PANELS debe estar en la **misma red** que Postgres y Redis (Connect to Predefined Network, a menudo `coolify`). Si no, el hostname interno existe pero el contenedor `migrate` no lo ve.
+Ese UUID solo resuelve en la red Docker **`coolify`**. `docker-compose.yml` une `migrate` y `api` a esa red (`networks.data`). En Coolify deja también **Connect to Predefined Network**. Redis tiene **otro** UUID (el de Redis URL internal), no el de Postgres.
 
-Tras corregir las URLs, redesplegar y revisar `docker logs` del contenedor `migrate-*` (debe terminar con Liquibase `Update has been successful` o similar, exit 0). El `docker stop … No such container` del helper de Coolify es ruido de limpieza, no la causa.
+Si tras unir la red sigue `UnknownHostException`, en el VPS:
+
+```bash
+sudo docker network inspect coolify | grep -E 'Name|Aliases|qzegekm3'
+```
+
+Usa el alias que aparezca junto al contenedor de Postgres (a veces `postgres-<uuid>`).
+
+El log de deploy de Coolify **no** incluye stdout de Liquibase. Si `service "migrate" didn't complete successfully: exit 1`, el error real está en:
+
+```bash
+sudo docker logs migrate-<uuid-del-recurso>-<timestamp>
+```
+
+Ejemplo: `sudo docker logs migrate-pdyrt8ccp804tfmutefau0k6-052025710094`. `UnknownHostException` con un UUID largo = `migrate` fuera de `coolify`, no un host mal copiado. `Liquibase OK` + exit 0 = bien.
+
+El `docker stop … No such container` del helper de Coolify es ruido de limpieza, no la causa. El build de imágenes puede ser OK y el deploy igual falla en `migrate`.
 
 ### Coolify pide `PLATFORM_OWNER_PASSWORD`, `IAM_APP_PASSWORD`, `*_REDIS_PASSWORD`…
 

overlays/compose.local.yml

@@ -79,3 +79,9 @@ services:
 
 volumes:
   postgres-data:
+
+# El compose de Coolify exige la red externa `coolify`. En local no existe:
+# esta red puente sustituye `data` (Compose 2.24+ !override).
+networks:
+  data: !override
+    name: panels-local-data