eShop

Application de référence ESHOP - "Adventureworks"

Une application .NET référence implémentant un site Web de commerce électronique utilisant une architecture basée sur les services utilisant .NET Aspire.

Commencer

Cette version d'Eshop est basée sur .NET 9.

Versions ESHOP précédentes:

• .Net 8

Condition préalable

• Clone The Eshop Repository: https://github.com/dotnet/eshop
• Installer et démarrer le bureau Docker

Windows avec Visual Studio

• Installez Visual Studio 2022 version 17.10 ou plus récent.
  • Sélectionnez les charges de travail suivantes:
    • ASP.NET and web development Workload.
    • Composant .NET Aspire SDK dans Individual components .
    • Facultatif: .NET Multi-platform App UI development pour exécuter les applications clients

Ou

• Exécutez les commandes suivantes dans un PowerShell & Terminal en cours d'exécution en tant Administrator pour configurer automatiquement votre environnement avec les outils requis pour créer et exécuter cette application. (Remarque: un redémarrage est requis et inclus dans le script ci-dessous.)

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvside.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

Ou

• De Dev Home, allez à Machine Configuration -> Clone repositories . Entrez l'URL pour ce référentiel. Dans l'écran de confirmation, recherchez le Configuration File Detected et cliquez sur Run File .

Mac, Linux et Windows sans Visual Studio

• Installez le dernier SDK .net 9

Ou

• Exécutez les commandes suivantes dans un PowerShell & Terminal en cours d'exécution en tant Administrator pour configurer automatiquement votre environnement avec les outils requis pour créer et exécuter cette application. (Remarque: un redémarrage est requis après l'exécution du script ci-dessous.)

Installez le code Visual Studio et les extensions connexes

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense  - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvscode.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

Remarque: ces commandes peuvent nécessiter sudo

• Facultatif: Installez le code Visual Studio avec C # Dev Kit
• Facultatif: installer la charge de travail .net Maui

Remarque: Lors de l'exécution sur Mac avec le silicium Apple (processeur de la série M), Rosetta 2 pour GRPC-Tools.

Exécuter la solution

Avertissement

N'oubliez pas de vous assurer que Docker est démarré

• (Windows uniquement) Exécutez l'application à partir de Visual Studio:

• Ouvrez le fichier eShop.Web.slnf dans Visual Studio
• Assurez-vous que eShop.AppHost.csproj est votre projet de démarrage
• Frappez Ctrl-F5 pour lancer Aspire

• Ou exécutez l'application à partir de votre terminal:

dotnet run -- project src / eShop.AppHost / eShop.AppHost.csproj

Recherchez ensuite des lignes comme celle-ci dans la sortie de la console afin de trouver l'URL pour ouvrir le tableau de bord Aspire:

Login to the dashboard at: http://localhost:19888/login ? t=uniquelogincodeforyou

Vous devrez peut-être installer d'abord ASP.NET Core HTTPS de développement HTTPS, puis fermer tous les onglets du navigateur. En savoir plus sur https://aka.ms/aspnet/https-trust-dev-cert

Azure Open AI

Lorsque vous utilisez Azure OpenAI, dans EShop.AppHost / AppSettings.json , ajoutez la section suivante:

  "ConnectionStrings" : {
    "OpenAi" : " Endpoint=xxx;Key=xxx; "
  }

Remplacez les valeurs par les vôtres. Ensuite, dans le programme eShop.apphost.cs, définissez cette valeur sur true

 bool useOpenAI = false ;

Voici des conseils supplémentaires sur le composant .net Aspire OpenAI.

Utilisez le développeur Azure CLI

Vous pouvez utiliser le CLI du développeur Azure pour exécuter ce projet sur Azure avec seulement quelques commandes. Suivez les instructions suivantes:

• Installez la dernière ou mise à jour du dernier développeur Azure CLI (AZD).
• Connectez-vous azd (si vous ne l'avez pas fait auparavant) à votre compte Azure:

azd auth login

• Initialisez azd de la racine du repo.

azd init

• Pendant l'init:

  • Sélectionnez Use code in the current directory . AZD détectera automatiquement le projet .NET Aspire.
  • Confirmer .NET (Aspire) et continuer.
  • Sélectionnez les services à exposer à Internet (exposer webapp est suffisant pour tester l'échantillon).
  • Finalisez l'initialisation en donnant un nom à votre environnement.

• Créez des ressources Azure et déployez l'échantillon en fonctionnant:

azd up

Notes:

• L'opération prend quelques minutes la première fois qu'elle s'exécute pour un environnement.
• À la fin du processus, azd affichera l' url pour le WebApp. Suivez ce lien pour tester l'échantillon.
• Vous pouvez exécuter azd up après enregistrer les modifications de l'échantillon pour redéployer et mettre à jour l'échantillon.
• Signalez tout problème à Azure-DEV Repo.
• FAQ et dépannage pour AZD.

Contributif

Pour plus d'informations sur la contribution à ce dépôt, lisez la documentation de contribution et le code de conduite.

Échantillons de données

Les données des échantillons de catalogue sont définies dans Catalog.json. Ces noms de produits, descriptions et les noms de marque sont fictifs et ont été générés à l'aide de GPT-35-turbo, et les images de produit correspondantes ont été générées à l'aide de Dall · E 3.

eshop sur azure

Pour une version de cette application configurée pour le déploiement sur Azure, veuillez consulter l'Eshop sur Azure Repo.