165 lines
4.7 KiB
Markdown
165 lines
4.7 KiB
Markdown
# 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:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env up -d --build
|
|
```
|
|
|
|
Alternativa equivalente desde `deploy/jta`:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env --profile advanced up -d --build
|
|
```
|
|
|
|
Desde `deploy/jta`:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
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
|
|
|
|
```powershell
|
|
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/`:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env logs --tail=200 postgres backend frontend
|
|
```
|
|
|
|
Advanced:
|
|
|
|
```powershell
|
|
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:
|
|
|
|
```powershell
|
|
docker compose -f deploy/jta/docker-compose.yml --env-file deploy/jta/.env.example config
|
|
```
|