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 client knihovny, které se připojují k prostředkům modelovaným hostitelskými integracemi a nazývají se client integrace.

Hostování integrací

Integrační služby konfigurovají aplikace buď zřizováním prostředků (jako jsou kontejnery nebo cloudové prostředky), nebo odkazováním na existující instance (například na místní SQL server). 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

Client integrace připojují client knihovny k vkládání závislostí (DI), definují schéma konfigurace a přidávají kontroly stavu, odolnost, a telemetrii, pokud je to možné. .NET Aspire client 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í knihovny client k propojení s hostitelskými integracemi. Rozšiřují rozhraní IHostApplicationBuilder a umožňují projektům využívající client, jako jsou vaše webové aplikace nebo API, používat připojený prostředek. Oficiální balíčk y NuGet integrace jsou označené , a . Kromě oficiální integrace client vytvořila komunita integraci client pro různé služby a platformy v rámci komunitní sady nástrojů.

Další informace o vytvoření vlastní integrace client najdete v tématu Vytvoření vlastních .NET Aspireclient integrací.

Vztah mezi hostováním a integrací client

Integrace hostování a client 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í client integraci. Konfigurace je to, co umožňuje, aby integrace hostování fungovala s integrací client.

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

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 client integrací připojit se k hostitelským integracím.

Integrace funkce

Když do projektu v rámci řešení .NET Aspire přidáte integraci client, automaticky se na tento projekt použijí výchozí služby ; což znamená, že je odkazováno na projekt Service Defaults a metoda rozšíření AddServiceDefaults se volá. 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 react odolávat selhání a stále zůstávat 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.

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 Aspire aplikace a knihovnami client. 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. Hostování.MySql - Client: 📦Aspire.MySqlConnector	Knihovna pro přístup k databázím MySqlConnector.
- Další informace: 📄 NATS - Hosting: 📦Aspire. Hostování.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 zdroj .NET.NET Aspire.
- Další informace: 📄MySQL Pomelo – EF Core - Hosting: 📦Aspire. Hostování.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 client integrace 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.
- Zjistěte 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.Hostování.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.