Aplicações
Frontend e API na Unbroker
Opere o frontend e a API como serviços separados no mesmo projeto. Cada um tem a própria configuração, o próprio histórico de deploy e o próprio comportamento em runtime.
Serviços separados no mesmo projeto
Um frontend e uma API têm necessidades de deploy diferentes, e pertencem ao mesmo produto. Use uma receita de framework estático para os arquivos gerados, um servidor Next.js quando você precisa de render no momento do request, e um serviço Node.js ou Docker para a API.
O Pro é necessário para receitas de framework, variáveis compartilhadas do projeto, previews e domínios de produção. Cada serviço no ar soma o uso de recursos que você configurou.
Configure cada serviço
Publique o site gerado e aponte-o para a origem pública da API. No Pro, conecte um domínio de produção e use configuração por ambiente para os previews.
Deixe as credenciais do banco e os segredos de assinatura no serviço da API. Inspecione os logs de runtime e as métricas de recursos enquanto o frontend segue com o próprio ciclo de releases.
Banco, workers e tempo real
O mesmo projeto pode incluir um nó de banco do Apps e workers em segundo plano. Para dashboards ou avisos ao vivo, o Beacon oferece canais de tempo real gerenciados, sem você operar o gateway de WebSocket.
O time pode trabalhar no Cloud ou pelo ubctl. O skill do agente leva essas tarefas operacionais para o ambiente de código, sobre os mesmos serviços.
Conecte o navegador à API
O guia de implementação cobre as URLs públicas da API, a configuração por ambiente, CORS e as checagens do navegador. Ele explica a diferença entre uma conexão privada de serviço e um endpoint que o navegador de quem visita o site alcança. Os passos estão no guia de frontend e API. O detalhe em português está em frontend e API.
O que muda ao separar
Os releases são independentes: você atualiza o frontend sem transformar cada mudança de assets num release do backend.
O projeto aparece junto. Os serviços e as relações entre eles ficam no canvas da Unbroker.
Conforme o produto cresce, dá para somar PostgreSQL, um worker em segundo plano ou o Beacon.
Perguntas
O frontend e a API podem ser serviços separados no mesmo projeto?
Sim. Eles rodam como serviços separados num projeto, cada um com a própria configuração, o próprio histórico de deploy e o próprio comportamento em runtime.
O navegador deve chamar o hostname privado de um serviço?
Não. Aponte o frontend para a origem pública da API. O guia de implementação explica a diferença entre uma conexão privada de serviço e um endpoint que o navegador alcança.
Previews e domínios de produção exigem Pro?
Sim. O Pro é necessário para receitas de framework, variáveis compartilhadas do projeto, previews e domínios de produção. Cada serviço no ar soma o uso de recursos que você configurou.