Skip to content

11. Implantação

Em desenvolvimento, dois servidores trabalham juntos: o servidor de desenvolvimento do [Vite] (o cliente) e o servidor JSON (a API). Em produção, há apenas um:

Image

1. Compile o cliente. Na pasta [rdvmedecins-react]:

npm run build

O console exibe:

> 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

Primeiro, [tsc --noEmit] verifica os tipos de todo o projeto: [Vite] não faz isso; ele apenas remove a sintaxe do [TypeScript]. Um erro de tipo interrompe o build. Em seguida, o [Vite] gera toda a aplicação na pasta [dist/]: uma página [index.html], folhas de estilo e arquivos [JavaScript] otimizados:

  • [libraries-....js]: o código das bibliotecas ([React], [React Router], [TanStack Query], [i18next]...), armazenado em um arquivo separado pela configuração do [vite.config.ts]. Ele raramente muda: de uma versão da aplicação para a seguinte, o navegador o mantém em cache. [libraries-....css]: a folha de estilo do [Bootstrap];
  • [index-....js]: o NOSSO código, usado para as páginas carregadas imediatamente (login, agenda) e o restante da aplicação;
  • Cada página carregada sob demanda ([lazy], veja [routes.tsx]) tem seu próprio arquivo ([MyAccount-....js]...), baixado na primeira visita; [PersonFields-....js] e [persons.config-....js] contêm código comum a várias dessas páginas;
  • Na inicialização, o navegador baixa cerca de 170 KB uma vez compactados pelo servidor (coluna gzip), dos quais 150 KB são de bibliotecas;
  • O nome de cada arquivo contém um hash de seu conteúdo ([index-D-CLbbe-.js]): uma nova versão terá um nome diferente, e um navegador nunca poderá manter em cache uma versão desatualizada. Apenas o [index.html] mantém seu nome: é esse arquivo que referencia os demais.

Você pode testar a versão compilada com [npm run preview] (http://localhost:4173, usando o mesmo proxy para o servidor JSON).

2. Envie-a ao servidor. Copie o CONTEÚDO da pasta [dist/] para uma pasta [client/] na raiz do servidor JSON ([rdvmedecins-nestjs-json/client/index.html], [rdvmedecins-nestjs-json/client/assets/...]) e reinicie o servidor. Ele exibe:

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

A aplicação completa agora está disponível em http://localhost:8080. O servidor serve os arquivos do cliente e retorna [index.html] para qualquer outra URL fora de /api: recarregar a página /schedule funciona (é o navegador do cliente que a exibe). Para o leitor curioso, é o arquivo [src/web/client-spa.ts] do servidor que realiza essa tarefa.

3. Em um ambiente de produção real, não se esqueça do arquivo [.env] no servidor:

  • um [JWT_SECRET] longo e aleatório;
  • um [CAPTCHA_TEST] vazio;
  • [COOKIE_SECURE=true] se o site é servido via HTTPS (e deve ser: senhas estão sendo transmitidas);
  • [TRUST_PROXY=true] se o servidor está atrás de um proxy ([nginx]...), para que o limite de tentativas veja o endereço IP real dos clientes.

Em seguida, inicia-se o servidor compilado: [npm run build], seguido de [npm run start:prod].