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.

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.

Fontes

Seguir