Panoramica delle integrazioni di .NET.NET Aspire

Le integrazioni di .NET 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 integrazioni .NET.NET Aspire è costituita da due librerie separate, ognuna con una responsabilità diversa. Un tipo rappresenta le risorse all'interno dell'app host del progetto, noto come integrazioni di hosting. L'altro tipo di integrazione rappresenta librerie client che si connettono alle risorse modellate dalle integrazioni ospitanti e sono conosciute come integrazioni client.

Integrazioni di hosting

Le integrazioni di hosting configurano le applicazioni fornendo risorse (ad esempio contenitori o risorse cloud) o puntando a istanze esistenti, ad esempio un'istanza di SQL locale 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 host dell'app di esprimere le risorse all'interno del modello di app . I pacchetti NuGet di integrazione dell'hosting ufficiali vengono contrassegnati con , e . 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 personalizzato di integrazione dell'hosting, vedere Creare .NET.NET Aspire'integrazione dell'hosting personalizzata.

integrazioni di Client

Client le integrazioni collegano librerie client a di inserimento delle dipendenze , definire lo schema di configurazione e aggiungere controlli di integrità , resilienzae telemetria, se applicabile. .NET Aspire client librerie di integrazione sono precedute da Aspire. e quindi includono il nome completo del pacchetto con cui si integrano, ad esempio Aspire.StackExchange.Redis.

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

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

Relazione tra l'hosting e le integrazioni di client

Le integrazioni di hosting e client sono ottimali se usate insieme, ma sono non accoppiate e possono essere usate separatamente. Alcune integrazioni di hosting non hanno un'integrazione client corrispondente. La configurazione è ciò che rende possibile l'integrazione dell'hosting funzionare con l'integrazione client.

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

Il progetto dell'app host è dove vengono utilizzate 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 ospitanti.

Funzionalità di integrazione

Quando si aggiunge un'integrazione a un progetto all'interno della soluzione , le impostazioni predefinite del servizio vengono applicate automaticamente a tale progetto; viene fatto riferimento al progetto Service Defaults e viene chiamato il 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: la capacità del sistema di react di non riuscire e rimanere funzionante. 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.

Integrazioni ufficiali

.NET .NET Aspire offre molte integrazioni che consentono di creare applicazioni native del cloud. Queste integrazioni sono progettate per funzionare perfettamente con l'host dell'app .NET Aspire e le librerie di 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 di .NET.NET Aspire indipendenti dal cloud con collegamenti ai rispettivi pacchetti Docs e NuGet e fornisce una breve descrizione di ogni integrazione.

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

integrazioni di 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 di client sono disponibili nei pacchetti NuGet Aspire.*:

Integrazioni di hosting di Amazon Web Services (AWS)

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

Integrazioni di Community Toolkit

Per altre informazioni, vedere .NET.NET Aspire Community Toolkit.