Wdróż .NET and ASP.NET Core na Nodion

Wdróż .NET and ASP.NET Core krok po kroku

1. Jeden projekt w katalogu głównym albo DOTNET_PROJECT Nodion publikuje jedyny plik .csproj lub .fsproj w katalogu Base directory, w trybie framework-dependent. Przy kilku projektach albo solution z projektami w podkatalogach ustaw w zakładce Environment DOTNET_PROJECT na ścieżkę projektu webowego, z zaznaczoną opcją Build; katalog główny nadal potrzebuje pliku .sln lub global.json, aby Nodion wykrył .NET. Ustawienie Base directory na katalog projektu działa tylko wtedy, gdy projekt nie odwołuje się do projektów spoza tego katalogu, bo build nie widzi niczego powyżej niego. Build variable

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

2. Pozwól Nodion ustawić adres Nodion uruchamia aplikację z ASPNETCORE_URLS=http://0.0.0.0:$PORT. Usuń zakodowane na sztywno adresy URL, takie jak app.Run("http://localhost:5000"), oraz endpointy Kestrel w appsettings.json, bo mają pierwszeństwo przed tą zmienną. API bez strony pod / potrzebuje endpointu do health checku; ustaw jego ścieżkę jako ścieżkę health checku w ustawieniach aplikacji. 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. Zostaw AllowedHosts otwarte dla health checku Health check wywołuje każdą instancję z jej wewnętrznym adresem IP jako hostem. Domyślna wartość z szablonu, "AllowedHosts": "*", przepuszcza taki adres. Przy liście Twoich domen ASP.NET Core odpowiada 400, a release nigdy nie przejmuje ruchu; zostaw * albo sprawdzaj hosty we własnym middleware, które pomija ścieżkę health checku. appsettings.json

   {
     "AllowedHosts": "*"
   }

4. Utwórz aplikację i podłącz PostgreSQL Utwórz aplikację ze swojego repozytorium w regionie EU Central, a następnie bazę danych PostgreSQL w tym samym regionie. Npgsql używa ciągów połączenia (connection string) w formacie par klucz-wartość, a nie URL-i postgres:// takich jak DATABASE_URL, więc podłączając bazę danych w zakładce Environment, przekaż host, port, nazwę bazy danych, użytkownika i hasło jako zmienne o własnych nazwach i zbuduj z nich ciąg połączenia. 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. Zastosuj migracje EF Core Nodion nie uruchamia migracji EF Core, a obraz uruchomieniowy nie zawiera SDK, więc dotnet ef nie może działać jako krok release. Zastosuj je przy starcie aplikacji przez Database.Migrate(), co sprawdza się przy jednej instancji, albo przejdź na Dockerfile, który buduje migration bundle EF Core i uruchamia go jako polecenie release aplikacji. Program.cs

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

Warto wiedzieć

• Wersja SDK i runtimeWersja .NET jest ustalana na podstawie global.json, a jeśli go nie ma, na podstawie TargetFramework projektu w katalogu Base directory, a jeśli i tego nie ma, używany jest .NET 10; obraz uruchomieniowy dostaje runtime ASP.NET Core z tej samej linii. Projekt w podkatalogu nie jest do tego odczytywany, więc aplikacja net8.0 lub net9.0 wybrana przez DOTNET_PROJECT potrzebuje global.json z tą wersją. Nodion instaluje aktualne SDK tej linii, które może należeć do nowszego feature bandu, więc ustaw tam "rollForward": "latestFeature".
• Ustawienia produkcyjneNodion nie ustawia ASPNETCORE_ENVIRONMENT, więc ASP.NET Core działa jako Production i odczytuje appsettings.Production.json oprócz appsettings.json. Sekrety trzymaj w zmiennych środowiskowych oznaczonych jako sekret; ConnectionStrings__Default odpowiada ConnectionStrings:Default.

Czym Nodion zajmuje się za Ciebie

• Wdrożenia bez przestojów Wypchnij zmiany do swojej gałęzi, a Nodion zbuduje nowy release. Ruch przełącza się, gdy nowe instancje przejdą health check; nieudany release nie wpływa na działającą wersję. Aplikacje z lokalnym wolumenem są natomiast uruchamiane ponownie, bo dysk należy do jednej instancji.
• Bazy danych obok aplikacji Zarządzane PostgreSQL, pgvector, MySQL, Valkey i ClickHouse w tym samym regionie. Podłączone bazy danych trafiają do aplikacji jako DATABASE_URL, REDIS_URL lub CLICKHOUSE_URL.
• Środowiska podglądu dla pull requestów Włącz środowiska podglądu, a każdy pull request z Twojego repozytorium dostanie własną aplikację z własnym adresem URL i nowymi, pustymi bazami danych, tworzoną automatycznie lub ręcznie. Forki i pull requesty od botów są pomijane.
• Workery, zadania cron i skalowanie Uruchamiaj workery jako dodatkowe procesy tej samej aplikacji, planuj zadania w zakładce Cron i skaluj każdy proces do 16 instancji.
• Etap release W przypadku buildpacków linia release: w Procfile uruchamia się przy każdym nowym buildzie. Aplikacje z Dockerfile, a także ponowne wdrożenia i rollbacki do wcześniejszego obrazu, korzystają z polecenia release ustawionego w samej aplikacji, które ma też pierwszeństwo przed linią z Procfile. W przypadku stron statycznych krok release działa w obrazie zawierającym tylko zbudowane pliki.
• Logi i metryki W dashboardzie znajdziesz logi z builda, release'u i działania aplikacji oraz metryki CPU, pamięci, dysku i sieci dla każdej instancji.
• Domeny i HTTPS Domyślna nazwa hosta z HTTPS od pierwszego wdrożenia; Twoje własne domeny automatycznie dostają certyfikaty.

Warto przeczytać

• Dockerfile vs buildpacki: co wybrać dla aplikacji? Oba podejścia zamieniają Twój kod w obraz kontenera. Różni je to, kto pisze kroki builda, a od tego zależą kontrola, utrzymanie i aktualizacje bezpieczeństwa.
• Alternatywy dla Heroku z hostingiem w UE: porównanie 5 opcji Niemiecka platforma i amerykańskie chmury z regionami w UE, porównane pod względem siedziby, regionów i zarządzanych baz danych.

.NET and ASP.NET Core na Nodion: pytania i odpowiedzi