Overzicht van .NET.NET Aspire-integraties
.NET Aspire integraties zijn een gecureerde suite met NuGet-pakketten die zijn geselecteerd om de integratie van cloudeigen toepassingen met prominente services en platforms, zoals Redis en PostgreSQL, te vergemakkelijken. Elke integratie levert essentiële cloudeigen functionaliteiten via automatische inrichting of gestandaardiseerde configuratiepatronen.
Fooi
Probeer altijd de nieuwste versie van .NET.NET Aspire integraties te gebruiken om te profiteren van de nieuwste functies, verbeteringen en beveiligingsupdates.
Integratieverantwoordelijkheden
De meeste .NET.NET Aspire integraties bestaan uit twee afzonderlijke bibliotheken, elk met een andere verantwoordelijkheid. Eén type vertegenwoordigt resources in de app-host project, ook wel hostingintegratiesgenoemd. Het andere type integratie vertegenwoordigt client bibliotheken die verbinding maken met de resources die zijn gemodelleerd door hostingintegraties, en ze worden client integratiesgenoemd.
Hosting integraties
Hosting-integraties configureren toepassingen door resources (zoals containers of cloudresources) in te richten of door verwijzend naar bestaande instanties (zoals een lokale SQL server). Deze pakketten modelleren verschillende services, platforms of mogelijkheden, waaronder caches, databases, logboekregistratie, opslag en berichtensystemen.
Hostingintegraties breiden de IDistributedApplicationBuilder-interface uit, waardoor de app-host project resources kan uitdrukken binnen het app-model. De officiële hostingintegratie NuGet-pakketten zijn gelabeld met aspire, integrationen hosting. Naast de officiële hostingintegraties heeft de community hostingintegraties gemaakt voor verschillende services en platforms als onderdeel van de Community Toolkit.
Zie voor meer informatie over het maken van een aangepaste hostingintegratie, Aangepaste .NET.NET Aspire hostingintegratie maken.
Client-integraties
Client integraties koppelen client bibliotheken aan afhankelijkheidsinjectie (DI), configuratieschema definiëren en statuscontroles toevoegen, tolerantieen telemetrie indien van toepassing.
.NET Aspire
client integratiebibliotheken worden voorafgegaan door Aspire. en vervolgens de volledige pakketnaam opnemen waarmee ze zijn geïntegreerd, zoals Aspire.StackExchange.Redis.
Deze pakketten configureren bestaande client bibliotheken om verbinding te maken met hostingintegraties. Zij breiden de IHostApplicationBuilder-interface uit, zodat projecten die clientverbruiken, zoals uw webapp of API, de verbonden bron kunnen gebruiken. De officiële client integratie NuGet-pakketten zijn gelabeld met aspire, integrationen client. Naast de officiële client-integraties heeft de community client integraties gemaakt voor verschillende services en platforms als onderdeel van de Community Toolkit.
Voor meer informatie over het maken van een aangepaste client-integratie, zie Aangepaste .NET Aspireclient-integraties maken.
Relatie tussen hosting- en client-integraties
Hosting- en client-integraties zijn het beste wanneer ze samen worden gebruikt, maar niet gekoppeld en kunnen afzonderlijk worden gebruikt. Sommige hostingintegraties hebben geen bijbehorende client-integratie. Configuratie is wat ervoor zorgt dat de hostingintegratie werkt met de client-integratie.
Bekijk het volgende diagram waarin de relatie tussen hosting en client integraties wordt weergegeven:
Het app-hostproject is waar hostingintegraties worden gebruikt. Configuratie, met name omgevingsvariabelen, wordt geïnjecteerd in projecten, uitvoerbare bestanden en containers, waardoor client integraties verbinding kunnen maken met de hostingintegraties.
Integratie functies
Wanneer u een client-integratie toevoegt aan een project binnen uw .NET Aspire-oplossing, worden -servicestandaarden automatisch op dat project toegepast. Dit betekent dat er naar de servicestandaardenprojecten wordt verwezen en de AddServiceDefaults-extensiemethode wordt aangeroepen. Deze standaardinstellingen zijn ontworpen om goed te werken in de meeste scenario's en kunnen indien nodig worden aangepast. De volgende servicestandaardinstellingen worden toegepast:
waarneembaarheid en telemetrie: hiermee worden configuraties voor logboekregistratie, tracering en metrische gegevens automatisch ingesteld:
- Logboekregistratie: een techniek waarbij code wordt geïnstrueerd om logboeken te produceren van interessante gebeurtenissen die plaatsvonden tijdens het uitvoeren van het programma.
- Tracering: een speciale vorm van logboekregistratie waarmee u fouten en prestatieproblemen kunt lokaliseren binnen toepassingen die zijn gedistribueerd over meerdere computers of processen.
- metrische gegevens: numerieke metingen die in de loop van de tijd zijn vastgelegd om de prestaties en status van toepassingen te bewaken. Metrische gegevens worden vaak gebruikt om waarschuwingen te genereren wanneer potentiële problemen worden gedetecteerd.
Gezondheidscontroles: biedt HTTP-eindpunten die basisinformatie over de beschikbaarheid en status van een applicatie verschaffen. Statuscontroles worden gebruikt om beslissingen te beïnvloeden die worden genomen door containerorchestrators, load balancers, API-gateways en andere beheerservices.
Veerkracht: de mogelijkheid van uw systeem om storingen te react en nog steeds functioneel te blijven. Veerkracht gaat verder dan het enkel voorkomen van fouten; het omvat ook het herstellen en reconstrueren van uw cloudeigen omgeving naar een gezonde staat.
Officiële integraties
.NET .NET Aspire biedt veel integraties om u te helpen bij het bouwen van cloudtoepassingen. Deze integraties zijn ontworpen om naadloos te werken met de .NET Aspire app-host en client bibliotheken. In de volgende secties worden cloudagnostische, Azure-specifieke, Amazon Web Services (AWS) en Community Toolkit-integraties beschreven.
Cloudagnostische integraties
In de volgende sectie vindt u informatie over cloudagnostische .NET.NET Aspire-integraties met koppelingen naar hun respectieve documenten en NuGet-pakketten, en vindt u een korte beschrijving van elke integratie.
| Integratiedocumenten en NuGet-pakketten | Beschrijving |
|---|---|
|
-
Meer informatie: 📄 Apache Kafka - Hosting: 📦Aspire.Hosting.Kafka - Client: 📦Aspire. Confluent.Kafka |
Een bibliotheek voor het produceren en gebruiken van berichten van een Apache Kafka broker. |
|
-
Meer informatie: 📄 Dapr - Hosting: 📦Aspire.Hosting.Dapr - Client: n.v.t. |
Een bibliotheek voor het modelleren van Dapr als een .NET.NET Aspire resource. |
|
-
Meer informatie: 📄 Elasticsearch - Hosting: 📦Aspire. Hosting.Elasticsearch - Client: 📦Aspire. Elastic.Clients.Elasticsearch |
Een bibliotheek voor toegang tot Elasticsearch databases. |
|
-
Meer informatie: 📄 Keycloak - Hosting: 📦Aspire.Hosting.Keycloak - Client: 📦Aspire.Keycloak. Verificatie |
Een bibliotheek voor toegang tot Keycloak verificatie. |
|
-
Meer informatie: 📄 Milvus - Hosting: 📦Aspire.Hosting.Milvus - Client: 📦Aspire.Milvus.Client |
Een bibliotheek voor toegang tot Milvus databases. |
|
-
Meer informatie: 📄MongoDB stuurprogramma - Hosting: 📦Aspire. Hosting.MongoDB - Client: 📦Aspire.MongoDB. Stuurprogramma |
Een bibliotheek voor toegang tot MongoDB databases. |
|
-
Meer informatie: 📄 MySqlConnector- - Hosting: 📦Aspire.Hosting.MySql - Client: 📦Aspire.MySqlConnector |
Een bibliotheek voor toegang tot MySqlConnector databases. |
|
-
Meer informatie: 📄 NATS - Hosting: 📦Aspire.Hosting.Nats - Client: 📦Aspire.NATS.Net |
Een bibliotheek voor toegang tot NATS messaging. |
|
-
Meer informatie: 📄Oracle - EF Core - Hosting: 📦Aspire.Hosting.Oracle - Client: 📦Aspire.Oracle. EntityFrameworkCore- |
Een bibliotheek voor toegang tot Oracle databases met Entity Framework Core. |
|
-
Meer informatie: 📄 Orleans - Hosting: 📦Aspire. Hosting.Orleans - Client: n.v.t. |
Een bibliotheek voor het modelleren van Orleans als een .NET.NET Aspire resource. |
|
-
Meer informatie: 📄 Pomelo-MySQL - EF Core - Hosting: 📦Aspire.Hosting.MySql - Client: 📦Aspire. Pomelo.EntityFrameworkCore.MySql |
Een bibliotheek voor toegang tot MySql databases met Entity Framework Core. |
|
-
Meer informatie: 📄PostgreSQL - EF Core - Hosting: 📦Aspire.Hosting.PostgreSQL - Client: 📦Aspire. Npgsql.EntityFrameworkCore.PostgreSQL |
Een bibliotheek voor toegang tot PostgreSQL databases met behulp van Entity Framework Core. |
|
-
Meer informatie: 📄 PostgreSQL - Hosting: 📦Aspire.Hosting.PostgreSQL - Client: 📦Aspire.Npgsql |
Een bibliotheek voor toegang tot PostgreSQL databases. |
|
-
Meer informatie: 📄 Qdrant - Hosting: 📦Aspire.Hosting.Qdrant - Client: 📦Aspire. Qdrant.Client |
Een bibliotheek voor toegang tot Qdrant--databases. |
|
-
Meer informatie: 📄 RabbitMQ - Hosting: 📦Aspire. Hosting.RabbitMQ - Client: 📦Aspire.RabbitMQ.Client |
Een bibliotheek voor toegang tot RabbitMQ. |
|
-
Meer informatie: 📄Redis gedistribueerd cachen - Hosting: 📦Aspire.Hosting.Redis, 📦Aspire.Hosting.Garnetof 📦Aspire.Hosting.Valkey - Client: 📦Aspire.StackExchange.Redis.GedistribueerdeCaching |
Een bibliotheek voor toegang tot Redis caches voor gedistribueerde caching. |
|
-
Meer informatie: 📄Redis Outputcaching - Hosting: 📦Aspire.Hosting.Redis, 📦Aspire.Hosting.Garnetof 📦Aspire.Hosting.Valkey - Client: 📦Aspire. StackExchange.Redis. OutputCaching- |
Een bibliotheek voor toegang tot Redis caches voor uitvoercaching. |
|
-
Meer informatie: 📄 Redis - Hosting: 📦Aspire. Hosting.Redis, 📦Aspire. Hosting.Garnetof 📦Aspire. Hosting.Valkey - Client: 📦Aspire. StackExchange.Redis |
Een bibliotheek voor toegang tot Redis caches. |
|
-
Meer informatie: 📄 Seq - Hosting: 📦Aspire.Hosting.Seq - Client: 📦Aspire.Seq |
Een bibliotheek voor loggen naar Seq. |
|
-
Meer informatie: 📄SQL Server - EF Core - Hosting: 📦Aspire. Hosting.SqlServer - Client: 📦Aspire. Microsoft.EntityFrameworkCore.SqlServer |
Een bibliotheek voor toegang tot SQL Server databases met behulp van EF Core. |
|
-
Meer informatie: 📄 SQL Server - Hosting: 📦Aspire.Hosting.SqlServer - Client: 📦Aspire. Microsoft.Data.SqlClient |
Een bibliotheek voor toegang tot SQL Server databases. |
Voor meer informatie over werken met .NET Aspire-integraties in Visual Studio, zie Visual Studio-hulpprogramma's.
Azure-integraties
Azure-integraties configureren toepassingen voor het gebruik van Azure resources. Deze hostingintegraties zijn beschikbaar in de Aspire.Hosting.Azure.* NuGet-pakketten, terwijl hun client integraties beschikbaar zijn in de Aspire.* NuGet-pakketten:
Amazon Web Services (AWS) hosting integraties
| Integratiedocumenten en NuGet-pakketten | Beschrijving |
|---|---|
|
-
Meer informatie: 📄 AWS Hosting- - Hosting: 📦Aspire.Hosting.AWS- - Client: n.v.t. |
Een bibliotheek voor het modelleren AWS-resources. |
Zie GitHub: Aspirevoor meer informatie. Hosting.AWS-bibliotheek.
Community Toolkit-integraties
Notitie
De Community Toolkit-integraties zijn communitygestuurd en onderhouden door de .NET.NET Aspire community. Deze integraties worden niet officieel ondersteund door het .NET.NET Aspire team.
| Integratiedocumenten en NuGet-pakketten | Beschrijving |
|---|---|
|
-
Meer informatie: 📄Azure Static Web Apps-emulator - Hosting: 📦 CommunityToolkit.Aspire.Hosting.Azure. StaticWebApps- - Client: N/B |
Een hostingintegratie voor de Azure Static Web Apps-emulator (Opmerking: dit biedt geen ondersteuning voor de implementatie van een project voor Azure Static Web Apps). |
|
-
Meer informatie: 📄 Bun-hosting - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Bun - Client: N/B |
Een hostingintegratie voor Bun-apps. |
|
-
Meer informatie: 📄Deno hosting - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Deno - Client: N.v.t. |
Een hostingintegratie voor Deno apps. |
|
-
Meer informatie: 📄 Go hosting - Hosting: 📦 CommunityToolkit.Aspire.Hosting.Golang - Client: n.v.t. |
Een hostingintegratie voor Go-apps. |
|
-
Meer informatie: 📄 Java/Spring-hosting - Hosting: 📦 CommunityToolkit.Aspire.Hosting.Java- - Client: N.v.t. |
Een integratie voor het uitvoeren van Java-code in .NET.NET Aspire met behulp van de lokale JDK of een container. |
|
-
Meer informatie: 📄Node.js hostingextensies - Hosting: 📦 CommunityToolkit.Aspire. Hosting.NodeJs.Extensions - Client: n.v.t. |
Een integratie met enkele extra extensies voor het uitvoeren van Node.js-toepassingen |
|
-
Meer informatie: 📄 Ollama - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Ollama - Client: 📦Aspire.CommunitToolkit.OllamaSharp |
Een Aspire onderdeel dat gebruikmaakt van de Ollama-container met ondersteuning voor het downloaden van een model bij het opstarten. |
|
-
Meer informatie: 📄 Meilisearch hosting - Hosting: 📦 CommunityToolkit.Aspire.Hosting.Meilisearch - Client: 📦Aspire. CommunitToolkit.Meilisearch |
Een onderdeel Aspire dat gebruikmaakt van de Meilisearch-container . |
|
-
Meer informatie: 📄 Rust-hosting - Hosting: 📦 CommunityToolkit.Aspire. Hosting.Rust - Client: N.v.t. |
Een hostingintegratie voor Rust-apps. |
|
-
Meer informatie: 📄 SQL Database-projecten die als host fungeren voor - Hosting: 📦 CommunityToolkit.Aspire. Hosting.SqlDatabaseProjects - Client: N.v.t. |
Een Aspire hostingintegratie voor SQL Database Projects. |
Zie .NET.NET Aspire Community Toolkitvoor meer informatie.
