Přehled integrace .NET.NET Aspire

.NET Aspire integrace jsou kurátorovaná sada balíčků NuGet vybraných pro usnadnění integrace aplikací nativních pro cloud s významnými službami a platformami, jako jsou Redis a PostgreSQL. Každá integrace poskytuje základní funkce nativní pro cloud prostřednictvím automatického zřizování nebo standardizovaných vzorů konfigurace.

Spropitné

Vždy se snažte používat nejnovější verzi integrace .NET.NET Aspire, abyste mohli využívat nejnovější funkce, vylepšení a aktualizace zabezpečení.

Odpovědnosti za integraci

Většina .NET.NET Aspire integrací se skládá ze dvou samostatných knihoven, z nichž každá má jinou zodpovědnost. Jeden typ představuje prostředky v rámci projektu hostitele aplikace , označované jako integrační hostování . Druhý typ integrace představuje klientské knihovny, které se připojují k prostředkům modelovaným pomocí hostujících integrací a označují se jako klientské integrace.

Hostování integrací

Konfigurace hostingových integrací aplikací zahrnuje zřizování prostředků, jako jsou kontejnery nebo cloudové zdroje, či odkazování na existující instance, například místního SQL serveru. Tyto balíčky modelují různé služby, platformy nebo možnosti, včetně mezipamětí, databází, protokolování, úložiště a systémů zasílání zpráv.

Integrace hostingu rozšiřují rozhraní IDistributedApplicationBuilder, což umožňuje hostiteli aplikace projektu vyjádřit zdroje v rámci modelu aplikace . Oficiální hostování balíčků NuGet pro integraci jsou označené aspire, integrationa hosting. Kromě oficiálních integrací hostingu vytvořila komunita integrační řešení hostingu pro různé služby a platformy jako součást Community Toolkit.

Informace o vytvoření integrace vlastního hostovánínajdete v tématu Vytvoření integrace vlastního .NET.NET Aspire hostování.

integrace Client

integrace připojují klientské knihovny k injektáž závislostí ( DI), definují schéma konfigurace a přidávajíkontroly stavu , odolnosta telemetrii, pokud je to možné. .NET .NET Aspire klientské integrační knihovny mají předponu Aspire. a pak zahrňte úplný název balíčku, se kterým se integrují, například Aspire.StackExchange.Redis.

Tyto balíčky konfigurují existující klientské knihovny pro připojení k integracím pro hosting. Rozšiřují IHostApplicationBuilder rozhraní, které umožňuje klientským projektům, jako je webová aplikace nebo rozhraní API, používat připojený prostředek. Oficiální balíčky NuGet integrace klienta jsou označené aspire, integrationa client. Kromě oficiální integrace klientů vytvořila komunita integrace klientů pro různé služby a platformy jako součást komunitní sady nástrojů.

Další informace o vytváření vlastní integrace pro klienta naleznete v tématu Vytvoření vlastní integrace klientů .NET.NET Aspire.

Vztah mezi hostováním a integrací klientů

Integrace hostování a klientů jsou nejlepší při společném použití, ale nejsou propojené a je možné je použít samostatně. Některé integrace hostování nemají odpovídající integraci klienta. Konfigurace znamená, že integrace hostování funguje s integrací klienta.

Představte si následující diagram, který znázorňuje vztah mezi integrací hostování a klientů:

Hostitelský projekt aplikace je místo, kde se používají integrace hostování. Konfigurace, konkrétně proměnné prostředí, se vloží do projektů, spustitelných souborů a kontejnerů, což umožňuje integraci klientů připojit se k hostitelským integracím.

Integrace funkce

Když do projektu v rámci řešení .NET.NET Aspire přidáte integraci klienta, výchozí nastavení služby se automaticky aplikují na tento projekt; to znamená, že se odkazuje na výchozí nastavení služby a volá se metoda rozšíření AddServiceDefaults. Tato výchozí nastavení jsou navržená tak, aby dobře fungovala ve většině scénářů a je možné je podle potřeby přizpůsobit. Použijí se následující výchozí hodnoty služby:

• pozorovatelnost a telemetrie: Automaticky nastavuje konfigurace protokolování, sledování a měření:

  • protokolování: Technika, kde je kód instrumentován k vytváření protokolů zajímavých událostí, ke kterým došlo při spuštění programu.
  • trasování: Specializovaná forma záznamu, která pomáhá lokalizovat chyby a problémy s výkonem v aplikacích distribuovaných napříč více počítači nebo procesy.
  • Metriky: Číselné míry zaznamenané v průběhu času za účelem monitorování výkonu a stavu aplikace. Metriky se často používají k generování výstrah při zjištění potenciálních problémů.

• Kontroly stavu: Zpřístupňuje HTTP koncové body, aby poskytly základní informace o dostupnosti a stavu aplikace. Kontroly stavu se používají k ovlivnění rozhodnutí provedených orchestrátory kontejnerů, nástroji pro vyrovnávání zatížení, branami rozhraní API a dalšími službami pro správu.

• odolnost: Schopnost systému reagovat na selhání a zůstat funkční. Odolnost se rozšiřuje nad rámec prevence selhání, aby zahrnovala obnovení a rekonstrukci nativního prostředí cloudu zpět do stavu, který je v pořádku.

Aspekty správy verzí

Jednotlivé verze hostování a integrace klientů se aktualizují tak, aby cílily na nejnovější stabilní verze závislých prostředků. Při aktualizaci imagí kontejnerů pomocí nových verzí imagí se integrace hostování na tyto nové verze aktualizují. Podobně platí, že pokud je pro závislou klientskou knihovnu k dispozici nová verze NuGet, aktualizuje se odpovídající integrace klienta na novou verzi. Tím zajistíte dostupnost nejnovějších funkcí a aktualizací zabezpečení pro aplikace.

Pokud dojde k zásadním změnám v závislých prostředcích, integrace se můžou dočasně rozdělit do balíčků závislých na verzi, aby se usnadnila aktualizace v rámci zásadní změny. Další informace najdete v prvním příkladu takové zásadní změny .

Oficiální integrace

.NET .NET Aspire poskytuje řadu integrací, které vám pomůžou sestavovat aplikace nativní pro cloud. Tyto integrace jsou navržené tak, aby bez problémů fungovaly s hostitelem .NET.NET Aspire aplikace a klientskými knihovnami. V následujících částech najdete podrobnosti o integracích nezávislých na cloudu, specifických pro Azure, Amazon Web Services (AWS) a Community Toolkit.

Integrace nezávislé na cloudu

Následující část podrobně popisuje integrace .NET.NET Aspire nezávislé na cloudu, s odkazy na jejich příslušnou dokumentaci a balíčky NuGet, a poskytuje stručný popis každé integrace.

Dokumentace k integraci a balíčky NuGet	Popis
- Další informace: 📄 Apache Kafka - Hosting: 📦Aspire. Hosting.Kafka - Client: 📦Aspire.Confluent.Kafka	Knihovna pro vytváření a využívání zpráv z Apache Kafka brokeru.
- Další informace: 📄 Dapr - Hosting: 📦Aspire. Hostování.Dapr - Client: není k dispozici	Knihovna pro modelování Dapr jako prostředek .NET.NET Aspire.
- Další informace: 📄 Elasticsearch - Hosting: 📦Aspire. Hostování.Elasticsearch - Client: 📦Aspire. Elastic.Clients.Elasticsearch	Knihovna pro přístup k databázím Elasticsearch.
- Další informace: 📄 Keycloak - Hosting: 📦Aspire. Hostování.Keycloak - Client: 📦Aspire.Keycloak. Autentizace ověřování	Knihovna pro přístup k autentizaci Keycloak.
- Další informace: 📄 Milvus - Hosting: 📦Aspire. Hostování.Milvus - Client: 📦Aspire.Milvus.Client	Knihovna pro přístup k databázím Milvus.
- Další informace: 📄MongoDB ovladač - Hosting: 📦Aspire. Hostování.MongoDB - Client: 📦Aspire.MongoDB. Ovladač	Knihovna pro přístup k databázím MongoDB.
- Další informace: 📄 MySqlConnector - Hosting: 📦Aspire. Hosting.MySql - Client: 📦Aspire.MySqlConnector	Knihovna pro přístup k databázím MySqlConnector.
- Další informace: 📄 NATS - Hosting: 📦Aspire. Hosting.Nats - Client: 📦Aspire.NATS.Net	Knihovna pro přístup k zasílání zpráv NATS.
- Zjistit více: 📄Oracle – EF Core - Hosting: 📦Aspire. Hostování.Oracle - Client: 📦Aspire.Oracle.EntityFrameworkCore	Knihovna pro přístup k databázím Oracle pomocí Entity Framework Core.
- Další informace: 📄 Orleans - Hosting: 📦Aspire. Hostování.Orleans - Client: není k dispozici	Knihovna pro modelování Orleans jako prostředek .NET.NET Aspire.
- Další informace: 📄MySQL Pomelo – EF Core - Hosting: 📦Aspire. Hosting.MySql - Client: 📦Aspire.Pomelo.EntityFrameworkCore.MySql	Knihovna pro přístup k databázím MySQL pomocí Entity Framework Core.
- Zjistit více: 📄PostgreSQL – EF Core - Hosting: 📦Aspire. Hostování.PostgreSQL - Client: 📦Aspire. Npgsql.EntityFrameworkCore.PostgreSQL	Knihovna pro přístup k databázím PostgreSQL pomocí Entity Framework Core.
- Další informace: 📄 PostgreSQL - Hosting: 📦Aspire. Hostování.PostgreSQL - Client: 📦Aspire. Npgsql	Knihovna pro přístup k databázím PostgreSQL.
- Další informace: 📄 Qdrant - Hosting: 📦Aspire. Hosting.Qdrant - Client: 📦Aspire. Qdrant.Client	Knihovna pro přístup k databázím Qdrant.
- Další informace: 📄 RabbitMQ - Hosting: 📦Aspire. Hostování.RabbitMQ - Client: 📦Aspire.RabbitMQ.Client	Knihovna pro přístup k RabbitMQ.
- Další informace: 📄Redis distribuované ukládání do mezipaměti - Hosting: 📦Aspire.Hosting.Redis, 📦Aspire.Hosting.Garnet, nebo 📦Aspire.Hosting.Valkey : . StackExchange.. distribuovaného	Knihovna pro přístup k mezipaměti Redis pro distribuované ukládání.
- Další informace: 📄Redis ukládání výstupu do mezipaměti - Hosting: 📦Aspire.Hosting.Redis, 📦Aspire.Hosting.Garnet, nebo 📦Aspire.Hosting.Valkey - Client: 📦Aspire. StackExchange.Redis. VýstupníCaching	Knihovna pro přístup k mezipamětem Redis pro ukládání výstupu do mezipamětí.
- Další informace: 📄 Redis - Hosting: 📦Aspire.Hosting.Redis, 📦Aspire.Hosting.Garnet, nebo 📦Aspire.Hosting.Valkey - Client: 📦Aspire. StackExchange.Redis	Knihovna pro přístup k Redis cache.
- Další informace: 📄 Seq - Hosting: 📦Aspire. Hostování.Seq - Client: 📦Aspire.Seq	Knihovna pro protokolování na Seq.
- Zjistit více: 📄SQL Server – EF Core - Hosting: 📦Aspire.Hosting.SqlServer - Client: 📦Aspire. Microsoft.EntityFrameworkCore.SqlServer	Knihovna pro přístup k databázím SQL Server pomocí EF Core.
- Další informace: 📄 SQL Server - Hosting: 📦Aspire.Hosting.SqlServer - Client: 📦Aspire. Microsoft.Data.SqlClient	Knihovna pro přístup k databázím SQL Server.

Další informace o práci s integracemi .NET Aspire v Visual Studionaleznete v dokumentaci Visual Studio nástroje.

integrace Azure

Azure integrace konfigurují aplikace tak, aby používaly Azure prostředky. Tyto integrace hostování jsou k dispozici v balíčcích NuGet Aspire.Hosting.Azure.*, zatímco jejich integrace klientů jsou k dispozici v balíčcích NuGet Aspire.*:

Dokumentace k integraci a balíčky NuGet	Popis
- Další informace: 📄Azure Konfigurace aplikace - Hosting: 📦Aspire.Hosting.Azure.AppConfiguration - Client: není k dispozici	Knihovna pro interakci s Azure Konfigurací aplikace.
- Další informace: 📄 Azure Application Insights - Hosting: 📦Aspire. Hostování.Azure. ApplicationInsights - Client: není k dispozici	Knihovna pro interakci s Azure Application Insights.
- Zjistit více: 📄Azure Cosmos DB – EF Core - Hosting: 📦Aspire.Hosting.Azure.CosmosDB - Client: 📦Aspire. Microsoft.EntityFrameworkCore.Cosmos	Knihovna pro přístup k AzureAzure Cosmos DB databázím pomocí Entity Framework Core.
- Další informace: 📄 Azure Cosmos DB - Hosting: 📦Aspire.Hosting.Azure.CosmosDB - Client: 📦Aspire. Microsoft.Azure. Cosmos	Knihovna pro přístup k databázím Azure Cosmos DB.
- Další informace: 📄 Azure Event Hubs - Hosting: 📦Aspire. Hostování.Azure. EventHubs - Client: 📦Aspire.Azure. Messaging.EventHubs	Knihovna pro přístup k Azure Event Hubs.
- Další informace: 📄Azure Functions - Hosting: 📦Aspire. Hostování.Azure. Funkce - Client: není k dispozici	Knihovna pro integraci s funkcemi Azure.
- Další informace: 📄 Azure Key Vault - Hosting: 📦Aspire. Hostování.Azure. služby KeyVault - Client: 📦Aspire.AzureSecurity.KeyVault	Knihovna pro přístup k Azure Key Vault.
- Další informace: 📄Azure Provozní přehledy - Hosting: 📦Aspire. Hostování.Azure. OperationalInsights - Client: není k dispozici	Knihovna pro interakci s Azure Operational Insights.
- Další informace: 📄 Azure AI OpenAI - Hosting: 📦Aspire. Hostování.Azure.CognitiveServices - Client: 📦Aspire.Azure. Umělá inteligence.OpenAI	Knihovna pro přístup k funkcím Azure AI OpenAI nebo OpenAI.
- Další informace: 📄 Azure PostgreSQL - Hosting: 📦Aspire. Hostování.Azure.PostgreSQL - Client: není k dispozici	Knihovna pro práci s databází Azure pro PostgreSQL.
- Další informace: 📄Azure AI vyhledávání - Hosting: 📦Aspire. Hostování.Azure. Hledat - Client: 📦Aspire.Azure. Hledat.Dokumenty	Knihovna pro přístup k funkcím Azure AI Search.
- Další informace: 📄 Azure Service Bus - Hosting: 📦Aspire. Hostování.Azure. ServiceBus - Client: 📦Aspire.Azure. Messaging.ServiceBus	Knihovna pro přístup k Azure Service Bus.
- Další informace: 📄 Azure SignalR Service - Hosting: 📦Aspire. Hostování.Azure.SignalR - Client: Microsoft.Azure.SignalR	Knihovna pro přístup k Azure SignalR Service.
- Další informace: 📄 Azure Blob Storage - Hosting: 📦Aspire. Hostování.Azure. úložiště - Client: 📦Aspire.Azure.Storage.Blobs	Knihovna pro přístup k Azure Blob Storage.
- Další informace: 📄 Azure Storage Queues - Hosting: 📦Aspire. Hostování.Azure. úložiště - Client: 📦Aspire.Azure. Storage.Queues	Knihovna pro přístup k Azure Storage Queues.
- Další informace: 📄 Azure Table Storage - Hosting: 📦Aspire. Hostování.Azure. úložiště - Client: 📦Aspire.Azure. Data.Tables	Knihovna pro přístup ke službě Azure Table.
- Další informace: 📄Azure Web PubSub - Hosting: 📦Aspire.Hostování.Azure.WebPubSub - Client: 📦Aspire.Azure. Messaging.WebPubSub	Knihovna pro přístup ke službě Azure Web PubSub.

Integrace hostování Amazon Web Services (AWS)

Dokumentace k integraci a balíčky NuGet	Popis
- Další informace: 📄 hostování AWS - Hosting: 📦Aspire.Hosting.AWS - Client: není k dispozici	Knihovna pro modelování zdrojů AWS.

Další informace naleznete v GitHub: Aspire. knihovně Hosting.AWS.

Integrace sady Community Toolkit

Poznámka

Integrace sady Community Toolkit jsou řízeny komunitou a spravovány komunitou .NET.NET Aspire. Tyto integrace nejsou oficiálně podporovány týmem .NET.NET Aspire.

Dokumentace k integraci a balíčky NuGet	Popis
- Další informace: 📄Azure emulátor Static Web Apps - Hosting: 📦 CommunityToolkit.Aspire. Hostování.Azure. StaticWebApps - Client: není k dispozici	Integrace hostování emulátoru Azure Static Web Apps (Poznámka: Nepodporuje nasazení projektu do Azure Static Web Apps).
- Další informace: 📄 Bun hosting - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Bun - Client: není k dispozici	Integrace hostování pro aplikace Bun.
- Další informace: 📄Deno hostování - Hosting: 📦 CommunityToolkit.Aspire. Hostování.Deno - Client: není k dispozici	Integrace hostingu pro aplikace Deno.
- Zjistit více: 📄 Jít na hosting - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Golang - Client: není k dispozici	Integrace hostování pro aplikace Go.
- Další informace: 📄 Hosting pro Java/Spring - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Java - Client: není k dispozici	Integrace pro spouštění kódu Java v .NET.NET Aspire buď pomocí místní sady JDK, nebo pomocí kontejneru.
- Zjistit více: 📄Node.js rozšíření hostingu - Hosting: 📦 CommunityToolkit.Aspire. Hosting.NodeJs.Extensions - Client: není k dispozici	Integrace, která obsahuje několik dalších rozšíření pro spouštění aplikací Node.js
- Zjistit více: 📄 Ollama - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Ollama - Client: 📦Aspire.CommunitToolkit.OllamaSharp	Komponenta Aspire využívající kontejner Ollama s podporou stažení modelu při spuštění.
- Další informace: 📄 hostování Meilisearch - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Meilisearch - Client: 📦Aspire. CommunitToolkit.Meilisearch	Komponenta Aspire využívající kontejner Meilisearch.
- Další informace: 📄 Hosting pro Rust - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Rust - Client: není k dispozici	Integrace hostování pro aplikace Rust.
- Další informace: 📄 hostování projektů SQL Database - Hosting: 📦 CommunityToolkit.Aspire. Hosting.SqlDatabaseProjects - Client: není k dispozici	Integrace hostování Aspire pro projekty databáze SQL.

Pro více informací viz .NET.NET Aspire Community Toolkit.