Matheus
4480e9265e
Fecha um risco documentado desde a PHASE 01: os dois processos de host (fora do Docker) não sobreviviam a um reboot da VM, precisando ser religados manualmente toda vez. Agora são b2bcall-api.service e b2bcall-frontend.service (infrastructure/systemd/), enabled, sobrevivem a reboot como os containers Docker já sobreviviam via restart: unless-stopped. Achado real resolvido antes de instalar: sem porta fixa, os dois disputavam a 3000 por padrão — quem perdesse crashava com EADDRINUSE em vez de cair pra 3001. Fixado API_PORT=3000 (.env) e PORT=3001 (Environment= direto na unit do frontend — confirmado que colocar em apps/frontend/.env.local não funciona, o CLI do Next.js decide a porta antes de aplicar esse arquivo). A ordem de start deixa de importar. Rodam em modo dev (pnpm dev), não build de produção — decisão deliberada documentada no README, virar produção é escopo maior. Testado ponta a ponta: units instaladas e habilitadas, subiram nas portas certas sem fallback nem crash, journalctl com logs limpos, smoke test de regressão nas 19 telas do tenant + platform via os processos supervisionados, todas 200. Achado incidental: as rotas do Next.js dev levam 10-15s pra compilar na primeira visita — explica os TimeoutError intermitentes do Puppeteer vistos ao longo da sessão, não é um bug. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BFaBaBSQGhyXGEgtTYZGV8
58 lines
2.7 KiB
Markdown
58 lines
2.7 KiB
Markdown
# systemd — apps/api e apps/frontend
|
|
|
|
`apps/api` e `apps/frontend` rodam direto no host (fora do Docker — só
|
|
Postgres/Redis/FreeSWITCH/fs-config/fs-events/predictive-dialer/ai-worker são
|
|
containers, e esses já voltam sozinhos via `restart: unless-stopped` do
|
|
`docker-compose.yml` + `docker.service` habilitado). Até a PHASE 38 os dois
|
|
processos de host tinham que ser religados manualmente depois de qualquer
|
|
reboot — estas units resolvem isso.
|
|
|
|
## Por que os dois rodam em `pnpm dev`, não build de produção
|
|
|
|
Decisão deliberada: o ambiente inteiro (`ACESSO_TESTE.md`) já é descrito como
|
|
desenvolvimento/teste, não produção. Migrar `apps/api` pra `pnpm build && node
|
|
dist/main.js` e `apps/frontend` pra `next build && next start` é uma mudança
|
|
maior (variar comportamento de erro, HMR, etc.) fora do escopo de "sobreviver a
|
|
um reboot" — fica pra quando o projeto realmente for pra produção.
|
|
|
|
## Instalação
|
|
|
|
```bash
|
|
sudo cp infrastructure/systemd/b2bcall-api.service /etc/systemd/system/
|
|
sudo cp infrastructure/systemd/b2bcall-frontend.service /etc/systemd/system/
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now b2bcall-api.service
|
|
sudo systemctl enable --now b2bcall-frontend.service
|
|
```
|
|
|
|
## Por que a ordem nunca mais importa
|
|
|
|
`API_PORT=3000` fixo em `.env` (lido via `EnvironmentFile=` na unit do
|
|
`b2bcall-api`) e `PORT=3001` fixo via `Environment=` na unit do
|
|
`b2bcall-frontend` — achado real desta sessão: sem os dois explícitos, os dois
|
|
processos disputavam a porta 3000 por padrão, e quem perdesse a corrida caía
|
|
pra 3001 (Next.js) ou **crashava direto** (`EADDRINUSE`, Nest/Fastify não tem
|
|
fallback automático). Com as duas portas fixas, a ordem de start deixa de
|
|
importar — cada um já nasce na porta certa, nunca compete pela mesma.
|
|
|
|
Note-se que `PORT=3001` só funciona quando setado no **ambiente do processo**
|
|
(`Environment=` na unit, ou `PORT=3001 pnpm dev` manual) — colocar em
|
|
`apps/frontend/.env.local` sozinho não basta: o CLI do Next.js decide a porta
|
|
antes de aplicar esse arquivo, então só o fallback automático (achar 3000
|
|
ocupada, tentar 3001) resolveria, e só por sorte de ordem.
|
|
|
|
## Comandos úteis
|
|
|
|
```bash
|
|
sudo systemctl status b2bcall-api.service b2bcall-frontend.service
|
|
journalctl -u b2bcall-api.service -f
|
|
journalctl -u b2bcall-frontend.service -f
|
|
sudo systemctl restart b2bcall-api.service # depois de mudar código do backend
|
|
sudo systemctl restart b2bcall-frontend.service # depois de mudar dependencias do frontend
|
|
```
|
|
|
|
`apps/api` recompila (`tsc`) toda vez que a unit inicia/reinicia — leva uns
|
|
15-20s. `apps/frontend` (`next dev`) é bem mais rápido pra subir, mas cada
|
|
rota ainda compila na primeira vez que é visitada (comportamento normal do
|
|
modo dev do Next.js, não um problema desta unit).
|