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.
Pourboire
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 représente les bibliothèques client qui se connectent aux ressources modélisées par les intégrations d'hébergement, et elles sont appelées intégrations client.
Intégrations d’hébergement
L'intégration des services d'hébergement configure des applications en fournissant des ressources (comme des conteneurs ou des ressources cloud) ou en pointant vers des instances existantes (par exemple, un serverSQL 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
Aspire., puis incluent le nom complet du package auquel ils s’intègrent, par exemple Aspire.StackExchange.Redis.
Ces packages configurent les bibliothèques client existantes pour se connecter aux intégrations d’hébergement. Ils étendent l’interface IHostApplicationBuilder permettant aux projets clientconsommant, tels que votre application web ou votre API, d’utiliser la ressource connectée. Les packages NuGet d’intégration officiels client sont étiquetés avec aspire, integrationet client. En plus des intégrations officielles client, la communauté a créé des intégrations client 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 .NET Aspireclient personnalisées.
Relation entre l’hébergement et les intégrations de client
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 client correspondante. La configuration est ce qui permet à l’intégration d’hébergement de fonctionner avec l’intégration client.
Considérez le diagramme suivant qui illustre la relation entre l’hébergement et les intégrations client :
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 à client intégrations 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 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: la capacité de votre système à react en cas d'échec et reste toujours 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.
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 Aspire et les bibliothèques de client. 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 - d’hébergement : 📦Aspire. Hébergement.Elasticsearch - Client: 📦Aspire. Elastic.Clients.Elasticsearch |
Bibliothèque permettant d’accéder aux bases de données Elasticsearch. |
|
-
En savoir plus: 📄 Keycloak - d’hébergement : 📦Aspire. Hébergement.Keycloak - Client: 📦Aspire.Keycloak. Authentification |
Bibliothèque permettant d’accéder à l’authentification Keycloak. |
|
-
En savoir plus: 📄 Milvus - d’hébergement : 📦Aspire. Hébergement.Milvus - Client: 📦Aspire.Milvus.Client |
Bibliothèque permettant d’accéder aux bases de données Milvus. |
|
-
En savoir plus: 📄MongoDB pilote - d’hébergement : 📦Aspire. Hébergement.MongoDB - Client: 📦Aspire.MongoDB. Pilote |
Bibliothèque permettant d’accéder aux bases de données MongoDB. |
|
-
En savoir plus: 📄 MySqlConnector - d’hébergement : 📦Aspire.Hébergement.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 - d’hébergement : 📦Aspire. Hé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 - d’hébergement : 📦Aspire. Hé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 - d’hébergement : 📦Aspire. Hébergement.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 : 📦Aspire. Hé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 - d’hébergement : 📦Aspire. Hé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 - d'hébergement : 📦Aspire.Hé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 - Hosting: 📦Aspire.Hosting.Redis, 📦Aspire. Hosting.Garnetou 📦Aspire. Hosting.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 - d'hébergement : 📦Aspire.Hosting.Redis, 📦Aspire.Hosting.Garnetou 📦Aspire.Hosting.Valkey - Client: 📦Aspire. StackExchange.Redis |
Bibliothèque permettant d’accéder aux caches Redis. |
|
-
En savoir plus: 📄 Seq - Hébergement: 📦Aspire.Hé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.Hosting.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 client 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 - d’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 |
Une bibliothèque permettant l'accès à 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 - d’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 - Hébergement: 📦Aspire.Hébergement.Azure.Stockage - Client: 📦Aspire.Azure. Storage.Queues |
Bibliothèque permettant d’accéder à Azure Storage Queues. |
|
-
En savoir plus: 📄 Azure Table Storage - Hébergement : 📦Aspire. Hébergement.Azure. 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
Note
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.
