eShop

ESHOP參考應用程序 - “ AdventureWorks”

使用.NET ASPIRE的基於服務的架構實現電子商務網站的參考.NET應用程序。

入門

此版本的ESHOP基於.NET 9。

以前的ESHOP版本：

• .NET 8

先決條件

• 克隆ESHOP存儲庫：https：//github.com/dotnet/eshop
• 安裝和啟動Docker桌面

帶有視覺工作室的窗戶

• 安裝Visual Studio 2022版本17.10或更新。
  • 選擇以下工作負載：
    • ASP.NET and web development工作負載。
    • .NET Aspire SDK組件中的Individual components 。
    • 可選： .NET Multi-platform App UI development用於運行客戶端應用程序

或者

• 以Administrator運行的PowerShell＆Terminal運行以下命令，以自動使用所需的工具來構建和運行此應用程序。 （注意：需要重新啟動並包含在下面的腳本中。）

 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

或者

• 從開發主頁轉到Machine Configuration -> Clone repositories 。輸入此存儲庫的URL。在確認屏幕中查找Configuration File Detected ，然後單擊Run File 。

Mac，Linux和Windows沒有Visual Studio

• 安裝最新的.NET 9 SDK

或者

• 在以管理員為Administrator PowerShell和終端中運行以下命令，以使用所需的工具來自動配置環境，以構建和運行此應用程序。 （注意：運行下面的腳本後需要重新啟動。）

安裝Visual Studio代碼和相關擴展名

 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

注意：這些命令可能需要sudo

• 可選：使用C＃開發套件安裝Visual Studio代碼
• 可選：安裝.NET MAUI工作負載

注意：使用Apple Silicon（M系列處理器）在Mac上運行時，Rosetta 2用於GRPC-Tools。

運行解決方案

警告

請記住要確保碼頭工人開始

• （僅Windows）從Visual Studio運行應用程序：

• 在Visual Studio中打開eShop.Web.slnf文件
• 確保eShop.AppHost.csproj是您的啟動項目
• 點擊Ctrl-F5開始Aspire

• 或從您的終端運行應用程序：

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

然後在控制台輸出中查找這樣的行，以找到打開Aspire儀表板的URL：

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

您可能需要首先安裝ASP.NET Core HTTPS開發證書，然後關閉所有瀏覽器選項卡。在https://aka.ms/aspnet/https-trust-dev-cert上了解更多信息

Azure打開AI

使用Azure OpenAi時，內部eshop.apphost/appsettings.json ，添加以下部分：

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

用自己的值替換值。然後，在eshop.apphost program.cs中，將此值設置為true

 bool useOpenAI = false ;

這是有關.NET ASPIRE OPENAI組件的其他指導。

使用Azure開發人員CLI

您可以使用Azure開發人員CLI使用只有幾個命令在Azure上運行此項目。按照下一個說明：

• 將最新或更新安裝到最新的Azure開發人員CLI（AZD）中。
• 登錄azd （如果您以前沒有這樣做）到您的Azure帳戶：

azd auth login

• 從回購的根部初始化azd 。

azd init

• 在初始化期間：

  • Use code in the current directory 。 AZD將自動檢測.NET ASPIRE項目。
  • 確認.NET (Aspire)並繼續。
  • 選擇要暴露於Internet的服務（公開webapp足以測試樣本）。
  • 通過為您的環境命名來最終確定初始化。

• 創建Azure資源並通過運行部署樣本：

azd up

筆記：

• 該操作第一次為環境運行時需要幾分鐘。
• 在過程結束時， azd將顯示WebApp的url 。按照該鏈接測試樣品。
• 您可以在保存樣本更改以重新部署並更新樣本後運行azd up 。
• 向Azure-Dev回購報告任何問題。
• 常見問題解答和對AZD的故障排除。

貢獻

有關貢獻此回購的更多信息，請閱讀貢獻文檔和行為準則。

示例數據

樣品目錄數據在目錄中定義。這些產品名稱，描述和品牌名稱是虛構的，是使用GPT-35-Turbo生成的，並且使用DALL·E 3生成相應的產品圖像。

azure上的eShop

對於該應用程序的版本，該應用程序配置為在Azure上部署，請在Azure Repo上查看ESHOP。