Requisitos
- .NET SDK 10 instalado localmente
- Cuenta en Vertra Cloud
- Un proyecto ASP.NET Core o de consola con un
.csproj
Estructura del proyecto
La plataforma detecta .NET a partir de .csproj, .fsproj, .sln o global.json en la raíz del proyecto. Publica el proyecto en modo Release con dotnet publish y arranca el resultado.
Configuración
MyServer.csproj
vertracloud.config
MAIN es el archivo .csproj.
Ejemplo: API mínima
La aplicación debe escuchar en el puerto definido por ASPNETCORE_HTTP_PORTS. La plataforma ya lo define como 80, así que no necesitas configurar el puerto en el código ni con ajustes adicionales.
Despliegue
- Comprime el proyecto en un
.zip o súbelo a GitHub.
- En el panel, haz clic en Nuevo proyecto y sube el
.zip o pega la URL del repositorio.
- En Build, revisa el runtime (.NET), el archivo principal (
MyServer.csproj) y la memoria. Los comandos de inicio y de build están en Ajustes avanzados.
- Agrega tus variables de entorno en Entorno.
- En Red, activa Publicación web para que la aplicación obtenga una dirección
*.vertraweb.app (plan Pro o superior, 512 MB de memoria). La aplicación debe escuchar en el puerto 80.
- Revisa y despliega. Sigue la salida en la pestaña Logs.
Consulta CLI para la instalación y el inicio de sesión. Abre la carpeta con la extensión de Vertra Cloud instalada y ejecuta Desplegar el proyecto actual. Consulta Extensión de VS Code.
La guía completa está en Primer despliegue.
Versiones disponibles
Notas
- Compilación: el proyecto se publica con
dotnet publish en modo Release durante el despliegue, así que el primer despliegue puede tardar unos minutos. Asigna a la compilación memoria suficiente
- Excluir del zip: las carpetas
bin y obj
- Variables de entorno: léelas con
Environment.GetEnvironmentVariable("KEY") o a través de builder.Configuration
- Logs: usa
ILogger o Console.WriteLine() para los logs que aparecen en tiempo real
- Mantén
TargetFramework en net10.0
Errores comunes
- Archivo de proyecto no encontrado:
MAIN debe apuntar al .csproj, relativo a la raíz del zip.
- El sitio no abre: la aplicación debe escuchar en el puerto de
ASPNETCORE_HTTP_PORTS (80). Elimina cualquier puerto fijo en el código para que la aplicación siga ASPNETCORE_HTTP_PORTS.
- La compilación se queda sin memoria: aumenta la memoria de la aplicación y vuelve a desplegar. Consulta Errores comunes.
Última modificación el 26 de octubre de 2026