Skip to content

11. Bereitstellung

In der Entwicklung arbeiten zwei Server zusammen: der Entwicklungsserver [Vite] (der Client) und der JSON-Server (die API). In der Produktion gibt es nur noch einen:

Image

1. Den Client erstellen. Im Ordner [rdvmedecins-react]:

npm run build

Die Konsole zeigt an:

> 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

Zunächst prüft [tsc --noEmit] die Typen des gesamten Projekts: [Vite] tut dies nicht; es entfernt lediglich die Syntax von [TypeScript]. Ein Typfehler bricht den Build ab. Anschließend erstellt [Vite] die gesamte Anwendung im Ordner [dist/]: eine Seite [index.html], Stylesheets und optimierte [JavaScript]-Dateien:

  • [libraries-....js]: der Code der Bibliotheken ([React], [React Router], [TanStack Query], [i18next] ...), durch die Konfiguration von [vite.config.ts] in einer eigenen Datei abgelegt. Er ändert sich selten: Von einer Version der Anwendung zur nächsten behält der Browser ihn im Cache. [libraries-....css]: das Stylesheet von [Bootstrap];
  • [index-....js]: UNSER Code, verwendet für die sofort geladenen Seiten (Anmeldung, Terminkalender) und den Rest der Anwendung;
  • Jede bei Bedarf geladene Seite ([lazy], siehe [routes.tsx]) hat ihre eigene Datei ([MyAccount-....js] ...), die beim ersten Besuch heruntergeladen wird; [PersonFields-....js] und [persons.config-....js] enthalten Code, der mehreren dieser Seiten gemeinsam ist;
  • Beim Start lädt der Browser einmalig etwa 170 KB herunter, vom Server komprimiert (Spalte gzip), davon 150 KB für die Bibliotheken;
  • Der Name jeder Datei enthält einen Hash ihres Inhalts ([index-D-CLbbe-.js]): Eine neue Version hat einen anderen Namen, sodass ein Browser nie eine veraltete Version zwischenspeichern kann. Nur [index.html] behält ihren Namen: Diese Datei verweist auf die anderen.

Sie können die erstellte Version mit [npm run preview] ausprobieren (http://localhost:4173, mit demselben Proxy zum JSON-Server).

2. Auf den Server hochladen. Kopieren Sie den INHALT des Ordners [dist/] in einen Ordner [client/] im Stammverzeichnis des JSON-Servers ([rdvmedecins-nestjs-json/client/index.html], [rdvmedecins-nestjs-json/client/assets/...]) und starten Sie den Server neu. Er zeigt an:

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

Die vollständige Anwendung ist nun unter http://localhost:8080 verfügbar. Der Server liefert die Dateien des Clients aus und gibt für jede andere URL außerhalb von /api [index.html] zurück: Das Neuladen der Seite /schedule funktioniert (der Browser des Clients zeigt sie an). Für Neugierige: Diese Aufgabe übernimmt die Datei [src/web/client-spa.ts] auf dem Server.

3. In einer echten Produktionsumgebung vergessen Sie nicht die Datei [.env] auf dem Server:

  • ein langes, zufälliges [JWT_SECRET];
  • ein leeres [CAPTCHA_TEST];
  • [COOKIE_SECURE=true] wenn die Website über HTTPS ausgeliefert wird (das muss sie: Es werden Passwörter übertragen);
  • [TRUST_PROXY=true] wenn der Server hinter einem Proxy ([nginx] ...) steht, damit die Begrenzung der Versuche die tatsächliche IP-Adresse der Clients sieht.

Anschließend starten wir den kompilierten Server: [npm run build], gefolgt von [npm run start:prod].