🚀 Levantar la plataforma
Objetivo principal: dejar la pantalla respondiendo en el servidor del centro, con los cuatro límites declarados y el puerto atado a la propia máquina.
Antes de empezar
Hace falta un entorno de contenedores en marcha. El guion lo comprueba y falla cerrado si no lo encuentra: no intenta arreglar nada por su cuenta.
Los pasos
1. Declara los cuatro límites
Copia la plantilla y pon los cuatro valores:
cp despliegue/limites.conf.ejemplo despliegue/limites.conf
memoria = 512M
tiempo_de_computo = 30
procesos_simultaneos = 64
espacio_ocupado = 2G
Ese fichero no se versiona, a propósito: son las cifras de un servidor concreto, y unas cifras de montaje versionadas son la forma más fácil de que alguien las herede creyendo que están medidas.
Si falta alguno, la plataforma no arranca y dice cuál.
La plataforma exige que estén escritos, pero no los aplica. El motivo está en Lo que NO hace. Escribe cifras que tengan sentido para tu servidor de todas formas: el día que se conecten, serán las que valgan.
2. Ejecuta el despliegue
bash scripts/desplegar.sh
Es idempotente: ejecutarlo dos veces no duplica nada, y el inventario y las entregas sobreviven entre ejecuciones.
3. Apunta la credencial
Al terminar, el guion imprime algo así:
ok credencial generada para esta sesion: ················
Efimera: cambia en cada despliegue. Exporta CAPTIA_CREDENCIAL para fijarla.
Es un secreto y es efímera: cambia en cada despliegue. Si necesitas que se mantenga entre despliegues, expórtala tú antes de ejecutar el guion:
export CAPTIA_CREDENCIAL="…"
bash scripts/desplegar.sh
La necesitas solo para la API JSON. La pantalla no la pide.
4. Abre la pantalla
http://127.0.0.1:8080/pantalla
Desde esa misma máquina. Desde cualquier otra no responde.
Comprobar que está viva
curl -s http://127.0.0.1:8080/salud
/salud es la única ruta que no pide credencial: es el chequeo de salud del contenedor, no
puede llevar secretos, y responde lo mismo con el inventario vacío o lleno.
Qué sobrevive a qué
| Se apaga y se enciende… | Qué pasa |
|---|---|
| El proceso de la plataforma | El inventario está a salvo y los modelos vuelven a servirse solos |
| El contenedor, y se vuelve a desplegar | Igual: el volumen de estado sobrevive, y esa es su razón de ser |
| El servidor entero | El contenedor no vuelve solo. Hay que volver a ejecutar el despliegue |
El despliegue no deja el contenedor configurado para arrancar solo. El inventario no se pierde —el volumen sigue ahí— pero nadie sirve nada hasta que alguien lo levante.
Parar sin perder nada
docker rm -f captia-plataforma
El volumen de estado sobrevive. Volver a ejecutar el despliegue recupera el inventario y vuelve a poner a responder lo que estuviera sirviendo.
Lo que este despliegue NO instala
- La puerta del alumnado. Lo que se instala es un directorio vigilado: plomería de ensayo.
- El techo de recursos por modelo, ni la denegación de red por modelo.
- Nada que devuelva el contenedor a la vida tras reiniciar el anfitrión.
Los tres están explicados, con su motivo, en Lo que NO hace.