Skip to content

Latest commit

 

History

History
93 lines (64 loc) · 5.09 KB

2-servicedefaults.md

File metadata and controls

93 lines (64 loc) · 5.09 KB
Raw

Paramètres par défaut (Smart Defaults)

Introduction

.NET Aspire fournit un ensemble de valeurs par défaut pour les services couramment utilisés dans les applications .NET. Ces valeurs par défaut sont conçues pour vous aider à démarrer rapidement et à offrir une expérience cohérente sur différents types d'applications. Ceci comprend:

  • Télémétrie : métriques, traçage, journalisation
  • Résilience
  • Contrôles de santé
  • Découverte des services

Créer le projet "Service Defaults"

Visual Studio & Visual Studio Code

  1. Ajoutez un nouveau projet à la solution appelé ServiceDefaults:

    • Faites un clic droit sur la solution et sélectionnez Add > New Project.
    • Sélectionnez le modèle de projet .NET Aspire Service Defaults.
    • Nommé le projet ServiceDefaults.
    • Cliquez Next > Create.

    Visual Studio Boîte de dialogue Visual Studio pour ajouter un projet de valeurs par défaut du service

    Visual Studio Code Boîte de dialogue Visual Studio Code pour ajouter un projet de valeurs par défaut du service

Ligne de commande

  1. Créez un nouveau projet à l'aide de la commandedotnet new aspire-servicedefaults:

    dotnet new aspire-servicedefaults -n ServiceDefaults

Configurer les paramètres par défaut du service

  1. Ajoutez une référence au projet ServiceDefaults dans les projets Api et MyWeatherHub :

    • Faites un clic droit sur le projet Api et sélectionnez Add > Reference.
      • Vérifiez le projet ServiceDefaults et cliquez sur OK.
    • Faites un clic droit sur le projet MyWeatherHub et sélectionnez Add > Reference.
      • Vérifiez le projet ServiceDefaults et cliquez sur OK.

    Conseil de pro: dans Visual Studio 2022, vous pouvez faire glisser et déposer le projet sur un autre projet pour ajouter une référence.

  2. Dans les projets Api et MyWeatherHub, modifiez leurs fichiers Program.cs, en ajoutant la ligne suivante immédiatement après leur ligne var builder = WebApplication.CreateBuilder(args); :

    builder.AddServiceDefaults();

  3. Dans les projets Api et MyWeatherHub, modifiez leurs fichiers Program.cs, en ajoutant la ligne suivante immédiatement après leur ligne var app = builder.Build(); :

    app.MapDefaultEndpoints();

Exécutez l'application

  1. Exécutez l'application à l'aide d'une configuration de lancement multi-projets dans Visual Studio ou Visual Studio Code.
  • Visual Studio : Faites un clic droit sur la solution MyWeatherHub et accédez aux propriétés. Sélectionnez « Api » et « MyWeatherHub » comme projets de démarrage, sélectionnez « OK ».
    • Propriétés de la solution Visual Studio
    • Cliquez sur « Start » pour démarrer et déboguer les deux projets.
  • Visual Studio Code : exécutez les projets Api et MyWeatherHub à l'aide du panneau Exécuter et déboguer. Nous avons fourni un fichier « launch.json » avec les configurations nécessaires pour exécuter les deux.

  1. Test the application by navigating to the following URLs:

  2. You should see the Swagger UI for the API and the MyWeatherHub home page.

  3. You can also view the health checks for the API by navigating to https://localhost:7032/health.

  4. You can also view the health checks for the MyWeatherHub by navigating to https://localhost:7274/health.

  5. View the logs in the terminal to see the health checks and other telemetry data such as resiliency with Polly:

  6. Vous devriez voir l'interface utilisateur Swagger pour l'API et la page d'accueil de MyWeatherHub.

  7. Vous pouvez également afficher les Contrôles de santé de l'API en accédant à https://localhost:7032/health.

  8. Vous pouvez également afficher les Contrôles de santé de MyWeatherHub en accédant à https://localhost:7274/health.

  9. Consultez les journaux (logs) dans le terminal pour voir les contrôles de santé et d'autres données de télémétrie telles que la résilience avec Polly :

    Polly: Information: Execution attempt. Source: '-standard//Standard-Retry', Operation Key: '', Result: '200', Handled: 'False', Attempt: '0', Execution Time: '13.0649'

  10. Cliquez sur 5 villes différentes et une erreur "random" sera générée. Vous verrez la politique de nouvelle tentative de Polly en action.

    Polly: Warning: Execution attempt. Source: '-standard//Standard-Retry', Operation Key: '', Result: '500', Handled: 'True', Attempt: '0', Execution Time: '9732.8258'
Polly: Warning: Resilience event occurred. EventName: 'OnRetry', Source: '-standard//Standard-Retry', Operation Key: '', Result: '500'
System.Net.Http.HttpClient.NwsManager.ClientHandler: Information: Sending HTTP request GET http://localhost:5271/forecast/AKZ318