Sdílet prostřednictvím

přehled .NET.NET Aspire

  • Článek

.NET Aspire je sada nástrojů, šablon a balíčků pro vytváření aplikací připravených pro nasazení do produkčního prostředí. .NET Aspire se dodává prostřednictvím kolekce balíčků NuGet, které se zaměřují na konkrétní výzvy a zlepšují je při vývoji moderních aplikací. Dnešní aplikace obecně využívají velký počet služeb, jako jsou databáze, zasílání zpráv a ukládání do mezipaměti, z nichž mnohé jsou podporovány prostřednictvím .NET.NET Aspire Integrace. Informace o podpoře najdete v zásadách podpory .NET.NET Aspire.

Proč .NET.NET Aspire?

.NET .NET Aspire zlepšuje prostředí vytváření aplikací, které mají různé projekty a prostředky. Díky vylepšením produktivity v době vývoje, která emulují nasazené scénáře, můžete rychle vyvíjet vzájemně propojené aplikace. Navrženy pro flexibilitu, .NET.NET Aspire umožňují nahradit nebo rozšířit součásti vašimi upřednostňovanými nástroji a pracovními postupy. Mezi klíčové funkce patří:

  • Dev-Time Orchestrace: .NET.NET Aspire poskytuje funkce pro spouštění a připojování multiprojektových aplikací, prostředků kontejnerů a dalších závislostí pro lokálních vývojových prostředí.
  • integrace : .NET Aspire integrace jsou balíčky NuGet pro běžně používané služby, jako jsou Redis nebo Postgres, se standardizovanými rozhraními, které zajišťují konzistentní a bezproblémové propojení s vaší aplikací.
  • nástroje: .NET Aspire přichází se šablonami projektů a prostředími nástrojů pro Visual Studio, Visual Studio Codea .NET CLI, aby vám pomohly vytvářet a interagovat s projekty .NET.NET Aspire.

Orchestrace během vývoje

V .NET.NET Aspirese "orchestrace" zaměřuje především na vylepšení místního vývojového prostředí zjednodušením správy konfigurace a propojení vaší aplikace. Je důležité si uvědomit, že orchestrace .NET.NET Aspirenení určená k nahrazení robustních systémů používaných v produkčních prostředích, jako je Kubernetes. Je to sada abstrakcí, které zjednodušují nastavení zjišťování služeb, proměnných prostředí a konfigurací kontejnerů a eliminují nutnost zabývat se podrobnostmi implementace nízké úrovně. S .NET.NET Aspiremá váš kód konzistentní prostředí pro spouštění na jakémkoli vývojovém počítači bez nutnosti složitých ručních kroků, což usnadňuje správu během fáze vývoje.

.NET .NET Aspire orchestrace pomáhá s následujícími problematikami:

  • složení aplikace: Zadejte .NET projekty, kontejnery, spustitelné soubory a cloudové prostředky, které tvoří aplikaci.
  • Zjišťování služeb a správa připojovacích řetězců: Hostitel aplikace vloží správné připojovací řetězce, konfigurace sítě a informace o zjišťování služeb, aby zjednodušil vývojářské prostředí.

Například při použití .NET Aspirevytvoří následující kód místní prostředek kontejneru Redis, počká, až bude dostupný, a poté nastaví příslušný připojovací řetězec v projektu "frontend" pomocí několika volání pomocných metod.

// Create a distributed application builder given the command line arguments.
var builder = DistributedApplication.CreateBuilder(args);

// Add a Redis server to the application.
var cache = builder.AddRedis("cache");

// Add the frontend project to the application and configure it to use the 
// Redis server, defined as a referenced dependency.
builder.AddProject<Projects.MyFrontend>("frontend")
       .WithReference(cache)
       .WaitFor(cache);

Další informace naleznete v tématu .NET.NET Aspire přehled orchestrace.

Důležitý

Volání AddRedis vytvoří v místním vývojovém prostředí nový kontejner Redis. Pokud chcete raději použít existující instanci Redis, můžete použít metodu AddConnectionString k odkazování na existující připojovací řetězec. Pro více informací viz Odkaz na existující zdroje.

integrace .NET.NET Aspire

.NET .NET Aspire integrace jsou balíčky NuGet navržené tak, aby zjednodušily připojení k oblíbeným službám a platformám, jako jsou Redis nebo PostgreSQL. .NET .NET Aspire integrace zpracovávají nastavení a interakci cloudových prostředků za vás prostřednictvím standardizovaných vzorů, jako je přidání kontrol stavu a telemetrie. Integrace jsou dvojího druhu – hostitelské integrace zastupují službu, ke které se připojujete, a klientské integrace představují klienta nebo příjemce této služby. Jinými slovy, pro mnoho hostitelských balíčků existuje odpovídající klientský balíček, který zpracovává připojení služby v rámci vašeho kódu.

Každá integrace je navržená tak, aby fungovala s hostitelem aplikace .NET.NET Aspire a jejich konfigurace se automaticky vloží odkazováním na pojmenované prostředky. Jinými slovy, pokud Example.ServiceFoo odkazuje na Example.ServiceBar, Example.ServiceFoo dědí požadované konfigurace integrace, které jim umožní automaticky mezi sebou komunikovat.

Představte si například následující kód pomocí integrace služby .NET.NET Aspire Service Bus:

builder.AddAzureServiceBusClient("servicebus");

Metoda AddAzureServiceBusClient řeší následující otázky:

  • Zaregistruje ServiceBusClient jako singleton v kontejneru DI pro připojení k Azure Service Bus.
  • Použije konfigurace ServiceBusClient buď přímo v kódu, nebo prostřednictvím nastavení.
  • Umožňuje odpovídající kontroly stavu, protokolování a telemetrii specifické pro Azure Service Bus využití.

Úplný seznam dostupných integrací je podrobně uveden na stránce s přehledem integrací .NET.NET Aspire.

Šablony a nástroje projektu

.NET Aspire poskytuje sadu šablon projektů a nástrojů pro Visual Studio, Visual Studio Codea rozhraní příkazového řádku .NET. Tyto šablony jsou navržené tak, aby vám pomohly vytvářet a pracovat s .NET Aspire projekty nebo přidávat .NET Aspire do existujícího základu kódu. Šablony obsahují sadu přednastavených hodnot s názory, které vám pomohou rychle začít – například obsahují často používaný kód pro aktivaci kontrol zdravotního stavu a přihlášení do .NET aplikací. Tyto výchozí hodnoty jsou plně přizpůsobitelné, takže je můžete upravit a přizpůsobit podle svých potřeb.

šablony .NET.NET Aspire zahrnují také často používané metody rozšíření, které zpracovávají běžné konfigurace služeb za vás:

builder.AddServiceDefaults();

Další informace o tom, co AddServiceDefaults dělá, najdete v sekci .NET.NET Aspire ve výchozích nastaveních služby.

Po přidání do souboru Program.cs se předchozí kód zabývá následujícími obavami:

  • OpenTelemetry: Nastaví formátované protokolování, runtime ukazatele, integrovaná měření a trasování pro ASP.NET Core, gRPC a HTTP. Další informace najdete v tématu .NET.NET Aspire telemetrie.
  • Výchozí kontroly zdraví: Přidává výchozí koncové body pro kontrolu zdraví, které mohou nástroje dotazovat pro monitorování vaší aplikace. Další informace najdete v části .NET kontroly stavu aplikace v jazyce C#.
  • zjišťování služby: Povolí zjišťování služby pro aplikaci a nakonfiguruje HttpClient odpovídajícím způsobem.

Další kroky

Rychlý průvodce : Vytvoření vašeho prvního .NET.NET Aspire projektu