Overzicht van Aspire-integraties

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.

Integratieverantwoordelijkheden

De meeste Aspire integraties bestaan uit twee afzonderlijke bibliotheken, elk met een andere verantwoordelijkheid. Eén type vertegenwoordigt resources in het AppHost-project , ook wel hostingintegraties genoemd. 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 het AppHost-project resources kan uitdrukken binnen het app-model. Hostingintegraties werken met elk type toepassing, niet alleen .NET toepassingen. Ze bieden infrastructuur en injecteren configuratiegegevens (zoals verbindingsreeksen, eindpunten en referenties) als omgevingsvariabelen in elk project, uitvoerbaar bestand of container die ernaar verwijzen.

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 Aangepaste hostingintegratie maken voor meer informatie over het maken van een aangepaste Aspire hostingintegratie.

Client-integraties

Client integraties koppelen clientbibliotheken aan afhankelijkheidsinjectie (DI), het configuratieschema definiëren en statuscontroles toevoegen, tolerantieen telemetrie indien van toepassing. Aspire clientintegratiebibliotheken worden voorafgegaan door Aspire. en bevatten vervolgens de volledige pakketnaam 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 clientintegraties maken voor meer informatie over het maken van een aangepaste Aspire 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.

Client integraties zijn .NET-specifiek en bieden handige en op meningen gebaseerde manieren om .NET toepassingen te configureren. U kunt echter hostingintegraties gebruiken zonder clientintegraties voor niet-toepassingen.NET of wanneer u verbindingen liever handmatig configureert. In deze scenario's biedt de hostingintegratie nog steeds de infrastructuur en maakt de verbindingsgegevens beschikbaar via omgevingsvariabelen die elke toepassingstechnologie kan gebruiken.

Bekijk het volgende diagram waarin de relatie tussen hosting en clientintegraties wordt weergegeven:

Het AppHost-project 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 aan een project in uw Aspire oplossing toevoegt, worden de standaardinstellingen van de service automatisch toegepast op dat project. Dit betekent dat er naar het project servicestandaarden 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.

Begrijp methoden voor hostintegratie-uitbreidingen

Aspire hosting-integraties bieden uitbreidingsmethoden die beginnen met ofwel Add, of With. Deze methoden voldoen aan het volgende patroon:

• Add* methoden: Add* methoden maken en registreren nieuwe resources binnen de AppHost en retourneren een IResourceBuilder<TResource>, waarbij TResource het concreet toegevoegde resourcetype is. Hiermee kunt u naadloze configuratie voortzetten op de geretourneerde bouwer. Als u bijvoorbeeld AddAzureServiceBus aanroept, wordt een IResourceBuilder<AzureServiceBusResource> geretourneerd, en als u vervolgens AddServiceBusQueue op die naamruimtebouwer aanroept, wordt een IResourceBuilder<AzureServiceBusQueueResource> geretourneerd. Dit patroon modelleert bovenliggende en onderliggende relaties (bijvoorbeeld een Service Bus-naamruimte en de bijbehorende wachtrijen of onderwerpen) met behoud van een consistente Fluent Builder-API.
• With* methoden: Gebruik With* methoden om een bestaande resource te configureren of te verbeteren. Deze methoden retourneren doorgaans hetzelfde objecttype als het ouderobject, zodat u aanvullende configuratie-aanroepen kunt ketenen.

Houd rekening met deze code:

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

U kunt verwachten dat serviceBus de Azure Service Bus resource vertegenwoordigt, maar omdat u AddServiceBusTopic op dezelfde regel hebt aangeroepen, is serviceBus een Azure Service Bus onderwerpresource. Plaats AddServiceBusTopic op een aparte regel om dit resultaat te voorkomen.

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

U kunt er nu voor kiezen om de resource aan te reiken die het project nodig heeft. Ofwel, zoals in het voorbeeld, de Service Bus-resource of de topicresource.

Dit onderscheid helpt u de infrastructuur van uw toepassing nauwkeurig te modelleren en ervoor te zorgen dat clientintegraties de juiste verbindingsgegevens ontvangen.

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. Het Aspire updatetype (groot, klein, patch) duiden niet per se het type update in afhankelijke bronnen aan. Zo nodig kan een nieuwe primaire versie van een afhankelijke resource worden bijgewerkt in een Aspire patchrelease.

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

Aspire biedt veel integraties om u te helpen bij het bouwen van cloudtoepassingen. Deze integraties zijn ontworpen om naadloos te werken met de Aspire AppHost- en clientbibliotheken. In de volgende secties worden cloudagnostische, Azure-specifieke, Amazon Web Services (AWS) en Community Toolkit-integraties beschreven.

Cloudagnostische integraties

De volgende sectie bevat informatie over cloudagnostische Aspire integraties met koppelingen naar hun respectieve documenten en NuGet-pakketten en biedt een korte beschrijving van elke integratie.

Voor meer informatie over werken met 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:

Integratie	Docs- en NuGet-pakketten	Beschrijving
	- Meer informatie: 📄Azure App Configuration- - Hosting: 📦Aspire. Hosting.Azure. AppConfiguration - Client: n.v.t.	Een bibliotheek om te communiceren met Azure App Configuration.
	- Meer informatie: 📄Azure App Service - Hosting: 📦Aspire. Hosting.Azure. AppService - Client: n.v.t.	Een bibliotheek voor het hosten van webtoepassingen in Azure App Service.
	- Meer informatie: 📄 Azure Application Insights - Hosting: 📦Aspire. Hosting.Azure. ApplicationInsights - Client: n.v.t.	Een bibliotheek voor interactie met Azure Application Insights.
	- Meer informatie: 📄 Azure Cache for Redis - Hosting: 📦Aspire. Hosting.Azure.Redis - Client: 📦Aspire. StackExchange.Redis of 📦Aspire. StackExchange.Redis. Gedistribueerdecaching- of 📦Aspire. StackExchange.Redis. OutputCaching-	Een bibliotheek voor toegang tot Azure Cache for Redis.
	- Meer informatie: 📄Azure Cosmos DB - EF Core - Hosting: 📦Aspire. Hosting.Azure. CosmosDB - Client: 📦Aspire. Microsoft.EntityFrameworkCore.Cosmos	Een bibliotheek voor toegang tot AzureAzure Cosmos DB databases met Entity Framework Core.
	- Meer informatie: 📄 Azure Cosmos DB - Hosting: 📦Aspire. Hosting.Azure. CosmosDB - Client: 📦Aspire. Microsoft.Azure. Cosmos	Een bibliotheek voor toegang tot Azure Cosmos DB databases.
	- Meer informatie: 📄 Azure Event Hubs - Hosting: 📦Aspire. Hosting.Azure. EventHubs - Client: 📦Aspire.Azure. Messaging.EventHubs	Een bibliotheek voor toegang tot Azure Event Hubs.
	- Meer informatie: 📄Azure Functies - Hosting: 📦Aspire.Hosting.Azure.Functies - Client: n.v.t.	Een bibliotheek voor integratie met Azure Functions.
	- Meer informatie: 📄 Azure Key Vault - Hosting: 📦Aspire. Hosting.Azure. KeyVault - Client: 📦Aspire.Azure. Security.KeyVault	Een bibliotheek voor toegang tot Azure Key Vault.
	- Meer informatie: 📄Azure Operational Insights- - Hosting: 📦Aspire. Hosting.Azure. OperationalInsights - Client: n.v.t.	Een bibliotheek voor interactie met Azure Operational Insights-.
	- Meer informatie: 📄 Azure AI OpenAI - Hosting: 📦Aspire. Hosting.Azure. CognitiveServices - Client: 📦Aspire.Azure. AI.OpenAI	Een bibliotheek voor toegang tot Azure AI OpenAI of OpenAI functionaliteit.
	- Meer informatie: 📄 Azure PostgreSQL - Hosting: 📦Aspire. Hosting.Azure.PostgreSQL - Client: n.v.t.	Een bibliotheek om te interageren met Azure database voor PostgreSQL.
	- Meer informatie: 📄Azure AI Search- - Hosting: 📦Aspire.Hosting.Azure. Zoeken - Client: 📦Aspire.Azure. Search.Documents	Een bibliotheek voor toegang tot Azure AI Search functionaliteit.
	- Meer informatie: 📄 Azure Service Bus - Hosting: 📦Aspire. Hosting.Azure. ServiceBus - Client: 📦Aspire.Azure. Messaging.ServiceBus	Een bibliotheek voor toegang tot Azure Service Bus.
	- Meer informatie: 📄 Azure SignalR Service - Hosting: 📦Aspire. Hosting.Azure.SignalR - Client: Microsoft.Azure.SignalR	Een bibliotheek voor toegang tot Azure SignalR Service.
	- Meer informatie: 📄 Azure Blob Storage - Hosting: 📦Aspire. Hosting.Azure. Opslag - Client: 📦Aspire.Azure. Storage.Blobs	Een bibliotheek voor toegang tot Azure Blob Storage.
	- Meer informatie: 📄 Azure Storage Queues - Hosting: 📦Aspire. Hosting.Azure. Opslag - Client: 📦Aspire.Azure. Storage.Queues	Een bibliotheek voor toegang tot Azure Storage Queues.
	- Meer informatie: 📄 Azure Table Storage - Hosting: 📦Aspire. Hosting.Azure. Opslag - Client: 📦Aspire.Azure. Data.Tables	Een bibliotheek voor toegang tot de Azure Tabel-service.
	- Meer informatie: 📄 Azure Web PubSub - Hosting: 📦Aspire.Hosting.Azure. WebPubSub - Client: 📦Aspire.Azure. Messaging.WebPubSub	Een bibliotheek voor toegang tot de Azure Web PubSub-service.

Amazon Web Services (AWS) hosting integraties

Zie GitHub: Aspirevoor meer informatie. Hosting.AWS-bibliotheek.

Kubernetes hostingintegraties

Community Toolkit-integraties

Zie Aspire Community Toolkit voor meer informatie.