Vue d’ensemble des intégrations .NET.NET Aspire

.NET Aspire intégrations sont une suite organisée de packages NuGet sélectionnés pour faciliter l’intégration d’applications natives cloud à des services et plateformes importants, tels que Redis et PostgreSQL. Chaque intégration fournit des fonctionnalités natives cloud essentielles via l’approvisionnement automatique ou les modèles de configuration standardisés.

Conseil

Essayez toujours d’utiliser la dernière version de .NET.NET Aspire intégrations pour tirer parti des dernières fonctionnalités, améliorations et mises à jour de sécurité.

Responsabilités d’intégration

La plupart des intégrations .NET.NET Aspire sont constituées de deux bibliothèques distinctes, chacune ayant une responsabilité différente. Un type représente des ressources au sein du projet de l'application hôte, connu sous le nom d' intégrations d’hébergement. L'autre type d'intégration concerne les bibliothèques clientes qui se connectent aux ressources modélisées par les intégrations d'hébergement, et elles sont appelées intégrations clientes.

Intégrations d’hébergement

L’hébergement d’intégrations configure des applications en approvisionnant des ressources (comme des conteneurs ou des ressources cloud) ou en pointant vers des instances existantes (par exemple, un serveur SQL local). Ces packages modélisent différents services, plateformes ou fonctionnalités, notamment les caches, les bases de données, la journalisation, le stockage et les systèmes de messagerie.

Les intégrations d’hébergement étendent l’interface IDistributedApplicationBuilder, ce qui permet à l’hôte d’application projet d’exprimer des ressources au sein de son modèle d’application . Les packages NuGet d'intégration d'hébergement officiels portent les étiquettes aspire, integrationet hosting. En plus des intégrations officielles d’hébergement, la communauté a créé des intégrations d’hébergement pour différents services et plateformes dans le cadre de Community Toolkit.

Pour plus d’informations sur la création d’un d’intégration d’hébergement personnalisé, consultez Créer un .NET.NET Aspire d’intégration d’hébergement personnalisé.

intégrations Client

Client intégrations relient les bibliothèques clientes à d’injection de dépendances, définissent le schéma de configuration et ajoutent des contrôles d’intégrité, résilienceet télémétrie le cas échéant. .NET .NET Aspire bibliothèques d'intégration de clients sont précédées de Aspire., puis incluent le nom complet du package avec lequel elles s’intègrent, par exemple Aspire.StackExchange.Redis.

Ces packages configurent les bibliothèques clientes existantes pour se connecter aux intégrations d’hébergement. Ils étendent l’interface IHostApplicationBuilder permettant aux projets consommant du client, tels que votre application web ou votre API, d’utiliser la ressource connectée. Les paquets NuGet d’intégration client officiels sont marqués par aspire, integrationet client. En plus des intégrations officielles des clients, la communauté a créé des intégrations clientes pour différents services et plateformes dans le cadre de Community Toolkit.

Pour plus d’informations sur la création d’une intégration de client personnalisée, consultez Créer des intégrations de clients .NET.NET Aspire personnalisées.

Relation entre l’hébergement et les intégrations clientes

Les intégrations d’hébergement et de client sont optimales lorsqu’elles sont utilisées ensemble, mais ne sont pas couplées et peuvent être utilisées séparément. Certaines intégrations d’hébergement n’ont pas d’intégration de client correspondante. La configuration est ce qui permet à l'intégration de l'hébergement de fonctionner avec l'intégration du client.

Considérez le diagramme suivant qui illustre la relation entre l’hébergement et les intégrations clientes :

Le projet hôte d’application est l’emplacement où les intégrations d’hébergement sont utilisées. La configuration, en particulier les variables d’environnement, est injectée dans des projets, des exécutables et des conteneurs, ce qui permet aux intégrations clientes de se connecter aux intégrations d’hébergement.

Fonctionnalités d’intégration

Lorsque vous ajoutez une intégration de client à un projet au sein de votre solution de .NET.NET Aspire, service par défaut sont automatiquement appliqués à ce projet ; ce qui signifie que le projet Service Defaults est référencé et que la méthode d’extension AddServiceDefaults est appelée. Ces valeurs par défaut sont conçues pour fonctionner correctement dans la plupart des scénarios et peuvent être personnalisées si nécessaire. Les valeurs par défaut du service suivantes sont appliquées :

• Observabilité et télémétrie: configure automatiquement la journalisation, le traçage et les métriques :

  • journalisation: technique où le code est instrumenté pour produire des journaux d’événements intéressants qui se sont produits pendant l’exécution du programme.
  • Tracing: Une forme spécialisée de suivi qui vous aide à localiser les défaillances et les problèmes de performance au sein d'applications réparties sur plusieurs machines ou processus.
  • Métriques: mesures numériques enregistrées au fil du temps pour surveiller les performances et l’intégrité des applications. Les métriques sont souvent utilisées pour générer des alertes lorsque des problèmes potentiels sont détectés.

• Contrôle d’intégrité: expose les points de terminaison HTTP pour fournir des informations de disponibilité et d’état de base sur une application. Les contrôles d’intégrité sont utilisés pour influencer les décisions prises par les orchestrateurs de conteneurs, les équilibreurs de charge, les passerelles d’API et d’autres services de gestion.

• résilience: capacité de votre système à réagir aux défaillances et à rester fonctionnel. La résilience s’étend au-delà de la prévention des défaillances pour inclure la récupération et la reconstruction de votre environnement natif cloud dans un état sain.

Considérations relatives au contrôle de version

Les intégrations d’hébergement et de client sont mises à jour chaque version pour cibler les dernières versions stables des ressources dépendantes. Lorsque des images conteneur sont mises à jour avec de nouvelles versions d’image, les intégrations d’hébergement sont mises à jour vers ces nouvelles versions. De même, lorsqu’une nouvelle version de NuGet est disponible pour une bibliothèque cliente dépendante, l’intégration du client correspondante est mise à jour vers la nouvelle version. Cela garantit que les dernières fonctionnalités et mises à jour de sécurité sont disponibles pour les applications.

Lorsque des modifications majeures perturbatrices se produisent dans des ressources dépendantes, les solutions d'intégration peuvent temporairement se fractionner en paquets dépendants de la version pour faciliter la mise à jour tout au long du changement perturbateur. Pour plus d’informations, consultez le premier exemple de modification majeure.

Intégrations officielles

.NET .NET Aspire fournit de nombreuses intégrations pour vous aider à créer des applications natives cloud. Ces intégrations sont conçues pour fonctionner en toute transparence avec l’hôte d’application .NET.NET Aspire et les bibliothèques clientes. Les sections suivantes détaillent les intégrations indépendantes du cloud, spécifiques à Azure, à Amazon Web Services (AWS) et à Community Toolkit.

Intégrations indépendantes du cloud

La section suivante détaille les intégrations .NET.NET Aspire indépendantes du cloud avec des liens vers leurs documents et packages NuGet respectifs, et fournit une brève description de chaque intégration.

Documents d’intégration et packages NuGet	Description
- En savoir plus: 📄 Apache Kafka - Hébergement: 📦Aspire. Hébergement.Kafka - Client: 📦Aspire. Confluent.Kafka	Bibliothèque permettant de produire et de consommer des messages à partir d’un répartiteur Apache Kafka.
- En savoir plus: 📄 Dapr - Hébergement : 📦AspireHébergement.Dapr - Client: N/A	Bibliothèque permettant de modéliser Dapr en tant que ressource .NET.NET Aspire.
- En savoir plus: 📄 Elasticsearch - Hébergement : 📦AspireHébergement.Elasticsearch - Client: 📦Aspire. Elastic.Clients.Elasticsearch	Bibliothèque permettant d’accéder aux bases de données Elasticsearch.
- En savoir plus: 📄 Keycloak - Hébergement : 📦AspireHébergement.Keycloak - Client: 📦Aspire.Keycloak. Authentification	Bibliothèque permettant d’accéder à l’authentification Keycloak.
- En savoir plus: 📄 Milvus - Hébergement : 📦AspireHébergement.Milvus - Client: 📦Aspire.Milvus.Client	Bibliothèque permettant d’accéder aux bases de données Milvus.
- En savoir plus: 📄MongoDB pilote - Hébergement : 📦AspireHébergement.MongoDB - Client: 📦Aspire.MongoDB. Pilote	Bibliothèque permettant d’accéder aux bases de données MongoDB.
- En savoir plus: 📄 MySqlConnector - Hosting: 📦Aspire.Hosting.MySql - Client: 📦Aspire. MySqlConnector	Bibliothèque permettant d’accéder aux bases de données MySqlConnector.
- En savoir plus: 📄 NATS - d’hébergement : 📦Aspire. Hébergement.Nats - Client: 📦Aspire.NATS.Net	Bibliothèque permettant d’accéder à la messagerie NATS.
- En savoir plus: 📄Oracle - EF Core - Hébergement : 📦AspireHébergement.Oracle - Client: 📦Aspire.Oracle. EntityFrameworkCore	Bibliothèque permettant d’accéder aux bases de données Oracle avec Entity Framework Core.
- En savoir plus: 📄 Orleans - Hébergement : 📦AspireHébergement.Orleans - Client: N/A	Bibliothèque permettant de modéliser Orleans en tant que ressource .NET.NET Aspire.
- En savoir plus: 📄 Pomelo MySQL - EF Core - Hosting: 📦Aspire.Hosting.MySql - Client: 📦Aspire.Pomelo.EntityFrameworkCore.MySql	Bibliothèque permettant d’accéder aux bases de données MySql avec Entity Framework Core.
- En savoir plus: 📄PostgreSQL - EF Core - Hébergement : 📦AspireHébergement.PostgreSQL - Client: 📦Aspire. Npgsql.EntityFrameworkCore.PostgreSQL	Bibliothèque permettant d’accéder aux bases de données PostgreSQL à l’aide de Entity Framework Core.
- En savoir plus: 📄 PostgreSQL - Hébergement : 📦AspireHébergement.PostgreSQL - Client: 📦Aspire. Npgsql	Bibliothèque permettant d’accéder aux bases de données PostgreSQL.
- En savoir plus: 📄 Qdrant - Hébergement: 📦Aspire.Hébergement.Qdrant - Client: 📦Aspire. Qdrant.Client	Bibliothèque permettant d’accéder aux bases de données Qdrant.
- En savoir plus: 📄 RabbitMQ - Hébergement : 📦AspireHébergement.RabbitMQ - Client: 📦Aspire.RabbitMQ.Client	Bibliothèque permettant d’accéder à RabbitMQ.
- En savoir plus: 📄Redis Mise en cache distribuée - Hébergement: 📦Aspire. Hébergement.Redis, 📦Aspire. Hébergement.Garnetou 📦Aspire. Hébergement.Valkey - Client: 📦Aspire.StackExchange.Redis.MiseEnCacheDistribuée	Bibliothèque permettant d’accéder aux caches Redis pour mise en cache distribuée.
- En savoir plus: 📄Redis mise en cache de sortie - Hébergement: 📦Aspire. Hébergement.Redis, 📦Aspire. Hébergement.Garnetou 📦Aspire. Hébergement.Valkey - Client: 📦Aspire. StackExchange.Redis. OutputCaching	Bibliothèque pour accéder aux caches Redis dans le cadre de la mise en cache de sortie pour.
- En savoir plus: 📄 Redis - Hébergement: 📦Aspire. Hébergement.Redis, 📦Aspire. Hébergement.Garnetou 📦Aspire. Hébergement.Valkey - Client: 📦Aspire. StackExchange.Redis	Bibliothèque permettant d’accéder aux caches Redis.
- En savoir plus: 📄 Seq - Hébergement : 📦AspireHébergement.Seq - Client: 📦Aspire.Seq	Une bibliothèque pour l'enregistrement des logs vers Seq.
- En savoir plus: 📄SQL Server - EF Core - d’hébergement : 📦Aspire.Hébergement.SqlServer - Client: 📦Aspire. Microsoft.EntityFrameworkCore.SqlServer	Bibliothèque permettant d’accéder aux bases de données SQL Server à l’aide de EF Core.
- En savoir plus: 📄 SQL Server - d’hébergement : 📦Aspire.Hébergement.SqlServer - Client: 📦Aspire. Microsoft.Data.SqlClient	Bibliothèque permettant d’accéder aux bases de données SQL Server.

Pour plus d’informations sur l’utilisation des intégrations .NET Aspire dans Visual Studio, consultez les outils de pourVisual Studio.

intégrations Azure

Les intégrations Azure configurent des applications pour utiliser des ressources Azure. Ces intégrations d’hébergement sont disponibles dans les packages NuGet Aspire.Hosting.Azure.*, tandis que leurs intégrations clientes sont disponibles dans les packages NuGet Aspire.* :

Documents d’intégration et packages NuGet	Description
- En savoir plus: 📄Azure App Configuration - d’hébergement : 📦Aspire. Hébergement.Azure. AppConfiguration - Client: N/A	Bibliothèque permettant d’interagir avec Azure App Configuration.
- En savoir plus: 📄 Azure Application Insights - : Hébergement 📦Aspire. Hébergement.Azure. ApplicationInsights - Client: N/A	Bibliothèque permettant d’interagir avec Azure Application Insights.
- En savoir plus: 📄Azure Cosmos DB - EF Core - Hébergement: 📦Aspire. Hébergement.Azure. CosmosDB - Client: 📦Aspire. Microsoft.EntityFrameworkCore.Cosmos	Bibliothèque permettant d’accéder aux bases de données AzureAzure Cosmos DB avec Entity Framework Core.
- En savoir plus: 📄 Azure Cosmos DB - Hébergement: 📦Aspire. Hébergement.Azure. CosmosDB - Client: 📦Aspire. Microsoft.Azure. Cosmos	Bibliothèque permettant d’accéder aux bases de données Azure Cosmos DB.
- En savoir plus: 📄 Azure Event Hubs - Hébergement: 📦Aspire. Hébergement.Azure. EventHubs - Client: 📦Aspire.Azure. Messaging.EventHubs	Bibliothèque permettant d’accéder à Azure Event Hubs.
- En savoir plus: 📄Azure Functions - Hébergement: 📦Aspire. Hébergement.Azure. Fonctions - Client: N/A	Bibliothèque pour l’intégration à Azure Functions.
- En savoir plus: 📄 Azure Key Vault - d’hébergement : 📦Aspire. Hébergement.Azure. KeyVault - Client: 📦Aspire.Azure. Sécurité.VaultDeClés	Bibliothèque permettant d’accéder à Azure Key Vault.
- En savoir plus: 📄Azure Operational Insights - d’hébergement : 📦Aspire. Hébergement.Azure. OperationalInsights - Client: N/A	Bibliothèque permettant d’interagir avec Azure Operational Insights.
- En savoir plus: 📄 Azure AI OpenAI - Hébergement: 📦Aspire.Hosting.Azure.CognitiveServices - Client: 📦Aspire.Azure. IA.OpenAI	Bibliothèque permettant d’accéder à la fonctionnalité Azure AI OpenAI ou OpenAI.
- En savoir plus: 📄 Azure PostgreSQL - Hébergement : 📦Aspire.Hébergement.Azure.PostgreSQL - Client: N/A	Bibliothèque permettant d’interagir avec Azure Database pour PostgreSQL.
- En savoir plus: 📄Azure IA recherche - : 📦Aspire.Hébergement.Azure.Rechercher - Client: 📦Aspire.Azure. Search.Documents	Une bibliothèque permettant d’accéder à la fonctionnalité de recherche en IA Azure.
- En savoir plus: 📄 Azure Service Bus - d’hébergement : 📦Aspire.Hosting.Azure.ServiceBus - Client: 📦Aspire.Azure. Messaging.ServiceBus	Bibliothèque permettant d’accéder à Azure Service Bus.
- En savoir plus: 📄 Azure SignalR Service - Hébergement : 📦Aspire.Hébergement.Azure.SignalR - Client: Microsoft.Azure.SignalR	Bibliothèque permettant d’accéder à Azure SignalR Service.
- En savoir plus: 📄 Azure Blob Storage - d’hébergement : 📦Aspire.Hébergement.Azure. de stockage - Client: 📦Aspire.Azure. Storage.Blobs	Bibliothèque permettant d’accéder à Azure Blob Storage.
- En savoir plus: 📄 Azure Storage Queues - d’hébergement : 📦Aspire.Hébergement.Azure. de stockage - Client: 📦Aspire.Azure. Storage.Queues	Bibliothèque permettant d’accéder à Azure Storage Queues.
- En savoir plus: 📄 Azure Table Storage - d’hébergement : 📦Aspire.Hébergement.Azure. de stockage - Client: 📦Aspire.Azure. Data.Tables	Bibliothèque pour accéder au service Table Azure.
- En savoir plus: 📄Azure Web PubSub - d’hébergement : 📦Aspire. Hébergement.Azure. WebPubSub - Client: 📦Aspire.Azure. Messaging.WebPubSub	Bibliothèque pour accéder au service Azure Web PubSub.

Intégrations d’hébergement Amazon Web Services (AWS)

Documents d’intégration et packages NuGet	Description
- En savoir plus: Hébergement AWS📄 - Hébergement: 📦Aspire.Hosting.AWS - Client: N/A	Bibliothèque pour la modélisation ressources AWS.

Pour plus d'informations, consultez GitHub: Aspire. la bibliothèque Hosting.AWS.

Intégrations de Community Toolkit

Notes

Les intégrations community Toolkit sont pilotées par la communauté et gérées par la communauté .NET.NET Aspire. Ces intégrations ne sont pas officiellement prises en charge par l’équipe .NET.NET Aspire.

Documents d’intégration et packages NuGet	Description
- En savoir plus: 📄Azure émulateur Static Web Apps - d’hébergement : 📦 CommunityToolkit.Aspire.Hébergement.Azure. StaticWebApps - Client: N/A	Intégration d’hébergement pour l’émulateur Azure Static Web Apps (Remarque : cela ne prend pas en charge le déploiement d’un projet sur Azure Static Web Apps).
- En savoir plus: 📄 bun hébergement - Hosting: 📦 CommunityToolkit.Aspire.Hosting.Bun - Client: N/A	Intégration d’hébergement pour les applications Bun.
- En savoir plus: 📄Deno d’hébergement - Hébergement: 📦 CommunityToolkit.Aspire.Hosting.Deno - Client: N/A	Intégration d’hébergement pour les applications Deno.
- En savoir plus: 📄 Aller à l'hébergement - d’hébergement : 📦 CommunityToolkit.Aspire.Hosting.Golang - Client: N/A	Intégration d’hébergement pour les applications Go.
- En savoir plus: 📄 hébergement Java/Spring - d’hébergement : 📦 CommunityToolkit.Aspire. Hosting.Java - Client: N/A	Intégration de l’exécution de code Java dans .NET.NET Aspire à l’aide du JDK local ou d’un conteneur.
- En savoir plus: 📄Node.js des extensions d’hébergement - d’hébergement : 📦 CommunityToolkit.Aspire. Hosting.NodeJs.Extensions - Client: N/A	Intégration qui contient des extensions supplémentaires pour l’exécution d’applications Node.js
- En savoir plus: Ollama📄 - d’hébergement : 📦 CommunityToolkit.Aspire. Hosting.Ollama - Client: 📦Aspire.CommunitToolkit.OllamaSharp	Un composant Aspire exploitant le conteneur Ollama avec prise en charge du téléchargement d'un modèle au démarrage.
- En savoir plus: 📄 Meilisearch hébergeant - Hébergement: 📦 CommunityToolkit.Aspire.Hosting.Meilisearch - Client: 📦Aspire. CommunitToolkit.Meilisearch	Un composant Aspire exploitant le conteneur Meilisearch.
- En savoir plus: 📄 hébergement Rust - Hébergement: 📦 CommunityToolkit.Aspire.Hébergement.Rust - Client: N/A	Intégration d’hébergement pour les applications Rust.
- En savoir plus: 📄 projets SQL Database hébergeant - Hébergement: 📦 CommunityToolkit.Aspire.Hébergement.SqlDatabaseProjects - Client: N/A	Intégration d'hébergement pour projets de bases de données SQL Aspire.

Pour plus d’informations, consultez .NET.NET Aspire Community Toolkit.