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 o app é importado do GitHub, é obrigatório ter um Dockerfile configurado corretamente no repositório: é a partir dele que a plataforma constrói a imagem da aplicação. Sem um repositório Git configurado, não há como 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 mostra o Swagger da API em vez de uma interface visual. Ele aparece quando a aplicação expõe corretamente o endpoint de documentação da API — em Java Quarkus isso funciona de forma nativa, e outras stacks (como Node/Next.js) também exibem o Swagger desde que o endpoint esteja configurado na própria aplicação.
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? Porque a aplicação não está expondo o endpoint de documentação da API. Em Java Quarkus o preview aparece de forma nativa; em outras stacks (ex: Node/Next.js) é preciso configurar o endpoint do Swagger dentro da própria aplicação.
Um Backend App pode ser chamado a partir de um Flow? Sim.
Dá para expor a mesma API em Test e Production com rotas diferentes? Não — não é possível ter rotas diferentes por ambiente para a mesma API.