Partager via

Tutoriel : Déployer un projet .NET Aspire avec un cache Redis sur Azure

  • Article

Dans ce tutoriel, vous allez apprendre à configurer un projet .NET Aspire avec un cache Redis pour le déploiement sur Azure. .NET Aspire fournit plusieurs configurations d’intégration de mise en cache qui approvisionnent différents services Redis dans Azure. Vous allez apprendre à :

  • Configurer l’appli pour approvisionner un AzureAzure Cache for Redis
  • Configurer l’application pour approvisionner un cache de Redis conteneurisé

Note

Ce document se concentre spécifiquement sur les configurations de .NET Aspire pour approvisionner et déployer des ressources cache Redis dans Azure. Pour plus d’informations et pour en savoir plus sur le processus de déploiement complet .NET.NET Aspire, consultez le didacticiel Azure Container Apps déploiement.

Conditions préalables

Pour utiliser .NET.NET Aspire, vous avez besoin de l’installation locale suivante :

Pour plus d’informations, consultez la configuration et les outils .NET.NET Aspire, et le SDK .NET.NET Aspire.

Créer l’exemple de solution

Suivez le didacticiel : Implémenter la mise en cache avec .NET.NET Aspire intégrations pour créer l’exemple de projet.

Configurer l’application pour le déploiement du cache Redis

.NET Aspire fournit deux options de configuration intégrées pour simplifier le déploiement du cache Redis sur Azure:

  • Approvisionner un cache de Redis conteneurisé à l’aide de Azure Container Apps
  • Configurer une instance AzureAzure Cache for Redis

Ajouter l’intégration .NET.NET Aspire à l’application

Ajoutez l’intégration .NET.NET Aspire appropriée au projet AspireRedis.AppHost pour votre service d’hébergement souhaité.

Ajoutez la 📦Aspire. Hébergement.Azure.Redis package NuGet au projet AspireRedis.AppHost :

dotnet add package Aspire.Hosting.Azure.Redis

Configurer le projet AppHost

Configurez le projet AspireRedis.AppHost pour votre service de Redis souhaité.

Remplacez le contenu du fichier Program.cs dans le projet AspireRedis.AppHost par le code suivant :

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddAzureRedis("cache");

var apiService = builder.AddProject<Projects.AspireRedis_ApiService>("apiservice")
                        .WithReference(cache);

builder.AddProject<Projects.AspireRedis_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithReference(cache)
    .WaitFor(cache)
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

Le code précédent ajoute une ressource AzureAzure Cache for Redis à votre application et configure une connexion appelée cache. La méthode AddAzureRedis garantit que les outils tels que le Azure Developer CLI ou Visual Studio créent une ressource Azure Cache for Redis pendant le processus de déploiement.

Déployer l’application

Les outils tels que le Azure Developer CLI (azd) prennent en charge les configurations d’intégration .NET AspireRedis pour simplifier les déploiements. azd consomme ces paramètres et approvisionne les ressources correctement configurées pour vous.

Note

Vous pouvez également utiliser l' CLI ou Bicep pour approvisionner et déployer des ressources de projet . Ces options nécessitent des étapes manuelles supplémentaires, mais fournissent un contrôle plus précis sur vos déploiements. .NET Aspire projets peuvent également se connecter à une instance de Redis existante via des configurations manuelles.

  1. Ouvrez une fenêtre de terminal à la racine de votre projet .NET.NET Aspire.

  2. Exécutez la commande azd init pour initialiser le projet avec azd.

    azd init

  3. Lorsque l'on vous demande d'entrer le nom d'un environnement, entrez docs-aspireredis.

  4. Exécutez la commande azd up pour commencer le processus de déploiement :

    azd up

  5. Sélectionnez l’abonnement Azure qui doit héberger vos ressources d’application.

  6. Sélectionnez l’emplacement Azure à utiliser.

    Le Azure Developer CLI provisionne et déploie vos ressources d’application. Le processus peut prendre quelques minutes.

  7. Une fois le déploiement terminé, cliquez sur le lien du groupe de ressources dans la sortie pour afficher les ressources créées dans le portail Azure.

Le processus de déploiement a provisionné une ressource AzureAzure Cache for Redis en raison de la . AppHost configuration que vous avez fournie.

une capture d’écran montrant le AzureAzure Cache for Redisdéployé.

Nettoyer les ressources

Exécutez la commande CLI Azure suivante pour supprimer le groupe de ressources lorsque vous n’avez plus besoin des ressources Azure que vous avez créées. La suppression du groupe de ressources supprime également les ressources contenues à l’intérieur de celui-ci.

az group delete --name <your-resource-group-name>

Pour plus d’informations, consultez Nettoyer les ressources dans Azure.

Voir aussi