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 clientbibliotheken die verbinding maken met de resources die zijn gemodelleerd door hostingintegraties, en ze worden ook wel clientintegratiesgenoemd.
Hosting integraties
Hostingintegraties configureren toepassingen door resources (zoals containers of cloudresources) in te richten of door te verwijzen naar bestaande exemplaren (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 clientbibliotheken aan afhankelijkheidsinjectie (DI), het configuratieschema definiëren en statuscontroles toevoegen, tolerantieen telemetrie indien van toepassing.
.NET
.NET Aspire clientintegratiebibliotheken worden voorafgegaan door Aspire. en vervolgens de volledige pakketnaam opnemen waarmee ze zijn geïntegreerd, zoals Aspire.StackExchange.Redis.
Deze pakketten configureren bestaande clientbibliotheken om verbinding te maken met hostingintegraties. Ze breiden de IHostApplicationBuilder interface uit waarmee clientverbruikende projecten, zoals uw web-app of API, de verbonden resource kunnen gebruiken. De officiële NuGet-pakketten voor clientintegratie zijn gelabeld met aspire, integrationen client. Naast de officiële clientintegraties heeft de community clientintegraties gemaakt voor verschillende services en platforms als onderdeel van de Community Toolkit.
Zie Aangepaste .NET.NET Aspire clientintegraties makenvoor meer informatie over het maken van een aangepaste clientintegratie.
Relatie tussen hosting en clientintegraties
Hosting- en clientintegraties zijn het beste wanneer ze samen worden gebruikt, maar niet gekoppeld en kunnen afzonderlijk worden gebruikt. Sommige hostingintegraties hebben geen bijbehorende clientintegratie. Configuratie is wat ervoor zorgt dat de hostingintegratie werkt met de clientintegratie.
Bekijk het volgende diagram waarin de relatie tussen hosting en clientintegraties wordt weergegeven:
Het app-hostproject is waar hostingintegraties worden gebruikt. Configuratie, met name omgevingsvariabelen, wordt geïnjecteerd in projecten, uitvoerbare bestanden en containers, waardoor clientintegraties verbinding kunnen maken met de hostingintegraties.
Integratie functies
Wanneer u een clientintegratie toevoegt aan een project binnen uw .NET.NET Aspire oplossing, worden servicestandaard en automatisch toegepast op dat project; dit betekent dat er naar het servicestandaardproject 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.
Tolerantie: de mogelijkheid van uw systeem om te reageren op fouten 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.
Overwegingen voor versiebeheer
Hosting en clientintegraties worden elke release bijgewerkt om de nieuwste stabiele versies van afhankelijke resources te bereiken. Wanneer containerimages worden geüpdatet met nieuwe versies, worden de hostingsintegraties geüpdatet naar deze nieuwe versies. Wanneer een nieuwe NuGet-versie beschikbaar is voor een afhankelijke clientbibliotheek, wordt de bijbehorende clientintegratie bijgewerkt naar de nieuwe versie. Dit zorgt ervoor dat de nieuwste functies en beveiligingsupdates beschikbaar zijn voor toepassingen.
Wanneer belangrijke wijzigingen die fouten veroorzaken in afhankelijke resources plaatsvinden, kunnen integraties tijdelijk worden gesplitst in versieafhankelijke pakketten om het bijwerken van de wijziging die fouten veroorzaken te vereenvoudigen. Zie het eerste voorbeeld van een dergelijke belangrijke wijzigingvoor meer informatie.
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.NET Aspire app-host- en clientbibliotheken. 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 clientintegraties 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.v.t. |
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.v.t. |
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.
