comunidadhll/deploy/jta/README.md

JTA Docker Compose Deploy

Este despliegue prepara una variante directa para JTA sin Portainer y sin tocar la logica funcional del proyecto.

Archivos

• docker-compose.yml: stack directo para JTA
• .env.example: plantilla de variables sin credenciales reales
• backups/: carpeta local para dumps .dump o .sql

Preparacion

1. Copia la plantilla:

   Copy-Item deploy/jta/.env.example deploy/jta/.env
   

2. Ajusta como minimo:

• POSTGRES_PASSWORD
• HLL_BACKEND_RCON_TARGETS
• FRONTEND_BACKEND_BASE_URL
• HLL_BACKEND_ALLOWED_ORIGINS

Notas:

• HLL_BACKEND_RCON_TARGETS debe ser un JSON valido en una sola linea.
• en .env conviene dejar ese JSON entre comillas simples para preservar los espacios
• HLL_DB_MAINTENANCE_ENABLED=false queda desactivado por defecto.
• FRONTEND_BACKEND_BASE_URL debe apuntar a la URL que vera el navegador. Ejemplo remoto: http://IP_O_DOMINIO_JTA:8000.
• HLL_BACKEND_ALLOWED_ORIGINS debe incluir la URL publica del frontend. Ejemplo remoto: http://IP_O_DOMINIO_JTA:8080.

Arranque

Desde la raiz del repo:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env up -d --build

Alternativa equivalente desde deploy/jta:

cd deploy/jta
docker compose --env-file .env up -d --build

Ambas funcionan porque los contextos de build y los bind mounts se resuelven relativos a deploy/jta/docker-compose.yml.

Arranque Con Workers Advanced

Desde raiz:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env --profile advanced up -d --build

Desde deploy/jta:

docker compose --env-file .env --profile advanced up -d --build

Servicios:

• normales: postgres, backend, frontend
• perfil advanced: historical-runner, rcon-historical-worker

Parada

Parada sin borrar datos:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env down

Advertencia:

• no usar docker compose down -v
• no borrar el volumen jta-postgres-data

Backup Y Restore

Esta task no ejecuta backup ni restore real. Los comandos siguientes son solo runbook operativo.

1. Crear dump desde el PostgreSQL actual

Ejemplo usando el contenedor PostgreSQL actual:

docker exec -t hll-vietnam-postgres pg_dump -U hll_vietnam -d hll_vietnam -Fc -f /tmp/hll_vietnam_jta.dump
docker cp hll-vietnam-postgres:/tmp/hll_vietnam_jta.dump .\hll_vietnam_jta.dump
Copy-Item .\hll_vietnam_jta.dump deploy\jta\backups\

Si el nombre del contenedor actual es distinto, sustituirlo por el real.

2. Levantar solo PostgreSQL en JTA

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env up -d postgres

3. Restaurar dump en JTA

Con el dump ya copiado a deploy/jta/backups/:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env exec postgres sh -c "pg_restore --clean --if-exists -U \"$POSTGRES_USER\" -d \"$POSTGRES_DB\" /backups/hll_vietnam_jta.dump"

Validacion De Datos Tras Restore

Comprobar tablas clave:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env exec postgres sh -c "psql -U \"$POSTGRES_USER\" -d \"$POSTGRES_DB\" -c 'select count(*) from rcon_materialized_matches;'"
docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env exec postgres sh -c "psql -U \"$POSTGRES_USER\" -d \"$POSTGRES_DB\" -c 'select count(*) from rcon_admin_log_events;'"
docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env exec postgres sh -c "psql -U \"$POSTGRES_USER\" -d \"$POSTGRES_DB\" -c 'select count(*) from displayed_historical_snapshots;'"

Endpoints A Probar

• frontend: http://IP_O_DOMINIO_JTA:8080
• backend health: http://IP_O_DOMINIO_JTA:8000/health
• http://IP_O_DOMINIO_JTA:8000/api/servers
• http://IP_O_DOMINIO_JTA:8000/api/historical/server-summary?server=comunidad-hispana-01
• http://IP_O_DOMINIO_JTA:8000/api/historical/recent-matches?limit=20&server=comunidad-hispana-01

Logs A Revisar

Basicos:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env logs --tail=200 postgres backend frontend

Advanced:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env logs --tail=200 historical-runner rcon-historical-worker

Eventos utiles a buscar:

• database-maintenance-scheduler-*
• historical-refresh-*
• database-maintenance-*
• errores de conexion RCON

Validacion Del Compose

La plantilla incluida usa valores de ejemplo sintacticamente validos, incluido el JSON de HLL_BACKEND_RCON_TARGETS, para permitir:

docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env.example config