översikt över Aspire integreringar

Aspire integreringar är en kuraterad uppsättning NuGet-paket som valts för att underlätta integreringen av molnbaserade program med framstående tjänster och plattformar, till exempel Redis och PostgreSQL. Varje integrering tillhandahåller viktiga molnbaserade funktioner genom antingen automatisk etablering eller standardiserade konfigurationsmönster.

Integrationsansvar

De flesta Aspire integreringar består av två separata bibliotek, var och en med olika ansvar. En typ representerar resurser i AppHost-projektet , som kallas värdintegrering. Den andra typen av integrering representerar klientbibliotek som ansluter till de resurser som modelleras av hosting-integreringar, och som kallas klientintegreringar.

Värdtjänster för integrationer

Värdintegrationer konfigurerar applikationer genom att etablera resurser (till exempel containrar eller molnresurser) eller peka på befintliga instanser (till exempel en lokal SQL-server). Dessa paket modellerar olika tjänster, plattformar eller funktioner, inklusive cacheminnen, databaser, loggning, lagring och meddelandesystem.

Värdintegreringar utökar IDistributedApplicationBuilder gränssnittet, vilket gör det möjligt för AppHost-projektet att uttrycka resurser i sin appmodell. Värdintegreringar fungerar med alla typer av program, inte bara .NET program. De tillhandahåller infrastruktur och inmatar konfigurationsinformation (till exempel anslutningssträngar, slutpunkter och autentiseringsuppgifter) som miljövariabler i alla projekt, körbara filer eller containrar som refererar till dem.

De officiella värdintegrerings-NuGet-paketen är taggade med aspire, integration och hosting. Förutom de officiella värdintegreringarna har community skapat värdintegreringar för olika tjänster och plattformar som en del av Community Toolkit.

Information om hur du skapar en anpassad värdintegrering finns i Skapa anpassad Aspire värdintegrering.

Client integreringar

Client integreringar kopplar klientbibliotek till beroendeinjektion (DI), definierar konfigurationsschema och lägger till hälsokontroller, resiliensoch telemetri där det är tillämpligt. Aspire klientintegrationsbiblioteken prefixas med Aspire. och inkluderar sedan det fullständiga paketnamnet som de är integrerade med, till exempel Aspire.StackExchange.Redis.

Dessa paket konfigurerar befintliga klientbibliotek för att ansluta till värdintegreringar. De utökar IHostApplicationBuilder-gränssnittet så att klientanvändande projekt, till exempel webbappen eller API:et, kan använda den anslutna resursen. De officiella NuGet-paketen för -klientintegrering är märkta med aspire, integrationoch client. Förutom de officiella klientintegreringarna har community skapat klientintegreringar för olika tjänster och plattformar som en del av Community Toolkit.

Mer information om hur du skapar en anpassad klientintegrering finns i Skapa anpassade Aspire klientintegreringar.

Relation mellan värd- och klientintegreringar

Värd- och klientintegreringar är bäst när de används tillsammans, men är inte kopplade och kan användas separat. Vissa värdintegreringar har inte någon motsvarande klientintegrering. Konfigurationen gör att värdintegreringen fungerar med klientintegreringen.

Client integreringar är .NET-specifika och ger praktiska, åsiktsbaserade sätt att konfigurera .NET program. Du kan dock använda värdintegreringar utan klientintegreringar för icke-program.NET eller när du föredrar att konfigurera anslutningar manuellt. I dessa scenarier tillhandahåller värdintegrering fortfarande infrastrukturen och exponerar anslutningsinformation via miljövariabler som alla programteknik kan använda.

Tänk på följande diagram som visar relationen mellan värd- och klientintegreringar:

AppHost-projektet används som värd för integreringar. Konfiguration, särskilt miljövariabler, matas in i projekt, körbara filer och containrar, vilket gör att klientintegreringar kan ansluta till värdintegreringarna.

Integreringsfunktioner

När du lägger till en klientintegrering i ett projekt i din Aspire lösning tillämpas tjänstens standardinställningar automatiskt på projektet, vilket innebär att servicestandardprojektet refereras till och AddServiceDefaults tilläggsmetoden anropas. Dessa standardvärden är utformade för att fungera bra i de flesta scenarier och kan anpassas efter behov. Följande tjänstinställningar tillämpas:

• Observability and telemetry: Konfigurerar automatiskt konfigurationer för loggning, spårning och mått:

  • Loggning: En teknik där kod instrumenteras för att skapa loggar med intressanta händelser som inträffade när programmet kördes.
  • Spårning: En särskild typ av loggning som hjälper dig att lokalisera fel och prestandaproblem i program som distribueras över flera datorer eller processer.
  • Mått: Numeriska mätningar som registrerats över tid för att övervaka programmets prestanda och hälsa. Mått används ofta för att generera aviseringar när potentiella problem identifieras.

• Hälsokontroller: Exponerar HTTP-slutpunkter för att tillhandahålla grundläggande tillgänglighets- och tillståndsinformation om en app. Hälsokontroller används för att påverka beslut som fattas av containerorkestrerare, lastbalanserare, API-gatewayer och andra hanteringstjänster.

• Återhämtning: Systemets förmåga att reagera på fel och fortfarande fungera. Resiliens sträcker sig bortom att förhindra fel till att inkludera återställning och rekonstruktion av din molnnativa miljö till ett hälsosamt tillstånd.

Förstå metoder för värdintegreringstillägg

Aspire värdintegreringar tillhandahåller tilläggsmetoder som börjar med antingen Add eller With. Dessa metoder följer följande mönster:

• Add* metoder: Add* metoder skapar och registrerar nya resurser i AppHost och returnerar en IResourceBuilder<TResource> var TResource är den konkreta resurstypen som lagts till. På så sätt kan du fortsätta med smidig konfiguration på den returnerade byggaren. Anrop av AddAzureServiceBus returnerar till exempel en IResourceBuilder<AzureServiceBusResource>, och att anropa AddServiceBusQueue på denna namespace builder returnerar en IResourceBuilder<AzureServiceBusQueueResource>. Det här mönstret modellerar föräldra-barn-relationer (som ett Service Bus-namnområde och dess köer eller ämnen) samtidigt som det bevarar ett konsekvent fluent builder API.
• With* metoder: Använd With* metoder för att konfigurera eller förbättra en befintlig resurs. Dessa metoder returnerar vanligtvis samma objekttyp som föräldern, vilket gör att du kan kedja ytterligare konfigurationsanrop.

Tänk på den här koden:

var serviceBus = builder.AddAzureServiceBus(name: "serviceBus")
    .AddServiceBusTopic(name: "messagetopic");

var apiService = builder.AddProject<Projects.servicebusexp_ApiService>("apiservice")
    .WithHttpHealthCheck("/health")
    .WithReference(serviceBus);

// The serviceBus is an IResourceBuilder<AzureServiceBusTopicResource> type

Du kan förvänta dig att serviceBus representerar resursen Azure Service Bus, men eftersom du anropade AddServiceBusTopic på samma rad, är serviceBus faktiskt en Azure Service Bus ämnesresurs. Undvik det här resultatet genom att anropa AddServiceBusTopic på en separat rad:

var serviceBus = builder.AddAzureServiceBus(name: "serviceBus");
var topic = serviceBus.AddServiceBusTopic(name: "messagetopic");

var apiService = builder.AddProject<Projects.servicebusexp_ApiService>("apiservice")
    .WithHttpHealthCheck("/health")
    .WithReference(serviceBus);

// The serviceBus is an IResourceBuilder<AzureServiceBusResource> type

Nu kan du välja att ge den resurs som projektet behöver använda. Antingen, som i exemplet, Service Bus-resursen eller ämnesresursen.

Den här skillnaden hjälper dig att modellera programmets infrastruktur korrekt och ser till att klientintegreringar får rätt anslutningsinformation.

Överväganden för versionshantering

Värd- och klientintegreringar uppdateras varje version för att rikta in sig på de senaste stabila versionerna av beroende resurser. När containeravbildningar uppdateras med nya avbildningsversioner uppdateras värdintegreringarna till dessa nya versioner. På samma sätt, när en ny NuGet-version är tillgänglig för ett beroende klientbibliotek, uppdateras motsvarande klientintegrering till den nya versionen. Detta säkerställer att de senaste funktionerna och säkerhetsuppdateringarna är tillgängliga för program. Uppdateringstypen Aspire (större, mindre, korrigering) anger inte nödvändigtvis typen av uppdatering i beroende resurser. En ny huvudversion av en beroende resurs kan till exempel uppdateras i en Aspire korrigeringsversion om det behövs.

När stora väsentliga ändringar sker i beroende resurser kan integreringar tillfälligt delas upp i versionsberoende paket för att underlätta uppdateringar genom den väsentliga ändringen. För mer information, se första exemplet på en sådan störande ändring.

Officiella integreringar

Aspire innehåller många integreringar som hjälper dig att skapa molnbaserade program. Dessa integreringar är utformade för att fungera sömlöst med Aspire AppHost- och klientbiblioteken. I följande avsnitt beskrivs molnagnostiska, Azure-specific, Amazon Web Services (AWS) och Community Toolkit-integreringar.

Molnagnostiska integrationer

I följande avsnitt beskrivs molnagnostiska Aspire integreringar med länkar till respektive dokument och NuGet-paket och innehåller en kort beskrivning av varje integrering.

Mer information om hur du arbetar med Aspire-integreringar i Visual Studiofinns i Visual Studio verktyg.

Azure integreringar

Azure-integreringar konfigurerar program att använda Azure resurser. Dessa värdintegreringar är tillgängliga i Aspire.Hosting.Azure.* NuGet-paket, medan deras klientintegreringar är tillgängliga i Aspire.* NuGet-paket:

Integration	Docs- och NuGet-paket	Beskrivning
	- Läs mer: 📄Azure Appkonfiguration - Hosting: 📦Aspire. Hosting.Azure. AppConfiguration - Client: N/A	Ett bibliotek för att interagera med Azure App Configuration.
	- Läs mer: 📄Azure App Service - Hosting: 📦Aspire.Hosting.Azure.AppService - Client: N/A	Ett bibliotek för att vara värd för webbprogram i Azure App Service.
	- Läs mer: 📄 Azure Application Insights - Hosting: 📦Aspire. Värdtjänst.Azure. ApplicationInsights - Client: N/A	Ett bibliotek för att interagera med Azure Application Insights.
	- Läs mer: 📄 Azure Cache for Redis - Hosting: 📦Aspire. Hosting.Azure.Redis - Client: 📦Aspire. StackExchange.Redis eller 📦Aspire. StackExchange.Redis. DistributedCaching eller 📦Aspire. StackExchange.Redis. OutputCaching	Ett bibliotek för att komma åt Azure Cache for Redis.
	- Läs mer: 📄Azure Cosmos DB – EF Core - Hosting: 📦Aspire.Hosting.Azure. CosmosDB - Client: 📦Aspire. Microsoft.EntityFrameworkCore.Cosmos	Ett bibliotek för åtkomst till AzureAzure Cosmos DB databaser med Entity Framework Core.
	- Läs mer: 📄 Azure Cosmos DB - Hosting: 📦Aspire.Hosting.Azure. CosmosDB - Client: 📦Aspire. Microsoft.Azure. Cosmos	Ett bibliotek för åtkomst till Azure Cosmos DB databaser.
	- Läs mer: 📄 Azure Event Hubs - Hosting: 📦Aspire.Hosting.Azure. EventHubs - Client: 📦Aspire.Azure. Messaging.EventHubs	Ett bibliotek för att komma åt Azure Event Hubs.
	- Läs mer: 📄Azure Funktioner - Hosting: 📦Aspire.Hosting.Azure. Funktioner - Client: N/A	Ett bibliotek för att integrera med Azure Functions.
	- Läs mer: 📄 Azure Key Vault - Hosting: 📦Aspire. Hosting.Azure. KeyVault - Client: 📦Aspire.Azure. Security.KeyVault	Ett bibliotek för att komma åt Azure Key Vault.
	- Läs mer: 📄Azure Operational Insights - Värd: 📦Aspire. Hosting.Azure. OperationalInsights - Client: N/A	Ett bibliotek för att interagera med Azure Operational Insights.
	- Läs mer: 📄 Azure AI OpenAI - Värd: 📦Aspire. Hosting.Azure. CognitiveServices - Client: 📦Aspire.Azure. Artificiell intelligens.OpenAI	Ett bibliotek för åtkomst till Azure AI OpenAI eller OpenAI funktioner.
	- Läs mer: 📄 Azure PostgreSQL - Hosting: 📦Aspire. Hosting.Azure.PostgreSQL - Client: N/A	Ett bibliotek för att interagera med Azure Databas för PostgreSQL.
	- Läs mer: 📄Azure AI Search - Hosting: 📦Aspire. Hosting.Azure. Sök - Client: 📦Aspire.Azure. Sök.Dokument	Ett bibliotek för åtkomst till Azure AI-sökfunktionalitet.
	- Läs mer: 📄 Azure Service Bus - Hosting: 📦Aspire. Hosting.Azure. ServiceBus - Client: 📦Aspire.Azure. Messaging.ServiceBus	Ett bibliotek för att komma åt Azure Service Bus.
	- Läs mer: 📄 Azure SignalR Service - Hosting: 📦Aspire. Hosting.Azure.SignalR - Client: Microsoft.Azure.SignalR	Ett bibliotek för att komma åt Azure SignalR Service.
	- Läs mer: 📄 Azure Blob Storage - Hosting: 📦Aspire. Gästfrihet.Azure. Lagring - Client: 📦Aspire.Azure. Storage.Blobs	Ett bibliotek för att komma åt Azure Blob Storage.
	- Läs mer: 📄 Azure Storage Queues - Hosting: 📦Aspire. Gästfrihet.Azure. Lagring - Client: 📦Aspire.Azure. Storage.Queues	Ett bibliotek för att komma åt Azure Storage Queues.
	- Läs mer: 📄 Azure Table Storage - Hosting: 📦Aspire. Gästfrihet.Azure. Lagring - Client: 📦Aspire.Azure. Data.Tables	Ett bibliotek för åtkomst till Azure Table-tjänsten.
	- Läs mer: 📄 Azure Web PubSub - Hosting: 📦Aspire. Hosting.Azure. WebPubSub - Client: 📦Aspire.Azure. Messaging.WebPubSub	Ett bibliotek för åtkomst till Azure Web PubSub-tjänsten.

Amazon Web Services (AWS) värdintegrationer

Mer information finns i GitHub: Aspire. Hosting.AWS-bibliotek.

Kubernetes värd för integreringar

Community Toolkit-integreringar

Mer information finns i Aspire Community Toolkit.