Skip to content

11. Despliegue

En desarrollo, dos servidores trabajan juntos: el servidor de desarrollo de [Vite] (el cliente) y el servidor JSON (la API). En producción, solo hay uno:

Image

1. Construir el cliente. En la carpeta [rdvmedecins-react]:

npm run build

La consola muestra:

> rdvmedecins-react@1.0.0 build
> tsc --noEmit && vite build

vite v8.3.1 building client environment for production...
transforming...
✓ 205 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                             1.13 kB │ gzip:   0.58 kB
dist/assets/index-B3xI0Dco.css              0.48 kB │ gzip:   0.28 kB
dist/assets/libraries-CqLr8KVv.css        230.06 kB │ gzip:  30.68 kB
dist/assets/persons.config-Citeh_Yy.js      0.51 kB │ gzip:   0.25 kB
dist/assets/rolldown-runtime-CbXtAM7H.js    0.58 kB │ gzip:   0.36 kB
dist/assets/PersonFields-X0Ub6xSi.js        1.69 kB │ gzip:   0.69 kB
dist/assets/Persons-COxkkHus.js             2.00 kB │ gzip:   0.82 kB
dist/assets/PatientArea-BpWOm0FI.js         2.37 kB │ gzip:   0.97 kB
dist/assets/Register-DJgfayxN.js            2.46 kB │ gzip:   1.08 kB
dist/assets/PersonForm-CAd8EZMm.js          2.81 kB │ gzip:   1.33 kB
dist/assets/MyAccount-qsmn4TtZ.js           3.78 kB │ gzip:   1.35 kB
dist/assets/index-D-CLbbe-.js              38.11 kB │ gzip:  12.08 kB
dist/assets/libraries-CadH_l3h.js         394.23 kB │ gzip: 123.37 kB

✓ built in 598ms

Primero, [tsc --noEmit] verifica los tipos de todo el proyecto: [Vite] no hace esto; simplemente elimina la sintaxis de [TypeScript]. Un error de tipos detiene la compilación. Luego, [Vite] construye toda la aplicación en la carpeta [dist/]: una página [index.html], hojas de estilo y archivos [JavaScript] optimizados:

  • [libraries-....js]: el código de las bibliotecas ([React], [React Router], [TanStack Query], [i18next]...), guardado en un archivo aparte por la configuración de [vite.config.ts]. Rara vez cambia: de una versión de la aplicación a la siguiente, el navegador lo conserva en la caché. [libraries-....css]: la hoja de estilo de [Bootstrap];
  • [index-....js]: NUESTRO código, usado para las páginas que se cargan de inmediato (inicio de sesión, agenda) y el resto de la aplicación;
  • Cada página cargada bajo demanda ([lazy], véase [routes.tsx]) tiene su propio archivo ([MyAccount-....js]...), que se descarga en la primera visita; [PersonFields-....js] y [persons.config-....js] contienen código común a varias de estas páginas;
  • Al iniciar, el navegador descarga aproximadamente 170 KB una vez comprimidos por el servidor (columna gzip), de los cuales 150 KB corresponden a bibliotecas;
  • El nombre de cada archivo contiene un hash de su contenido ([index-D-CLbbe-.js]): una nueva versión tendrá un nombre distinto y un navegador nunca podrá conservar en la caché una versión desactualizada. Solo [index.html] conserva su nombre: es este archivo el que hace referencia a los demás.

Se puede probar la versión construida con [npm run preview] (http://localhost:4173, con el mismo proxy hacia el servidor JSON).

2. Subirla al servidor. Copie el CONTENIDO de la carpeta [dist/] en una carpeta [client/] en la raíz del servidor JSON ([rdvmedecins-nestjs-json/client/index.html], [rdvmedecins-nestjs-json/client/assets/...]) y luego reinicie el servidor. Este muestra:

[Nest] LOG [RdvMedecins] React client served from .../rdvmedecins-nestjs-json/client
[Nest] LOG [RdvMedecins] JSON server started: http://localhost:8080/api

La aplicación completa ya está disponible en http://localhost:8080. El servidor sirve los archivos del cliente y devuelve [index.html] para cualquier otra URL fuera de /api: recargar la página /schedule funciona (es el navegador del cliente el que la muestra). Para el lector curioso, es el archivo [src/web/client-spa.ts] del servidor el que realiza esta tarea.

3. En un entorno de producción real, no olvide el archivo [.env] en el servidor:

  • un [JWT_SECRET] largo y aleatorio;
  • un [CAPTCHA_TEST] vacío;
  • [COOKIE_SECURE=true] si el sitio se sirve mediante HTTPS (debe hacerse así: se transmiten contraseñas);
  • [TRUST_PROXY=true] si el servidor está detrás de un proxy ([nginx]...), para que el límite de intentos vea la dirección IP real de los clientes.

Luego se inicia el servidor compilado: [npm run build], seguido de [npm run start:prod].