Como hospedar uma aplicação .NET na Vertra Cloud

​

Requisitos

• .NET SDK 10 instalado localmente
• Conta na Vertra Cloud
• Um projeto ASP.NET Core ou de console com um .csproj

​

Estrutura do projeto

my-server-dotnet/
├── Program.cs
├── MyServer.csproj
└── vertracloud.config

​

Configuração

​

MyServer.csproj

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

</Project>

​

vertracloud.config

MAIN=MyServer.csproj
VERSION=recommended

​

Exemplo: Minimal API

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => Results.Json(new { message = ".NET on Vertra Cloud", version = "1.0.0" }));
app.MapGet("/health", () => Results.Json(new { status = "healthy", service = "dotnet-api" }));

app.Run();

​

Deploy

vertra upload
vertra logs -f

​

Versões disponíveis

​

Observações

• Build: o projeto é publicado com dotnet publish em modo Release durante o deploy, então o primeiro deploy pode levar alguns minutos. Dê memória suficiente ao build
• Excluir do zip: as pastas bin e obj
• Variáveis de ambiente: leia com Environment.GetEnvironmentVariable("KEY") ou por meio de builder.Configuration
• Logs: use ILogger ou Console.WriteLine() para logs que aparecem em tempo real
• Mantenha TargetFramework em net10.0

​

Erros comuns

• Arquivo de projeto não encontrado: MAIN precisa apontar para o .csproj, relativo à raiz do zip.
• O site não abre: a aplicação precisa escutar na porta definida em ASPNETCORE_HTTP_PORTS (80). Remova qualquer porta fixa no código, para que a aplicação siga ASPNETCORE_HTTP_PORTS.
• O build fica sem memória: aumente a memória da aplicação e faça o deploy novamente. Veja Erros comuns.