eShop

ESHOP Reference Application - "AdventureWorks"

Eine Referenzanwendung, die eine E-Commerce-Website implementiert, die eine dienstenbasierte Architektur mit .NET ASPIRE übernimmt.

Erste Schritte

Diese Version von ESHOP basiert auf .NET 9.

Vorherige Eshop -Versionen:

• .NET 8

Voraussetzungen

• Klonen Sie das ESHOP -Repository: https://github.com/dotnet/eshop
• Installieren und starten Sie Docker Desktop

Windows mit Visual Studio

• Installieren Sie Visual Studio 2022 Version 17.10 oder neuer.
  • Wählen Sie die folgenden Workloads aus:
    • ASP.NET and web development Workload.
    • .NET Aspire SDK -Komponente in Individual components .
    • Optional: .NET Multi-platform App UI development zum Ausführen von Client-Apps

Oder

• Führen Sie die folgenden Befehle in einem PowerShell & Terminal aus, das als Administrator ausgeführt wird, um Ihre Umgebung automatisch mit den erforderlichen Tools zu konfigurieren, um diese Anwendung zu erstellen und auszuführen. (Hinweis: Ein Neustart ist erforderlich und im folgenden Skript enthalten.)

 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

Oder

• Von Dev Home gehen Sie zu Machine Configuration -> Clone repositories . Geben Sie die URL für dieses Repository ein. Suchen Sie im Bestätigungsbildschirm nach der Configuration File Detected und klicken Sie auf Run File .

Mac, Linux und Windows ohne Visual Studio

• Installieren Sie das neueste .NET 9 SDK

Oder

• Führen Sie die folgenden Befehle in einem PowerShell & Terminal aus, das als Administrator ausgeführt wird, um Ihre Umgebung automatisch mit den erforderlichen Tools zu konfigurieren, um diese Anwendung zu erstellen und auszuführen. (Hinweis: Nach dem Ausführen des Skripts unten ist ein Neustart erforderlich.)

Installieren Sie den Visual Studio -Code und die zugehörigen Erweiterungen

 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

Hinweis: Diese Befehle erfordern möglicherweise sudo

• Optional: Installieren Sie den Visual Studio -Code mit C# Dev Kit
• Optional: Installieren Sie .NET MAUI Workload

HINWEIS: Wenn Sie mit Apple Silicon (MR-Serienprozessor) auf Mac ausgeführt werden, ist Rosetta 2 für GRPC-Tools.

Die Lösung ausführen

Warnung

Denken Sie daran, sicherzustellen, dass Docker gestartet wird

• (Nur Windows) Führen Sie die Anwendung aus Visual Studio aus:

• Öffnen Sie die Datei eShop.Web.slnf in Visual Studio
• Stellen Sie sicher, dass eShop.AppHost.csproj Ihr Startup -Projekt ist
• Schlagen Sie STRL-F5, um Aspire zu starten

• Oder führen Sie die Anwendung aus Ihrem Terminal aus:

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

Suchen Sie dann nach solchen Linien in der Konsolenausgabe, um die URL zu finden, um das Aspire -Dashboard zu öffnen:

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

Möglicherweise müssen Sie zuerst ASP.NET -Core -HTTPS -Entwicklungszertifikate installieren und dann alle Registerkarte Browser schließen. Weitere Informationen finden Sie unter https://aka.ms/aspnet/https trust-dev-cert

Azure Open AI

Fügen Sie bei der Verwendung von Azure OpenAI in Eshop.apphost/Appsetings.json den folgenden Abschnitt hinzu:

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

Ersetzen Sie die Werte durch Ihre eigenen. Dann setzen

 bool useOpenAI = false ;

Hier finden Sie zusätzliche Anleitungen zur .net Aspire OpenAI -Komponente.

Verwenden Sie Azure Developer CLI

Sie können den Azure Developer CLI verwenden, um dieses Projekt mit nur wenigen Befehlen auf Azure auszuführen. Befolgen Sie die nächsten Anweisungen:

• Installieren Sie das neueste oder aktualisierte Azure Developer CLI (AZD).
• Melden Sie sich in azd an (wenn Sie es noch nicht getan haben) bei Ihrem Azure -Konto:

azd auth login

• Initialisieren Sie azd aus der Wurzel des Repo.

azd init

• Während init:

  • Wählen Sie Use code in the current directory . AZD erkennt automatisch das .NET ASPIRE -Projekt.
  • Bestätigen Sie .NET (Aspire) und fahren Sie fort.
  • Wählen Sie aus, welche Dienste für das Internet ausgesetzt werden sollen (das freigeben, dass webapp ausgesetzt ist, um die Probe zu testen).
  • Füllen Sie die Initialisierung ab, indem Sie Ihrer Umgebung einen Namen geben.

• Erstellen Sie Azure -Ressourcen und stellen Sie das Beispiel ein, indem Sie ausführen:

azd up

Anmerkungen:

• Die Operation dauert einige Minuten, wenn sie zum ersten Mal für eine Umgebung betrieben wird.
• Am Ende des Prozesses zeigt azd die url für das WebApp an. Folgen Sie diesem Link, um das Beispiel zu testen.
• Sie können azd up nach dem Speichern von Änderungen an der Probe ausführen, um das Beispiel erneut abzuwehren und zu aktualisieren.
• Melden Sie alle Probleme Azure-dev Repo.
• FAQ und Fehlerbehebung für AZD.

Beitragen

Weitere Informationen zum Beitrag zu diesem Repo finden Sie in der Beitragsdokumentation und dem Verhaltenskodex.

Beispieldaten

Die Stichprobenkatalogdaten sind in Catalog.json definiert. Diese Produktnamen, Beschreibungen und Markennamen sind fiktiv und wurden mit GPT-35-Turbo generiert, und die entsprechenden Produktbilder wurden unter Verwendung von Dall · e 3 erzeugt.

Eshop auf Azure

Für eine Version dieser App, die für die Bereitstellung auf Azure konfiguriert ist, lesen Sie bitte den ESHOP auf Azure Repo.