Kurz: Přidání Aspire do existující aplikace .NET

Pokud máte existující mikroslužby a .NET webovou aplikaci, můžete do ní přidat Aspire a získat všechny zahrnuté funkce a výhody. V tomto článku přidáte Aspire orchestraci do jednoduchého, již existujícího projektu .NET 9. Naučíte se:

Seznamte se se strukturou existující aplikace mikroslužeb.
Zapojte existující projekty do Aspire orchestrace.
Pochopte změny, které zápis způsobuje v projektech.
Aspire Spusťte projekt.

Prerequisites

Pokud chcete pracovat s Aspire, potřebujete místně nainstalovat následující:

.NET 8.0 nebo .NET 9.0.
- Aspire Od verze 9.4 .NET se podporuje verze 10 Preview 5 nebo novější.
Modul runtime kontejneru kompatibilní s OCI, například:
- Docker Desktop nebo Podman. Další informace viz Container runtime.
Integrované vývojové prostředí (IDE) nebo editor kódu, například:
- Visual Studio 2022 verze 17.9 nebo novější (volitelné)
- Visual Studio Code (volitelné)
  - C# Dev Kit: Rozšíření (volitelné)
- JetBrains Rider s modulem Aspire plug-in (volitelné)

Další informace najdete v tématu Aspire nastavení a nástroje a Aspire SDK.

Začínáme

Začněme získáním kódu pro řešení:

Otevřete příkazový řádek a změňte adresáře na místo, kam chcete kód uložit.
Pokud chcete klonovat do ukázkového řešení .NET 9, použijte následující příkaz git clone:
```
git clone https://github.com/MicrosoftDocs/mslearn-dotnet-cloudnative-devops.git eShopLite
```

Prozkoumání ukázkové aplikace

Tento článek používá řešení .NET 9 se třemi projekty:

Data Entities: Tento projekt je ukázkovou knihovnou tříd. Definuje Product třídu použitou ve webové aplikaci a webovém rozhraní API.
Produkty: Toto ukázkové webové rozhraní API vrátí seznam produktů v katalogu a jejich vlastnosti.
store: Tento příklad Blazor Web App zobrazí katalog produktů návštěvníkům webu.

Architektura ukázkové aplikace

Pokud chcete lépe porozumět struktuře ukázkové aplikace, zvažte následující diagram, který znázorňuje jeho jednoduchou třívrstvou architekturu:

Tento vrstvený návrh zajišťuje jasné oddělení obav, což usnadňuje údržbu a škálování aplikace.

Spuštění ukázkové aplikace

Otevřete a spusťte ladění projektu, abyste prozkoumali jeho výchozí chování:

Spusťte Visual Studio a pak vyberte Soubor>Otevřít>Projekt/Řešení.
Přejděte do složky nejvyšší úrovně naklonovaného řešení, vyberte eShopLite.slna pak vyberte Otevřít.
V Průzkumníku řešeníklikněte pravým tlačítkem na řešení eShopLite a pak vyberte Konfigurovat spouštěcí projekty.
Zvolte více startovacích projektů.
Ve sloupci Akce vyberte Spustit pro projekty Products i Store.
Vyberte OK.
Pokud chcete spustit ladění řešení, stiskněte F5 nebo vyberte Spustit.
V prohlížeči se otevřou dvě stránky:
- Na stránce se zobrazují produkty ve formátu JSON z volání Web API Produktů.
- Na stránce se zobrazuje domovská stránka webu. V nabídce vlevo vyberte Products a zobrazte katalog získaný z webového rozhraní API.
Pro zastavení ladění zavřete prohlížeč.

Spusťte Visual Studio Code a otevřete složku, kterou jste naklonovali. V terminálu, kde jste naklonovali úložiště, spusťte následující příkaz:
```
code .
```
Vyberte položku nabídky Spustit a ladit nebo stiskněte Ctrl+Shift+D.
Vyberte odkaz vytvořit soubor launch.json.

Zkopírujte a vložte následující JSON do tohoto souboru a uložte:

Unix
Windows

{
    "version": "0.2.0",
    "compounds": [
        {
            "name": "Run all",
            "configurations": [
                "Run products",
                "Run store",
            ]
        }
    ],
    "configurations": [
        {
            "name": "Run products",
            "type": "dotnet",
            "request": "launch",
            "projectPath": "${workspaceFolder}/Products/Products.csproj"
        },
        {
            "name": "Run store",
            "type": "dotnet",
            "request": "launch",
            "projectPath": "${workspaceFolder}/Store/Store.csproj"
        }
    ]
}

{
    "version": "0.2.0",
    "compounds": [
        {
            "name": "Run all",
            "configurations": [
                "Run products",
                "Run store",
            ]
        }
    ],
    "configurations": [
        {
            "name": "Run products",
            "type": "dotnet",
            "request": "launch",
            "projectPath": "${workspaceFolder}\\Products\\Products.csproj"
        },
        {
            "name": "Run store",
            "type": "dotnet",
            "request": "launch",
            "projectPath": "${workspaceFolder}\\Store\\Store.csproj"
        }
    ]
}

Pokud chcete spustit ladění řešení, stiskněte F5 nebo vyberte Spustit.
V prohlížeči se otevřou dvě stránky:
- Na stránce se zobrazují produkty ve formátu JSON z volání Web API Produktů.
- Na stránce se zobrazuje domovská stránka webu. V nabídce vlevo vyberte Products a zobrazte katalog získaný z webového rozhraní API.
Pokud chcete ladění zastavit, zavřete prohlížeč a pak dvakrát vyberte tlačítko Zastavit (jednou pro každou spuštěnou instanci ladění).

Otevřete okno terminálu a změňte adresáře do nově naklonovaného úložiště.
Spuštěním následujícího příkazu spusťte aplikaci Products:
```
dotnet run --project ./Products/Products.csproj
```
Otevře se stránka prohlížeče zobrazující JSON pro produkty.
V samostatném okně terminálu znovu změňte adresáře na klonované úložiště.
Spusťte aplikaci Store spuštěním následujícího příkazu:
```
dotnet run --project ./Store/Store.csproj
```
Prohlížeč otevře stránku, která zobrazuje domovskou stránku webu. V nabídce vlevo vyberte Products a zobrazte katalog získaný z webového rozhraní API.
Ladění zastavíte tak, že zavřete prohlížeč a v obou terminálech stisknete Ctrl+C.

Bez ohledu na to, který nástroj použijete – ruční spuštění více projektů nebo konfigurace připojení mezi nimi je zdlouhavé. Kromě toho projekt Store vyžaduje explicitní konfiguraci koncového bodu pro rozhraní API produktů , což je náročné i náchylné k chybám. Tady Aspire zjednodušuje a urychluje proces!

Ujistěte se, že šablony Aspire jsou nainstalované.

Pokud jste dříve pracovali na Aspire svém aktuálním počítači, pravděpodobně už máte nainstalované potřebné .NET šablony projektů. Kontrolu můžete provést pomocí následujícího příkazu:

dotnet new list aspire

Aspire Pokud jsou šablony nainstalované, výstup bude vypadat přibližně takto:

These templates matched your input: 'Aspire'

Template Name       Short Name              Language  Tags
------------------  ----------------------  --------  -------------------------------------------------------------------------------
Aspire App...  aspire-apphost          [C#]      Common/Aspire/Cloud
Aspire Emp...  aspire                  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Ser...  aspire-servicedefaults  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Sta...  aspire-starter          [C#]      Common/Aspire/Blazor/Web/Web API/API/Service/Cloud/Test/MSTest/NUnit/xUnit
Aspire Tes...  aspire-mstest           [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test/MSTest
Aspire Tes...  aspire-nunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test/NUnit
Aspire Tes...  aspire-xunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test/xUnit

V tomto kurzu přidáte projekt AppHost a projekt Výchozí služby.

Pokud předchozí příkaz nenalezl žádné šablony, musíte je nainstalovat. Spusťte tento příkaz:

dotnet new install Aspire.ProjectTemplates

Další informace o Aspire šablonách najdete v tématu Aspire šablony.

Přidejte Aspire do webové aplikace obchodu

Nyní zaregistrujeme projekt Store, který implementuje webové uživatelské rozhraní v Aspire orchestraci:

V Visual Studioprůzkumníku řešení klikněte pravým tlačítkem myši na projekt Store , vyberte Přidat a pak vyberte Aspire Podpora orchestrátoru.
V dialogovém okně Přidat Aspire podporu nástroje Orchestrator vyberte OK.

Teď byste měli mít dva nové projekty, oba přidané do řešení:

eShopLite.AppHost: Projekt orchestrátoru navržený pro připojení a konfiguraci různých projektů a služeb vaší aplikace. Orchestrátor je nastavený jako spouštěcí projekta závisí na projektu eShopLite.Store.
eShopLite.ServiceDefaults: Aspire Sdílený projekt pro správu konfigurací, které se opakovaně používají napříč projekty ve vašem řešení související s odolností, zjišťováním služeb a telemetrií.

V projektu eShopLite.AppHost otevřete soubor AppHost.cs. Všimněte si tohoto řádku kódu, který zaregistruje projekt Store v Aspire orchestraci:

builder.AddProject<Projects.Store>("store");

Další informace najdete v tématu AddProject.

Přidání projektu Products do Aspire:

V Visual Studioprůzkumníku řešení klikněte pravým tlačítkem myši na projekt Produkty , vyberte Přidat a pak vyberte Aspire Podpora orchestrátoru.
Dialogové okno označující, že Aspire projekt Orchestrator již existuje, vyberte OK.

V projektu eShopLite.AppHost otevřete soubor AppHost.cs. Všimněte si tohoto řádku kódu, který zaregistruje projekt Products v Aspire orchestraci:

builder.AddProject<Projects.Products>("products");

Všimněte si také, že projekt eShopLite.AppHost teď závisí na projektech Store a Products.

Vytvoření projektu AppHost

Pokud chcete orchestrovat existující projekty, musíte vytvořit nový projekt AppHost . Pokud chcete vytvořit nový projekt AppHost z dostupných Aspire šablon, použijte následující .NET příkaz rozhraní příkazového řádku:

dotnet new aspire-apphost -o eShopLite.AppHost

Přidejte projekt AppHost do existujícího řešení:

Unix
Windows

dotnet sln ./eShopLite.sln add ./eShopLite.AppHost/eShopLite.AppHost.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.AppHost\eShopLite.AppHost.csproj

Pomocí následujícího příkazu rozhraní příkazového řádku přidejte projekt Store jako odkaz na projekt .NET:

Unix
Windows

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Store/Store.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Store\Store.csproj

Další informace o dostupných šablonách najdete v šablonáchAspire.

Vytvoření výchozího projektu služby

Po vytvoření projektu AppHost je potřeba vytvořit nový projekt výchozí služby . Pokud chcete vytvořit nové výchozí nastavení služby pro projekt z dostupných šablon Aspire, použijte následující příkaz v příkazovém řádku .NET:

dotnet new aspire-servicedefaults -o eShopLite.ServiceDefaults

Pokud chcete přidat projekt do řešení, použijte následující příkaz .NET rozhraní příkazového řádku:

Unix
Windows

dotnet sln ./eShopLite.sln add ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet sln .\eShopLite.sln add .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Aktualizujte projekt AppHost tak, aby se přidal odkaz na projekt Products :

Unix
Windows

dotnet add ./eShopLite.AppHost/eShopLite.AppHost.csproj reference ./Products/Products.csproj

dotnet add .\eShopLite.AppHost\eShopLite.AppHost.csproj reference .\Products\Products.csproj

Projekty Store a Products musí odkazovat na projekt výchozích služeb , aby mohly snadno zahrnovat zjišťování služeb . Pokud chcete přidat odkaz na projekt výchozí nastavení služby do projektu Store, použijte následující příkaz CLI .NET:

Unix
Windows

dotnet add ./Store/Store.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Store\Store.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

Stejný příkaz se stejnými mírně odlišnými cestami by se měl použít k přidání odkazu na projekt výchozích služeb do projektu Products.

Unix
Windows

dotnet add ./Products/Products.csproj reference ./eShopLite.ServiceDefaults/eShopLite.ServiceDefaults.csproj

dotnet add .\Products\Products.csproj reference .\eShopLite.ServiceDefaults\eShopLite.ServiceDefaults.csproj

V projektech Store i Products aktualizujte soubory Program.cs a hned za řádek var builder = WebApplication.CreateBuilder(args); přidejte následující řádek:

builder.AddServiceDefaults();

Aktualizace projektu AppHost

AppHost.cs Otevřete soubor projektu AppHost a nahraďte jeho obsah následujícím kódem jazyka C#:

var builder = DistributedApplication.CreateBuilder(args);

builder.AddProject<Projects.Store>("store");

builder.AddProject<Projects.Products>("products");

builder.Build().Run();

Předchozí kód:

Vytvoří novou instanci DistributedApplicationBuilder.
Přidá projekt Store do orchestrátoru.
Přidá projekt Products do orchestrátoru.
Sestaví a spustí orchestrátor.

Zjišťování služeb

V tuto chvíli jsou oba projekty součástí orchestrace, ale projekt Store musí využívat back-endovou adresu Products prostřednictvím vyhledávání služeb . Pokud chcete povolit zjišťování služeb, otevřete soubor AppHost.cs v projektu eShopLite.App Host a aktualizujte kód tak, aby builder přidal odkaz na projekt Products:

var builder = DistributedApplication.CreateBuilder(args);

var products = builder.AddProject<Projects.Products>("products");

builder.AddProject<Projects.Store>("store")
       .WithExternalHttpEndpoints()
       .WithReference(products)
       .WaitFor(products);

builder.Build().Run();

Předchozí kód vyjadřuje, že projekt Store závisí na projektu Products. Další informace naleznete v tématu Aspire AppHost: Referenční zdroje. Tento odkaz slouží ke zjištění adresy projektu Products za běhu. Kromě toho je projekt Store nakonfigurovaný tak, aby používal externí koncové body HTTP. Pokud se později rozhodnete tuto aplikaci nasadit, budete potřebovat volání WithExternalHttpEndpoints, abyste zajistili, že bude veřejná pro vnější svět. Rozhraní WaitFor API nakonec zajistí, že aplikace Store čeká, až bude aplikace Products připravena obsluhovat požadavky.

Dále aktualizujte appsettings.json v projektu Store následujícím JSON:

{
  "DetailedErrors": true,
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ProductEndpoint": "http://products",
  "ProductEndpointHttps": "https://products"
}

Adresy obou koncových bodů teď používají název "products", který byl přidán do orchestrátoru v AppHost. Tyto názvy slouží ke zjištění adresy projektu Products.

Prozkoumejte přihlášenou aplikaci

Začněme řešení a prozkoumáme nové chování, které Aspire poskytuje.

Note

Všimněte si, že projekt eShopLite.AppHost je nový spouštěný projekt.

V Visual Studiospustíte ladění stisknutím klávesy F5Visual Studio sestaví projekty.
Pokud se zobrazí dialogové okno Start Docker Desktop, vyberte Ano. Visual Studio spustí modul Docker a vytvoří potřebné kontejnery. Po dokončení nasazení se zobrazí Aspire řídicí panel.
Na řídicím panelu vyberte koncový bod pro produkty projektu. Zobrazí se nová karta prohlížeče a zobrazí katalog produktů ve formátu JSON.
Na řídicím panelu vyberte koncový bod projektu obchodu. Zobrazí se nová karta prohlížeče a zobrazí domovskou stránku webové aplikace.
V nabídce vlevo vyberte Produkty. Zobrazí se katalog produktů.
Pro zastavení ladění zavřete prohlížeč.

Odstraňte soubor launch.json, který jste vytvořili dříve, už neslouží k účelu. Místo toho spusťte projekt AppHost , který orchestruje ostatní projekty:

Spusťte projekt AppHost tak, že v Průzkumníku řešení kliknete pravým tlačítkem na projekt eShopLite.AppHost a vybereteSpustit novou instanci>:

Note

Pokud Docker desktop (nebo Podman) není spuštěný, dojde k chybě. Spusťte modul runtime kontejneru a zkuste to znovu.

Spusťte projekt AppHost spuštěním následujícího příkazu:
```
dotnet run --project ./eShopLite.AppHost/eShopLite.AppHost.csproj
```
Note

Pokud Docker desktop (nebo Podman) není spuštěný, dojde k chybě. Spusťte modul runtime kontejneru a zkuste to znovu.

Na řídicím panelu vyberte koncový bod pro produkty projektu. Zobrazí se nová karta prohlížeče a zobrazí katalog produktů ve formátu JSON.
Na řídicím panelu vyberte koncový bod projektu obchodu. Zobrazí se nová karta prohlížeče a zobrazí domovskou stránku webové aplikace.
V nabídce vlevo vyberte Produkty. Zobrazí se katalog produktů.
Pro zastavení ladění zavřete prohlížeč.

Blahopřejeme, do své existující webové aplikace jste přidali orchestraci Aspire. Teď můžete přidat Aspire integrace a pomocí nástrojů Aspire zjednodušit vývoj nativních cloudových webových aplikací.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-10-02