En producción usamos Elastic Cloud, versión 9. En local lo más sencillo es levantar la misma versión con Docker y cargarle unos programas de ejemplo (los mismos que usan los tests):
docker compose -f test/docker-compose.yml up -d --wait
test/seed.sh
Queda escuchando en http://localhost:9201.
Instalamos dependencias de Node (Node 24, ver .nvmrc):
nvm use
npm install
Configuramos la conexión al back-end de Elastic haciendo una copia de /api/.env.example en /api.env y modificándolo si es necesario. Lo mismo con /web/.env.example.
Arrancamos la aplicación (tanto la API como el front-end):
npm run start
npm run lint pasa eslint y comprueba el formato con Prettier (también lo hace la CI), y npm run format lo arregla.
Los tests del API (test/api.test.mjs) son de extremo a extremo: hablan con el API por HTTP contra un Elastic 9.0.4 (la misma versión que en producción) cargado con seis programas exportados de producción (test/fixtures). Necesitan Docker.
docker compose -f test/docker-compose.yml up -d --wait
test/seed.sh
ELASTIC_API_URL=http://localhost:9201 PORT=8899 npm run start:api # en otra terminal
API_URL=http://localhost:8899/ npm run test:api
Los tests del frontend (test/web.spec.mjs) usan Playwright contra el build de producción (servido por test/serve.mjs, que hace lo mismo que el Apache) y el mismo API de pruebas. Los valores esperados los sacan del propio API, así que valen también contra producción:
npx playwright install chromium # la primera vez
npm run test:web:build
npm run test:web
Después de desplegar, podemos pasar los tests marcados como @smoke contra producción. Son pocos y van de uno en uno a propósito: Cloudflare limita las peticiones al API y, si nos pasamos, bloquea nuestra IP durante una hora (error 1015).
WEB_URL=https://verba.civio.es API_URL=https://verba.civio.es/api/ npm run test:web
La aplicación está desplegada en midas, en /var/www/verba.civio.es/. Hay dos partes, el frontend (hecho con Vue.js) que se sirve por el Apache y el API que es un servicio que levanta una aplicación Express. La configuración (variables de entorno...) del servicio está en /etc/systemd/system/verba-api.service, incluida la URL de Elastic Cloud con sus credenciales. El servicio usa nvm-exec, que arranca en la carpeta del repositorio (WorkingDirectory) y coge la versión de Node del .nvmrc, así que para cambiarla basta con desplegar y reiniciar. Al desplegar hay que hacer siempre nvm use, para no depender de la versión por defecto de nvm. nvm está instalado para todo el servidor en /usr/local/nvm, no en ~/.nvm; en una sesión que no lo cargue (un ssh midas '...', por ejemplo) hay que hacer antes source /usr/local/nvm/nvm.sh.
El API se conecta a Elastic Cloud con el usuario verba_api, que tiene solo el rol verba_read (permiso read sobre el índice captions). La ingesta de datos (civio/verba-rtve) usa sus propias credenciales, con permiso de escritura. Si hubiera que recrear el usuario o cambiarle la contraseña, se puede hacer desde Kibana o con el API de seguridad de Elastic, usando un usuario administrador:
PUT _security/role/verba_read
{"indices": [{"names": ["captions"], "privileges": ["read"]}]}
POST _security/user/verba_api
{"password": "...", "roles": ["verba_read"]}
Para actualizar la aplicación:
$ cd /var/www/verba.civio.es/public
$ git pull
$ nvm use
$ npm install
$ npm run build
$ sudo systemctl restart verba-api
El usuario david puede hacer este reinicio sin contraseña (/etc/sudoers.d/verba-api), para poder desplegar sin sesión interactiva.
Y, desde local, los tests de humo contra producción (ver Tests).
Una vez desplegada, la aplicación ofrece dos URLs:
verba.civio.es, la aplicación web.verba.civio.es/api, el API usado por la aplicación.
El contenido completo de los Telediarios descargados está disponible en dos ficheros que se actualizan diariamente:
- Subtítulos originales (VTT) con metadatos de RTVE (JSON): corpus_raw.tar.gz
- Subtítulos segmentados en frases usando
syntok(JSON) con metadatos de RTVE (JSON): corpus_cooked.tar.gz