Aspire nastavení a nástroje

Aspire obsahuje nástroje, které vám pomůžou vytvářet a konfigurovat aplikace nativní pro cloud. Nástroje zahrnují užitečné úvodní šablony projektů a další funkce, které zjednodušují začátky práce s Aspire pro Visual Studio, Visual Studio Codea pracovní postupy rozhraní příkazového řádku. V dalších částech se dozvíte, jak pracovat s Aspire nástroji a prozkoumat následující úlohy:

• Instalace Aspire a její závislosti
• Vytvoření úvodních šablon projektů pomocí Visual Studio, Visual Studio Codenebo rozhraní příkazového řádku .NET
• Nainstalujte Aspire integrace
• Práce s řídicím panelem Aspire

Instalace Aspire požadovaných součástí

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 Plocha
  • Podman
    • Další informace najdete v části Běhové prostředí kontejneru.
• 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é)

Tip

Alternativně můžete vyvíjet Aspire řešení pomocí GitHub Codespaces nebo Dev Containers.

Visual Studio 2022 17.9 nebo vyšší zahrnuje nejnovější Aspire sadu SDK ve výchozím nastavení při instalaci úlohy Web &Cloud.

Aspire šablony

Aspire poskytuje sadu řešení a šablon projektů. Tyto šablony jsou k dispozici ve vašem oblíbeném integrovaném prostředí pro vývojáře .NET. Pomocí těchto šablon můžete vytvářet úplná Aspire řešení nebo přidávat jednotlivé projekty do existujících Aspire řešení.

Nainstalujte Aspire šablony

Pokud chcete šablony Aspire nainstalovat do Visual Studio, musíte je nainstalovat ručně, pokud nepoužíváte Visual Studio 17.12 nebo novější. Pro Visual Studio 17.9 až 17.11 postupujte takto:

1. Otevřít Visual Studio.
2. Přejděte na Tools>Správce balíčků NuGet>konzoly Správce balíčků.
3. Spuštěním následujícího příkazu nainstalujte šablony:

dotnet new install Aspire.ProjectTemplates

Pro Visual Studio 17.12 nebo novější se šablony Aspire nainstalují automaticky.

Pokud chcete tyto šablony nainstalovat, použijte příkaz dotnet new install a předejte identifikátor NuGet Aspire.ProjectTemplates.

dotnet new install Aspire.ProjectTemplates

Pokud chcete nainstalovat konkrétní verzi, připojte číslo verze k názvu balíčku:

dotnet new install Aspire.ProjectTemplates::9.4.0

Seznam šablon Aspire

Šablony Aspire se nainstalují automaticky při instalaci Visual Studio 17.9 nebo novější. Pokud chcete zjistit, které Aspire šablony jsou k dispozici, vyberte Soubor>nový>projekt v Visual Studioa na panelu hledání vyhledejte "Aspire" (Alt+S). Zobrazí se seznam dostupných Aspire šablon projektů:

Pokud chcete zobrazit dostupné šablony v Visual Studio Code s nainstalovanou sadou C# DevKit, vyberte tlačítko Vytvořit .NET Project, když není v zobrazení Explorer otevřena žádná složka:

Pak na panelu hledání vyhledejte "Aspire", abyste viděli dostupné šablony projektů Aspire:

Pokud chcete ověřit, že Aspire jsou šablony nainstalované, použijte příkaz dotnet new list a předejte aspire název šablony:

dotnet new list aspire

Výstup konzoly by měl vypadat takto:

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
Aspire AppHost               aspire-apphost          [C#]      Common/Aspire/Cloud
Aspire Empty App              aspire                  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Starter App            aspire-starter          [C#]      Common/Aspire/Blazor/Web/Web API/API/Service/Cloud
Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test

Další informace najdete v šablonáchAspire.

Běhové prostředí kontejneru

Aspire může spouštět kontejnery pomocí několika modulů runtime kompatibilních s OCI, včetně Docker Desktopu a Podman. I když někteří uživatelé hlásili úspěch pomocí Rancher Desktopu – zejména při konfiguraci pro použití rozhraní příkazového Docker řádku – nejedná se o oficiálně podporovaný nebo pravidelně otestovaný scénář. Je možné použít Rancher Desktop s výchozí instalací, ale nejedná se o oficiálně podporovaný nebo ověřený přístup. Pokud narazíte na problémy s Rancher Desktopem, dejte nám prosím vědět, ale mějte na paměti, že opravy nemusí být upřednostňovány.

• Docker Desktop je nejoblíbenější modul runtime kontejneru mezi Aspire vývojáři, který nabízí známé a široce podporované prostředí pro sestavování a spouštění kontejnerů.
• Podman je opensourcová alternativa bez démonů Docker. Podporuje vytváření a spouštění kontejnerů Open Container Initiative (OCI), což vývojářům, kteří dávají přednost jednoduchému řešení, je flexibilní volbou.

Pokud má vaše hostitelské prostředí nainstalované Docker a Podman, Aspire standardně používá Docker. Místo toho můžete dát Aspire pokyn, aby místo toho použili Podman nastavením proměnné prostředí ASPIRE_CONTAINER_RUNTIME na podman:

Linux

export ASPIRE_CONTAINER_RUNTIME=podman

Pro více informací se podívejte na Instalace Podman na Linux.

Windows

[System.Environment]::SetEnvironmentVariable("ASPIRE_CONTAINER_RUNTIME", "podman", "User")

Další informace naleznete v tématu Instalace Podman v systému Windows.

Úvahy o WSL (Windows Subsystému pro Linux)

Pokud používáte Podman v kombinaci s WSL, ujistěte se, že spustitelný soubor podman je dostupný v PATH a není pouze definovaný jako shellový alias. Aspire Řeší běhová prostředí kontejneru vyhledáním spustitelného souboru v systémové proměnné PATH a aliasy shellu se během tohoto procesu nerozpoznají.

Běžné problémy a jejich řešení:

• Podman nainstalována v samostatné distribuci WSL: Pokud je Podman nainstalována v jiné distribuci WSL než vaše aplikace Aspire, příkaz podman nemusí být k dispozici v PATHu aktuální distribuce.

  Řešení: Nainstalujte Podman přímo do distribuce WSL, ve které spouštíte aplikaci Aspire , nebo vytvořte symbolický odkaz na Podman spustitelný soubor v adresáři, který je ve vaší cestě (například /usr/local/bin).

• Použití shell aliasů: Pokud máte shell alias, například alias podman='podman-remote-static-linux_amd64' ve vašem ~/.bash_aliases nebo podobném souboru, Aspire nebude možné najít runtime kontejneru.

  Řešení: Místo použití aliasu vytvořte symbolický odkaz nebo přidejte adresář obsahující Podman spustitelný soubor do cesty PATH:

  # Option 1: Create a symbolic link
  sudo ln -s /path/to/podman-remote-static-linux_amd64 /usr/local/bin/podman
  
  # Option 2: Add to PATH in your shell profile
  echo 'export PATH="/path/to/podman/directory:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  

Ověřte nastavení: Spuštěním příkazu můžete ověřit, jestli Podman je správně nakonfigurovaný:

which podman
podman --version

Oba příkazy by měly být úspěšné a vrátit platné výsledky před spuštěním aplikace Aspire .

Tip

Pokud narazíte na problémy s použitím Podman v prostředích WSL, podívejte se na kontejner runtime 'podman' nebyl nalezen v WSL pro konkrétní pokyny k řešení těchto potíží.

Aspire palubní deska

Aspire Šablony, které zpřístupňují projekt AppHost , zahrnují také užitečný řídicí panel pro vývojáře, který se používá k monitorování a kontrole různých aspektů aplikace, jako jsou protokoly, trasování a konfigurace prostředí. Tento řídicí panel je navržený tak, aby zlepšil prostředí místního vývoje a poskytuje přehled celkového stavu a struktury vaší aplikace.

Řídicí panel Aspire je viditelný pouze při spuštění aplikace a automaticky se spouští, když spustíte projekt *.AppHost. Visual Studio a Visual Studio Code obě automaticky spustí vaši aplikaci i řídicí panel Aspire ve vašem prohlížeči. Pokud spustíte aplikaci pomocí rozhraní příkazového řádku .NET, zkopírujte a vložte adresu URL řídicího panelu z výstupu do prohlížeče nebo podržte Ctrl a vyberte odkaz (pokud terminál podporuje hypertextové odkazy).

Levá navigace poskytuje odkazy na různé části řídicího panelu, z nichž každý prozkoumáte v následujících částech.

Řídicí Aspire panel je také k dispozici v samostatném režimu. Další informace najdete v tématu Samostatný Aspire řídicí panel.

nástroj Visual Studio

Visual Studio poskytuje další funkce pro práci s integracemi Aspire a projektem orchestratoru AppHost. Ne všechny tyto funkce jsou momentálně dostupné v Visual Studio Code nebo prostřednictvím rozhraní příkazového řádku.

Přidání integračního balíčku

Do své aplikace přidáte Aspire integrace stejně jako jakýkoli jiný balíček NuGet pomocí Visual Studio. Visual Studio ale také nabízí možnosti uživatelského rozhraní pro přímé přidání Aspire integrací.

1. V Visual Studiookně klikněte pravým tlačítkem na projekt, do kterého chcete přidat Aspire integraci, a vyberte Přidat>Aspire balíček....

   

2. Otevře se správce balíčků s předkonfigurovanými výsledky hledání (naplněním kritérií filtru) pro Aspire integrace, což vám umožní snadno procházet a vybrat požadovanou integraci.

   

Další informace o Aspire integracích najdete v přehleduAspire integrací.

Přidání hostitelských balíčků

Aspire Hostitelské balíčky slouží ke konfiguraci různých prostředků a závislostí, na které může aplikace záviset nebo je využívat. Hostitelské balíčky se odlišují od ostatních integračních balíčků v tom, že jsou přidány do *. AppHost projektu. Pokud chcete do aplikace přidat hostitelský balíček, postupujte takto:

1. V Visual Studio, klikněte pravým tlačítkem na projektu *.AppHost a vyberte Přidat>Aspire balíček....

   

2. Otevře se správce balíků s předkonfigurovanými výsledky hledání s vloženými kritérii filtrování pro Aspire balíky hostování, což vám umožní snadno procházet a vybrat si požadovaný balíček.

   

Přidejte projekty orchestrace

Do existující aplikace můžete přidat Aspire projekty orchestrace pomocí následujícího postupu:

1. V Visual Studio klikněte pravým tlačítkem na existující projekt a zvolte Přidat>Aspire podporu Orchestratoru.

   

2. Otevře se dialogové okno se souhrnem *. AppHost a *. ServiceDefaults projekty přidané do vašeho řešení.

   

3. Vyberte OK a použijí se následující změny:

   • *.AppHost a *.ServiceDefaults projekty orchestrace jsou přidány do vašeho řešení.
   • Do souboru builder.AddServiceDefaults vašeho původního projektu bude přidáno volání Program.cs.
   • Odkaz na váš původní projekt bude přidán do souboru AppHost.cs projektu typu *.AppHost.

Další informace o Aspire orchestraci najdete v přehleduAspire orchestrace.

Přihlásit se do orchestrace

Visual Studio poskytuje možnost zařazení do Aspire orchestrace v rámci nového pracovního postupu projektu. Tuto možnost vyberte, pokud chcete Visual Studio vytvořit *. AppHost a *. ServiceDefaults projekty spolu s vybranou šablonou projektu.

Vytvoření testovacího projektu

Když používáte Visual Studioa vyberete Aspire šablonu Spustit aplikaci , máte možnost zahrnout testovací projekt. Tento testovací projekt je projekt xUnit, který obsahuje ukázkový test, který můžete použít jako výchozí bod pro testy.

Další informace najdete v tématu Psaní prvního Aspire testu.

nástroj Visual Studio Code

Pomocí Visual Studio Code s rozšířením C# Dev Kit, můžete vytvářet a vyvíjet Aspire projekty. Pokud chcete vytvořit nový Aspire projekt, Visual Studio Codevyberte v zobrazení .NET tlačítko Vytvořit projekt a pak vyberte jednu ze Aspire šablon:

Jakmile vytvoříte nový projekt Aspire, spustíte a ladíte aplikaci, procházíte zarážky a kontrolujete proměnné pomocí Visual Studio Code ladicího programu:

RozšířeníAspireVisual Studio Code poskytuje další příkazy a nástroje pro zjednodušení práce s Aspire projekty, včetně příkazů pro přidání integrací, konfigurace nastavení spuštění, publikování artefaktů nasazení a nasazení aplikací.

Aspire CLI

Aspire Rozhraní příkazového řádku (aspirepříkaz) je multiplatformní nástroj, který poskytuje funkce příkazového řádku pro vytváření, správu, spouštění a publikování projektů PolyglotAspire. Pomocí rozhraní příkazového Aspire řádku můžete zjednodušit vývojové pracovní postupy a koordinovat služby pro distribuované aplikace.

Další informace najdete v tématu Aspire Přehled rozhraní příkazového řádku a instalace Aspire rozhraní příkazového řádku.

Viz také

• Použití Dev Proxy s projektem Aspire
• Aspire Přehled rozhraní příkazového řádku