Skip to content

11. 部署

在开发环境中,有两个服务器协同工作:[Vite] 开发服务器(客户端)和 JSON 服务器(API)。在生产环境中,只有一个服务器:

Image

1. 构建客户端。在 [rdvmedecins-react] 文件夹中:

npm run build

控制台显示:

> 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

首先,[tsc --noEmit] 检查整个项目的类型:[Vite] 不做这件事;它只是去掉 [TypeScript] 的语法。类型错误会使构建中止。然后 [Vite] 在 [dist/] 文件夹中构建整个应用:一个 [index.html] 页面、样式表,以及经过优化的 [JavaScript] 文件:

  • [libraries-....js]:库的代码([React]、[React Router]、[TanStack Query]、[i18next]……),由 [vite.config.ts] 的配置存放在单独的文件中。它很少变化:在应用的不同版本之间,浏览器会把它保留在缓存中。[libraries-....css]:[Bootstrap] 的样式表;
  • [index-....js]:我们自己的代码,用于立即加载的页面(登录、日程)以及应用的其余部分;
  • 每个按需加载的页面([lazy],见 [routes.tsx])都有自己的文件([MyAccount-....js]……),在第一次访问时下载;[PersonFields-....js] 和 [persons.config-....js] 包含其中几个页面共用的代码;
  • 启动时,浏览器会下载大约 170 KB(经服务器压缩后,见 gzip 列),其中 150 KB 是库;
  • 每个文件的名称都包含其内容的哈希值([index-D-CLbbe-.js]):新版本会有不同的名称,浏览器就永远不会缓存过时的版本。只有 [index.html] 保留它的名称:正是这个文件引用其他文件。

你可以用 [npm run preview] 试用构建好的版本(http://localhost:4173,使用同样的代理指向 JSON 服务器)。

2. 把它上传到服务器。把 [dist/] 文件夹的内容复制到 JSON 服务器根目录下的 [client/] 文件夹中([rdvmedecins-nestjs-json/client/index.html]、[rdvmedecins-nestjs-json/client/assets/...]),然后重启服务器。它会显示:

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

现在,完整的应用可以在 http://localhost:8080 访问。服务器提供客户端的文件,并对 /api 之外的任何其他 URL 返回 [index.html] :重新加载 /schedule 页面可以正常工作(显示它的是客户端的浏览器)。对于好奇的读者,服务器上负责这项任务的是 [src/web/client-spa.ts] 文件。

3. 在真实的生产环境中,别忘了服务器上的 [.env] 文件:

  • 一个长而随机的 [JWT_SECRET];
  • 一个为空的 [CAPTCHA_TEST];
  • [COOKIE_SECURE=true] 如果站点通过 HTTPS 提供服务(必须如此:因为要传输密码);
  • [TRUST_PROXY=true] 如果服务器位于代理([nginx]……)之后,这样尝试次数限制才能看到客户端的真实 IP 地址。

然后我们启动编译后的服务器:[npm run build],再执行 [npm run start:prod]。