.NET .NET Aspire konfigurowanie i narzędzia
.NET .NET Aspire zawiera narzędzia ułatwiające tworzenie i konfigurowanie aplikacji natywnych dla chmury. Narzędzia obejmują przydatne szablony projektów startowych i inne funkcje, aby usprawnić rozpoczęcie pracy z .NET Aspire dla Visual Studio, Visual Studio Codeoraz przepływów pracy CLI. W kolejnych sekcjach dowiesz się, jak pracować z narzędziami .NET.NET Aspire i zapoznać się z następującymi zadaniami:
- Zainstaluj .NET.NET Aspire i jego zależności
- Tworzenie szablonów projektów startowych przy użyciu Visual Studio, Visual Studio Codelub interfejsu wiersza polecenia .NET
- Instalowanie integracji .NET.NET Aspire
- Praca z pulpitem nawigacyjnym .NET.NET Aspire
Zainstaluj .NET.NET Aspire
Aby pracować z .NET.NET Aspire, musisz mieć zainstalowane lokalnie następujące rzeczy:
- .NET 8.0 lub .NET 9.0.
- .NET .NET Aspire zestawu SDK
- Środowisko uruchomieniowe kontenera zgodne ze standardem OCI, takie jak:
- Docker Desktop lub Podman. Aby uzyskać więcej informacji, zobacz Container Runtime.
- Zintegrowane środowisko deweloperskie (IDE) lub edytor kodu, takie jak:
- Visual Studio 2022 w wersji 17.9 lub nowszej (opcjonalnie)
-
Visual Studio Code (opcjonalnie)
- C# Dev Kit: rozszerzenia (opcjonalnie)
- JetBrains Rider z wtyczką .NET.NET Aspire (opcjonalnie)
Visual Studio 2022 w wersji 17.9 lub nowszej zawiera najnowsze .NET.NET Aspire SDK domyślnie podczas instalowania obciążenia web & Cloud.
Jeśli masz starszą wersję Visual Studio 2022 r., możesz przeprowadzić uaktualnienie do wersji Visual Studio 2022 17.9 lub zainstalować zestaw SDK .NET Aspire, wykonując następujące kroki:
Aby zainstalować obciążenie .NET Aspire w Visual Studio 2022 r., użyj instalatora Visual Studio.
Otwórz instalatora Visual Studio.
Wybierz Modyfikuj obok pozycji Visual Studio 2022.
Wybierz obciążenie ASP.NET i tworzenie stron internetowych.
Na panelu szczegóły instalacji
wybierz pozycję zestaw SDK Wybierz pozycję Modyfikuj, aby zainstalować integrację .NET.NET Aspire.
Aby upewnić się, że zainstalowano najnowszą wersję zestawu .NET.NET Aspire SDK, ...
Środowisko uruchomieniowe kontenera
Projekty .NET.NET Aspire są przeznaczone do uruchamiania w kontenerach. Jako środowisko uruchomieniowe kontenera można użyć Docker Desktop lub Podman.
Docker Desktop jest najbardziej typowym środowiskiem uruchomieniowym kontenera.
Podman to open-source'owa alternatywa bez demona dla Docker, która może budować i uruchamiać kontenery Open Container Initiative (OCI). Jeśli środowisko hosta ma zainstalowane zarówno Docker, jak i Podman, .NET Aspire domyślnie korzysta z Docker. Zamiast tego możesz poinstruować .NET Aspire, aby użyć Podman, ustawiając zmienną środowiskową DOTNET_ASPIRE_CONTAINER_RUNTIME na podman:
export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman
Aby uzyskać więcej informacji, zobacz Install Podman on Linux.
szablony .NET.NET Aspire
.NET .NET Aspire udostępnia zestaw szablonów rozwiązań i projektów. Te szablony są dostępne w ulubionym środowisku zintegrowanym .NET dla deweloperów. Te szablony umożliwiają tworzenie pełnych rozwiązań .NET Aspire lub dodawanie poszczególnych projektów do istniejących rozwiązań .NET Aspire. Aby uzyskać więcej informacji, zobacz .NET.NET Aspire szablony.
panel kontrolny .NET.NET Aspire
.NET .NET Aspire szablony, które uwidaczniają projekt hosta aplikacji , obejmują również przydatny pulpit nawigacyjny używany do monitorowania i inspekcji różnych aspektów aplikacji, takich jak dzienniki, ślady i konfiguracje środowiska. Ten pulpit nawigacyjny jest przeznaczony do ulepszania lokalnego środowiska programistycznego i zawiera omówienie ogólnego stanu i struktury aplikacji.
Pulpit nawigacyjny .NET.NET Aspire jest widoczny tylko wtedy, gdy aplikacja jest uruchomiona i jest uruchamiana automatycznie po uruchomieniu *. Projekt AppHost. Zarówno Visual Studio, jak i Visual Studio Code automatycznie uruchamiają zarówno twoją aplikację, jak i pulpit nawigacyjny .NET Aspire w przeglądarce. Jeśli uruchomisz aplikację przy użyciu interfejsu wiersza polecenia .NET, skopiuj i wklej adres URL pulpitu nawigacyjnego z danych wyjściowych do przeglądarki lub przytrzymaj Ctrl i wybierz link (jeśli terminal obsługuje hiperlinki).
Lewa nawigacja zawiera linki do różnych części deski rozdzielczej, każdą z nich możesz eksplorować w poniższych sekcjach.
Pulpit nawigacyjny .NET.NET Aspire jest również dostępny w trybie autonomicznym. Aby uzyskać więcej informacji, zobacz Autonomiczny pulpit nawigacyjny .NET.NET Aspire.
narzędzia Visual Studio
Visual Studio udostępnia dodatkowe funkcje umożliwiające pracę z integracjami .NET Aspire oraz projektem koordynatora hosta aplikacji. Nie wszystkie te funkcje są obecnie dostępne w Visual Studio Code lub za pośrednictwem interfejsu wiersza polecenia.
Dodawanie pakietu integracyjnego
Do swojej aplikacji dodajesz integracje .NET Aspire, tak jak każdy inny pakiet NuGet, używając Visual Studio. Jednak Visual Studio również udostępnia opcje interfejsu użytkownika umożliwiające bezpośrednie dodawanie integracji .NET Aspire.
W Visual Studiowybierz prawym przyciskiem myszy projekt, do którego chcesz dodać integrację .NET Aspire, a następnie wybierz pozycję Dodaj pakiet>.NET.NET Aspire....
Menedżer pakietów zostanie otwarty ze wstępnie skonfigurowanymi wynikami wyszukiwania (wypełnianiem kryteriów filtrowania) dla integracji .NET.NET Aspire, co pozwala łatwo przeglądać i wybierać żądaną integrację.
Aby uzyskać więcej informacji na temat integracji .NET.NET Aspire, zobacz omówienie integracji .NET.NET Aspire.
Dodawanie pakietów hostingu
.NET .NET Aspire pakiety hostingowe służą do konfigurowania różnych zasobów i zależności, od których aplikacja może zależeć lub z którego korzysta. Pakiety hostingowe różnią się od innych pakietów integracyjnych tym, że są dodawane do projektu *.AppHost. Aby dodać pakiet hostingowy do aplikacji, wykonaj następujące kroki:
W Visual Studiokliknij prawym przyciskiem myszy na projekcie *.AppHost i wybierz opcję Dodaj pakiet>.NET.NET Aspire....
Menedżer pakietów zostanie otwarty ze wstępnie skonfigurowanymi wynikami wyszukiwania (wypełnianie kryteriów filtru) dla .NET.NET Aspire pakietów hostingowych, co umożliwia łatwe przeglądanie i wybieranie odpowiedniego pakietu.
Dodaj projekty orkiestracji
Aby dodać projekty orkiestracji .NET.NET Aspire do istniejącej aplikacji, wykonaj następujące czynności:
W Visual Studiowybierz prawym przyciskiem myszy istniejący projekt i wybierz pozycję Dodaj obsługę programu>.NET.NET Aspire Orchestrator..
Zostanie otwarte okno dialogowe z podsumowaniem *.AppHost i *.ServiceDefaults projektów dodawanych do rozwiązania.
Wybierz ok i zostaną zastosowane następujące zmiany:
- *.AppHost i *.ServiceDefaults projekty orkiestracji są dodawane do rozwiązania.
- Do pliku
builder.AddServiceDefaultsoryginalnego projektu zostanie dodane wywołanie Program.cs. - Odwołanie do oryginalnego projektu zostanie dodane do pliku Program.cs*. Projekt AppHost.
Aby uzyskać więcej informacji na temat orkiestracji .NET.NET Aspire, zobacz omówienie orkiestracji .NET.NET Aspire.
Zapisz się do orkiestracji
Visual Studio oferuje możliwość dołączenia do Aspire orkiestracji podczas nowego przepływu pracy projektu. Wybierz tę opcję, aby Visual Studio utworzyć projekty *.AppHost i *.ServiceDefaults wraz z wybranym szablonem projektu.
Tworzenie projektu testowego
Jeśli używasz Visual Studioi wybierasz szablon .NET.NET Aspire Uruchom aplikację, możesz dołączyć projekt testowy. Ten projekt testowy to projekt xUnit zawierający przykładowy test, którego można użyć jako punktu wyjścia dla testów.
Aby uzyskać więcej informacji, zobacz Pisanie pierwszego testu .NET.NET Aspire.
narzędzia Visual Studio Code
Do tworzenia i rozwijania projektów Visual Studio CodeC# Dev Kit możesz użyć z rozszerzeniem .NET Aspire. Aby utworzyć nowy projekt
Po utworzeniu nowego projektu .NET Aspire uruchamiasz i debugujesz aplikację, przechodzisz przez punkty przerwania i sprawdzasz zmienne przy użyciu debugera Visual Studio Code:
