Backend Apps
1. Visão Geral
Backend Apps são serviços de backend (APIs, workers) hospedados e publicados pela plataforma. A tela e o fluxo de criação são bastante parecidos com os de Frontend Apps — a diferença está principalmente no preview e na forma de expor a aplicação publicamente.
2. Criando um Backend App
Assim como um Frontend App, um Backend App pode ser criado de duas formas:
Vibe Code (Create App)
Gera a aplicação a partir de uma descrição em linguagem natural, com escolha do modelo de IA. A plataforma já cuida do Dockerfile automaticamente nesse fluxo.
Import from GitHub
Importa um backend já existente a partir de um repositório Git, com os mesmos campos usados no Frontend App: App Name, GitHub URL, Branch, Container Port, App Folder in Repository (opcional), Dockerfile Path (opcional), Pastas adicionais (opcional) e GitHub Token (opcional, para repositórios privados).
Quando importado do GitHub, é obrigatório ter um Dockerfile configurado corretamente no repositório — a plataforma faz o build da aplicação a partir dele. É mandatório ter um repositório Git configurado para conseguir fazer o build.
3. Ambientes (Environments)
Cada Backend App tem ambientes (ex: Test, Production), mostrando Status, Artifact, Replicas, Memory, Secrets e Config Maps vinculados — mesmo modelo usado em Frontend Apps.
4. IDE do App
A IDE do Backend App tem as mesmas abas de um Frontend App — Code, Preview, Preview Logs e Builds — com o mesmo editor de arquivos, histórico de builds e AI Copilot para modificar, criar ou analisar código (com atalhos como Error handling, Refactor, Add tests).
A diferença fica na aba Preview: em um Backend App, o preview é o Swagger da API, disponível apenas quando a aplicação está corretamente configurada (atualmente suportado apenas para Java Quarkus).
5. Publicando um Backend App e Expondo a API
Publicar um Backend App tem uma etapa a mais em relação a um Frontend App:
- Fazer o build e o deploy do app.
- Se a intenção é expor a API na internet, configurar uma Route em API Management, apontando para esse Backend App.
Sem esse passo em API Management, o Backend App fica publicado internamente, mas não acessível publicamente.
6. Perguntas frequentes
Por que meu Preview não mostra o Swagger? O Swagger como preview só está disponível para aplicações Java Quarkus configuradas corretamente. Outras stacks não geram esse preview automaticamente.
Um Backend App pode ser chamado a partir de um Flow? TODO: confirmar padrão de integração (ex: via componente HTTP, usando a URL interna do Backend App).
Dá para expor a mesma API em Test e Production com rotas diferentes? TODO: confirmar se as Routes em API Management são configuradas por ambiente.