Deploy .NET and ASP.NET Core op Nodion

.NET and ASP.NET Core stap voor stap deployen

1. Eén project in de root, of DOTNET_PROJECT Nodion publiceert de ene .csproj of .fsproj in de Base directory, framework-dependent. Met meerdere projecten, of een solution waarvan de projecten in submappen staan, stel je op het tabblad Environment DOTNET_PROJECT met de vlag Build in op het pad van het webproject; de root heeft dan nog steeds een .sln of global.json nodig, zodat Nodion .NET herkent. De Base directory op de projectmap zetten werkt alleen als het project naar geen projecten buiten die map verwijst, want de build ziet niets boven die map. Build variable

   DOTNET_PROJECT=src/MyApp.Web/MyApp.Web.csproj

2. Laat het adres aan Nodion over Nodion start de app met ASPNETCORE_URLS=http://0.0.0.0:$PORT. Verwijder hardgecodeerde URL's zoals app.Run("http://localhost:5000") en Kestrel-endpoints in appsettings.json, want die hebben voorrang. Een API zonder pagina op / heeft een health-endpoint nodig; stel het pad daarvan in de app-instellingen in als pad van de health check. Program.cs

   var builder = WebApplication.CreateBuilder(args);
   builder.Services.AddHealthChecks();
   
   var app = builder.Build();
   app.MapHealthChecks("/healthz");
   app.MapGet("/", () => "Hello from Nodion");
   
   app.Run();

3. Houd AllowedHosts open voor de health check De health check roept elke instantie aan met het interne IP-adres van die instantie als host. De standaardwaarde uit de template, "AllowedHosts": "*", laat dat adres toe. Met een lijst van je domeinen antwoordt ASP.NET Core met 400 en gaat de release nooit live; houd * aan, of controleer hosts in je eigen middleware die het pad van de health check overslaat. appsettings.json

   {
     "AllowedHosts": "*"
   }

4. Maak de app aan en koppel PostgreSQL Maak een applicatie aan vanuit je repository in de regio EU Central, en daarna een PostgreSQL-database in dezelfde regio. Npgsql gebruikt connectionstrings in key-value-formaat, geen postgres://-URL's zoals DATABASE_URL, dus injecteer bij het koppelen van de database op het tabblad Environment host, port, database, user en password onder je eigen namen en bouw daarmee de connectionstring. Program.cs

   var cs = new Npgsql.NpgsqlConnectionStringBuilder
   {
       Host = builder.Configuration["DB_HOST"],
       Port = int.Parse(builder.Configuration["DB_PORT"] ?? "5432"),
       Database = builder.Configuration["DB_NAME"],
       Username = builder.Configuration["DB_USER"],
       Password = builder.Configuration["DB_PASSWORD"],
   }.ConnectionString;
   builder.Services.AddDbContext<AppDbContext>(o => o.UseNpgsql(cs));

5. Pas EF Core-migraties toe Nodion draait geen EF Core-migraties, en de run-image bevat geen SDK, dus dotnet ef kan niet als releasestap draaien. Pas ze toe bij het starten van de app met Database.Migrate(), wat prima is voor één instantie, of stap over op een Dockerfile die een migration bundle van EF Core bouwt en die als release command van de app draait. Program.cs

   using (var scope = app.Services.CreateScope())
   {
       scope.ServiceProvider.GetRequiredService<AppDbContext>().Database.Migrate();
   }

Goed om te weten

• SDK- en runtimeversieDe .NET-versielijn komt uit global.json, anders uit het TargetFramework van het project in de Base directory, anders is het .NET 10, en de run-image krijgt de ASP.NET Core-runtime van dezelfde lijn. Een project in een submap wordt hiervoor niet gelezen, dus een net8.0- of net9.0-app die je met DOTNET_PROJECT kiest, heeft een global.json met die versie nodig. Nodion installeert de actuele SDK van die lijn, die tot een nieuwere feature band kan horen, dus zet daar "rollForward": "latestFeature".
• Productie-instellingenNodion stelt ASPNETCORE_ENVIRONMENT niet in, dus ASP.NET Core draait als Production en leest appsettings.Production.json bovenop appsettings.json. Bewaar secrets in omgevingsvariabelen die als secret zijn gemarkeerd; ConnectionStrings__Default wordt ConnectionStrings:Default.

Wat Nodion voor je regelt

• Deploys zonder downtime Push naar je branch en Nodion bouwt een nieuwe release. Het verkeer schakelt over zodra de nieuwe instanties hun health check doorstaan; een mislukte release laat de draaiende versie staan. Apps met een lokaal volume herstarten in plaats daarvan, omdat de schijf bij één instantie hoort.
• Databases naast de app Managed PostgreSQL, pgvector, MySQL, Valkey en ClickHouse in dezelfde regio. Gekoppelde databases komen binnen als DATABASE_URL, REDIS_URL of CLICKHOUSE_URL.
• Previews per pull request Zet previews aan en pull requests uit je repository krijgen een eigen app met een eigen URL en nieuwe, lege databases, automatisch of handmatig aangemaakt. Forks en pull requests van bots worden overgeslagen.
• Workers, cronjobs en schalen Draai workers als extra processen van dezelfde app, plan jobs op het tabblad Cron en schaal elk proces naar maximaal 16 instanties.
• Releasestap Met buildpacks draait een release:-regel in het Procfile bij elke nieuwe build. Dockerfile-apps, en redeploys of rollbacks naar een eerdere image, gebruiken een releasecommando dat op de app zelf is ingesteld en dat ook voorrang heeft op de Procfile-regel. Bij statische sites draait een releasestap in een image die alleen de gebouwde bestanden bevat.
• Logs en metrics Build-, release- en runtimelogs plus metrics voor CPU, geheugen, schijf en netwerk van elke instantie in het dashboard.
• Domeinen en HTTPS Een standaardhostnaam met HTTPS vanaf de eerste deploy; je eigen domeinen krijgen automatisch certificaten.

Verder lezen

• Dockerfile vs buildpacks: welke moet je gebruiken? Allebei maken ze van je code een containerimage. Het verschil is wie de buildstappen schrijft, en dat bepaalt controle, onderhoud en beveiligingsupdates.
• Heroku-alternatieven met EU-hosting: 5 opties vergeleken Een Duits platform en Amerikaanse clouds met EU-regio's, vergeleken op hoofdkantoor, regio's en managed databases.

.NET and ASP.NET Core op Nodion: vragen en antwoorden