Panoramica delle integrazioni di Aspire

Le integrazioni di Aspire sono una suite curata di pacchetti NuGet selezionati per facilitare l'integrazione di applicazioni native al cloud con servizi e piattaforme importanti, ad esempio Redis e PostgreSQL. Ogni integrazione fornisce funzionalità essenziali nate per il cloud tramite provisioning automatico o modelli di configurazione standardizzati.

Responsabilità di integrazione

La maggior parte delle Aspire integrazioni è costituita da due librerie separate, ognuna con una responsabilità diversa. Un tipo rappresenta le risorse all'interno del progetto AppHost , note come integrazioni di hosting. L'altro tipo di integrazione rappresenta le librerie client che si connettono alle risorse modellate dalle integrazioni di hosting e vengono definite integrazioni client .

Integrazioni di hosting

Le integrazioni di hosting configurano le applicazioni effettuando il provisioning di risorse (ad esempio contenitori o risorse cloud) o puntando a istanze esistenti, ad esempio un'istanza locale di SQL Server. Questi pacchetti modellano vari servizi, piattaforme o funzionalità, tra cui cache, database, registrazione, archiviazione e sistemi di messaggistica.

Le integrazioni di hosting estendono l'interfaccia IDistributedApplicationBuilder , consentendo al progetto AppHost di esprimere le risorse all'interno del modello di app. Le integrazioni di hosting funzionano con qualsiasi tipo di applicazione, non solo .NET con le applicazioni. Forniscono informazioni sull'infrastruttura e inseriscono i dettagli di configurazione, ad esempio stringhe di connessione, endpoint e credenziali, come variabili di ambiente in qualsiasi progetto, eseguibile o contenitore che vi fa riferimento.

I pacchetti NuGet ufficiali di integrazione dell'hosting sono contrassegnati con , aspire, e integration. Oltre alle integrazioni di hosting ufficiali, la community ha creato integrazioni di hosting per vari servizi e piattaforme come parte di Community Toolkit.

Per informazioni sulla creazione di un'integrazione di hosting personalizzata, vedere Creare un'integrazione dell'hosting personalizzataAspire.

integrazioni Client

Client le integrazioni collegano le librerie client a inserimento delle dipendenze (DI), definiscono lo schema di configurazione e aggiungono controlli di integrità , resilienzae telemetria, se applicabile. Aspire Le librerie di integrazione client hanno il prefisso Aspire. e quindi includono il nome completo del pacchetto con cui si integrano, ad esempio Aspire.StackExchange.Redis.

Questi pacchetti configurano le librerie client esistenti per connettersi alle integrazioni di hosting. Estendono l'interfaccia IHostApplicationBuilder consentendo ai progetti che utilizzano client, ad esempio l'app Web o l'API, di usare la risorsa connessa. I pacchetti NuGet ufficiali di integrazione client sono contrassegnati con aspire, integratione client. Oltre alle integrazioni client ufficiali, la community ha creato integrazioni client per vari servizi e piattaforme come parte di Community Toolkit.

Per altre informazioni sulla creazione di un'integrazione client personalizzata, vedere Creare integrazioni client personalizzateAspire.

Relazione tra l'hosting e le integrazioni client

L'hosting e le integrazioni client sono ottimali quando vengono usate insieme, ma non sono collegate e possono essere usate separatamente. Alcune integrazioni di hosting non hanno un'integrazione client corrispondente. La configurazione è ciò che rende l'integrazione dell'hosting funzionante con l'integrazione client.

Client le integrazioni sono .NETspecifiche e offrono approcci pratici e predefiniti per configurare .NET le applicazioni. Tuttavia, è possibile usare integrazioni di hosting senza integrazioni client per.NET applicazioni non o quando si preferisce configurare le connessioni manualmente. In questi scenari, l'integrazione dell'hosting fornisce ancora l'infrastruttura ed espone le informazioni di connessione tramite variabili di ambiente utilizzabili da qualsiasi tecnologia applicativa.

Si consideri il diagramma seguente che illustra la relazione tra l'hosting e le integrazioni client:

Il progetto AppHost è la posizione in cui vengono usate le integrazioni di hosting. La configurazione, in particolare le variabili di ambiente, viene inserita in progetti, eseguibili e contenitori, consentendo alle integrazioni client di connettersi alle integrazioni host.

Funzionalità di integrazione

Quando si aggiunge un'integrazione client a un progetto all'interno della Aspire soluzione, le impostazioni predefinite del servizio vengono applicate automaticamente a tale progetto, ovvero viene fatto riferimento al progetto Service Defaults e viene chiamato il AddServiceDefaults metodo di estensione. Queste impostazioni predefinite sono progettate per funzionare correttamente nella maggior parte degli scenari e possono essere personalizzate in base alle esigenze. Vengono applicate le seguenti impostazioni predefinite del servizio:

• Osservabilità e telemetria: configura automaticamente il logging, il tracing e le metriche:

  • log: tecnica in cui il codice viene strumentato per produrre log di eventi interessanti che si sono verificati durante l'esecuzione del programma.
  • Tracciamento: una forma specializzata di tracciamento che aiuta a localizzare errori e problemi di prestazioni all'interno delle applicazioni distribuite su più macchine o processi.
  • Metriche: misurazioni numeriche registrate nel tempo per monitorare le prestazioni e lo stato dell'applicazione. Le metriche vengono spesso usate per generare avvisi quando vengono rilevati potenziali problemi.

• controlli di integrità: espone gli endpoint HTTP per fornire informazioni di base sulla disponibilità e sullo stato di un'app. I controlli di integrità vengono usati per influenzare le decisioni prese da agenti di orchestrazione dei contenitori, servizi di bilanciamento del carico, gateway API e altri servizi di gestione.

• resilienza: capacità del sistema di reagire agli errori e rimanere funzionanti. La resilienza va oltre la semplice prevenzione degli errori, includendo anche il ripristino e la ricostruzione dell'ambiente cloud-native per riportarlo a uno stato integro.

Comprendere i metodi di estensione dell'integrazione host

Aspire le integrazioni di hosting forniscono metodi di estensione che iniziano con Add o With. Questi metodi sono conformi al modello seguente:

• Add* metodi: Add* i metodi creano e registrano nuove risorse all'interno di AppHost e restituiscono un oggetto IResourceBuilder<TResource> in cui TResource è il tipo di risorsa concreto aggiunto. In questo modo è possibile continuare la configurazione fluente nel generatore restituito. Ad esempio, la chiamata di AddAzureServiceBus restituisce un IResourceBuilder<AzureServiceBusResource>, e quindi la chiamata di AddServiceBusQueue su tale generatore di spazi dei nomi restituisce un IResourceBuilder<AzureServiceBusQueueResource>. Questo modello modella le relazioni padre-figlio,ad esempio uno spazio dei nomi del bus di servizio e le relative code o argomenti, mantenendo al tempo stesso un'API fluent builder coerente.
• With* metodi: usare With* metodi per configurare o migliorare una risorsa esistente. Questi metodi restituiscono in genere lo stesso tipo di oggetto dell'elemento padre, consentendo di concatenare chiamate di configurazione aggiuntive.

Si consideri questo codice:

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

Si potrebbe prevedere che serviceBus rappresenti la risorsa Azure Service Bus, ma in realtà, siccome è stata chiamata AddServiceBusTopic sulla stessa riga, serviceBus è una risorsa di argomento Azure Service Bus. Per evitare questo risultato, chiamare AddServiceBusTopic su una riga separata:

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

È ora possibile scegliere di passare la risorsa di cui il progetto consumatore ha bisogno. O la risorsa del Service Bus o quella dell'argomento, come nell'esempio.

Questa distinzione consente di modellare l'infrastruttura dell'applicazione in modo accurato e di garantire che le integrazioni client ricevano le informazioni di connessione corrette.

Considerazioni sul controllo delle versioni

Le integrazioni di hosting e client vengono aggiornate ogni versione in modo che siano destinate alle versioni stabili più recenti delle risorse dipendenti. Quando le immagini del contenitore vengono aggiornate con nuove versioni dell'immagine, le integrazioni di hosting vengono aggiornate a queste nuove versioni. Analogamente, quando è disponibile una nuova versione di NuGet per una libreria client dipendente, l'integrazione client corrispondente viene aggiornata alla nuova versione. Ciò garantisce che le funzionalità e gli aggiornamenti della sicurezza più recenti siano disponibili per le applicazioni. Il Aspire tipo di aggiornamento (principale, secondario, patch) non indica necessariamente il tipo di aggiornamento nelle risorse dipendenti. Ad esempio, una nuova versione principale di una risorsa dipendente può essere aggiornata in una Aspire versione patch, se necessario.

Quando si verificano modifiche di rilievo importanti nelle risorse dipendenti, le integrazioni possono essere suddivise temporaneamente in pacchetti dipendenti dalla versione per facilitare l'aggiornamento durante la modifica che causa un'interruzione. Per altre informazioni, vedere il primo esempio di un tale cambiamento significativo.

Integrazioni ufficiali

Aspire offre molte integrazioni che consentono di creare applicazioni native del cloud. Queste integrazioni sono progettate per funzionare perfettamente con le Aspire librerie AppHost e client. Le sezioni seguenti illustrano in dettaglio le integrazioni indipendenti dal cloud, specifiche per Azure, Amazon Web Services (AWS) e Community Toolkit.

Integrazioni indipendenti dal cloud

La sezione seguente illustra in dettaglio le integrazioni indipendenti dal Aspire cloud con collegamenti ai rispettivi pacchetti NuGet e docs e fornisce una breve descrizione di ogni integrazione.

Per altre informazioni sull'uso delle integrazioni di Aspire in Visual Studio, vedere strumenti Visual Studio.

integrazioni Azure

Le integrazioni Azure configurano le applicazioni per utilizzare le risorse Azure. Queste integrazioni di hosting sono disponibili nei pacchetti NuGet Aspire.Hosting.Azure.*, mentre le integrazioni client sono disponibili nei pacchetti NuGet Aspire.*:

Integrazione	Documentazione e pacchetti NuGet	Descrizione
	- Per saperne di più: 📄Azure Configurazione App - Hosting: 📦Aspire. Hosting.Azure. AppConfiguration - Client: N/D	Libreria per interagire con Azure Configurazione App.
	- Altre informazioni: 📄Azure Servizio app - Hosting: 📦Aspire. Hosting.Azure. AppService - Client: N/D	Libreria per l'hosting di applicazioni Web in Azure App Service.
	- Scopri di più: 📄 Azure Application Insights - Hosting: 📦Aspire. Hosting.Azure. ApplicationInsights - Client: N/D	Libreria per interagire con Azure Application Insights.
	- Scopri di più: 📄 Azure Cache for Redis - Hosting: 📦Aspire. Hosting.Azure.Redis - Client: 📦Aspire. StackExchange.Redis o 📦Aspire. StackExchange.Redis. DistributedCaching o 📦Aspire. StackExchange.Redis. OutputCaching	Libreria per l'accesso a Azure Cache for Redis.
	- Scopri di più: 📄Azure Cosmos DB - EF Core - Hosting: 📦Aspire. Hosting.Azure. CosmosDB - Client: 📦Aspire. Microsoft.EntityFrameworkCore.Cosmos	Una libreria per accedere ai database di AzureAzure Cosmos DB usando Entity Framework Core.
	- Scopri di più: 📄 Azure Cosmos DB - Hosting: 📦Aspire. Hosting.Azure. CosmosDB - Client: 📦Aspire. Microsoft.Azure. Cosmos	Libreria per l'accesso ai database Azure Cosmos DB.
	- Scopri di più: 📄 Azure Event Hubs - Hosting: 📦Aspire. Hosting.Azure. EventHubs - Client: 📦Aspire.Azure. Messaging.EventHubs	Libreria per l'accesso a Azure Event Hubs.
	- Scopri di più: 📄Azure Funzioni - Hosting: 📦Aspire.Hosting.Azure.Funzioni - Client: N/D	Libreria per l'integrazione con le funzioni Azure.
	- Scopri di più: 📄 Azure Key Vault - Hosting: 📦Aspire.Hosting.Azure. KeyVault - Client: 📦Aspire.Azure. Security.KeyVault	Libreria per l'accesso a Azure Key Vault.
	- Scopri di più: 📄Azure Approfondimenti operativi - Hosting: 📦Aspire. Hosting.Azure. OperationalInsights - Client: N/D	Libreria per interagire con Azure Approfondimenti Operativi.
	- Scopri di più: 📄 Azure AI OpenAI - Hosting: 📦Aspire. Hosting.Azure. Servizi cognitivi - Client: 📦Aspire.Azure. Intelligenza artificiale.OpenAI	Libreria per l'accesso alle funzionalità di Azure AI OpenAI o OpenAI.
	- Scopri di più: 📄 Azure PostgreSQL - Hosting: 📦Aspire. Hosting.Azure.PostgreSQL - Client: N/D	Libreria per l'interazione con Azure Database per PostgreSQL.
	- Scopri di più: 📄Azure Ricerca di Intelligenza Artificiale - Hosting: 📦Aspire.Hosting.Azure.Ricerca - Client: 📦Aspire.Azure. Cerca.Documenti	Libreria per l'accesso alla funzionalità di ricerca di intelligenza artificiale Azure.
	- Scopri di più: 📄 Azure Service Bus - Hosting: 📦Aspire.Hosting.Azure. ServiceBus - Client: 📦Aspire.Azure. Messaging.ServiceBus	Libreria per l'accesso a Azure Service Bus.
	- Scopri di più: 📄 Azure SignalR Service - Hosting: 📦Aspire. Hosting.Azure.SignalR - Client: Microsoft.Azure.SignalR	Libreria per l'accesso a Azure SignalR Service.
	- Scopri di più: 📄 Azure Blob Storage - Hosting: 📦Aspire.Hosting.Azure. Archiviazione - Client: 📦Aspire.Azure. Storage.Blobs	Libreria per l'accesso a Azure Blob Storage.
	- Scopri di più: 📄 Azure Storage Queues - Hosting: 📦Aspire.Hosting.Azure. Archiviazione - Client: 📦Aspire.Azure. Storage.Queues	Libreria per l'accesso a Azure Storage Queues.
	- Scopri di più: 📄 Azure Table Storage - Hosting: 📦Aspire.Hosting.Azure. Archiviazione - Client: 📦Aspire.Azure. Data.Tables	Una libreria per accedere al servizio Azure Table.
	- Scopri di più: 📄 Azure Web PubSub - Hosting: 📦Aspire.Hosting.Azure. WebPubSub - Client: 📦Aspire.Azure. Messaging.WebPubSub	Libreria per l'accesso al servizio Azure Web PubSub.

Integrazioni di hosting di Amazon Web Services (AWS)

Per ulteriori informazioni, vedere GitHub: Aspire. Libreria di Hosting AWS.

Kubernetes integrazioni di hosting

Integrazioni di Community Toolkit

Per altre informazioni, vedere Aspire Community Toolkit.