Backend Apps
1. Visión General
Los Backend Apps son servicios de backend (APIs, workers) alojados y publicados por la plataforma. La pantalla y el flujo de creación son bastante parecidos a los de Frontend Apps — la diferencia está principalmente en el preview y en la forma de exponer la aplicación públicamente.
2. Creando un Backend App
Igual que un Frontend App, un Backend App puede crearse de dos formas:
Vibe Code (Create App)
Genera la aplicación a partir de una descripción en lenguaje natural, con elección del modelo de IA. La plataforma ya se encarga del Dockerfile automáticamente en ese flujo.
Import from GitHub
Importa un backend ya existente desde un repositorio Git, con los mismos campos usados en el Frontend App: App Name, GitHub URL, Branch, Container Port, App Folder in Repository (opcional), Dockerfile Path (opcional), Carpetas adicionales (opcional) y GitHub Token (opcional, para repositorios privados).
Cuando el app se importa desde GitHub, es obligatorio tener un Dockerfile configurado correctamente en el repositorio: es a partir de él que la plataforma construye la imagen de la aplicación. Sin un repositorio Git configurado, no hay forma de hacer el build.
3. Entornos (Environments)
Cada Backend App tiene entornos (ej: Test, Production), mostrando Status, Artifact, Replicas, Memory, Secrets y Config Maps vinculados — el mismo modelo usado en Frontend Apps.
4. IDE del App
El IDE del Backend App tiene las mismas pestañas que un Frontend App — Code, Preview, Preview Logs y Builds — con el mismo editor de archivos, historial de builds y AI Copilot para modificar, crear o analizar código (con atajos como Error handling, Refactor, Add tests).
La diferencia está en la pestaña Preview: en un Backend App, el preview muestra el Swagger de la API en lugar de una interfaz visual. Aparece cuando la aplicación expone correctamente el endpoint de documentación de la API — en Java Quarkus esto funciona de forma nativa, y otros stacks (como Node/Next.js) también muestran el Swagger siempre que el endpoint esté configurado en la propia aplicación.
5. Publicando un Backend App y Exponiendo la API
Publicar un Backend App tiene un paso más respecto a un Frontend App:
- Hacer el build y el deploy del app.
- Si la intención es exponer la API en internet, configurar una Route en API Management, apuntando a ese Backend App.
Sin ese paso en API Management, el Backend App queda publicado internamente, pero no accesible públicamente.
6. Preguntas frecuentes
¿Por qué mi Preview no muestra el Swagger? Porque la aplicación no está exponiendo el endpoint de documentación de la API. En Java Quarkus el preview aparece de forma nativa; en otros stacks (ej: Node/Next.js) hay que configurar el endpoint del Swagger dentro de la propia aplicación.
¿Un Backend App puede ser llamado desde un Flow? Sí.
¿Se puede exponer la misma API en Test y Production con rutas diferentes? No — no es posible tener rutas diferentes por entorno para la misma API.