eShop

แอปพลิเคชั่นอ้างอิง ESHOP - "AdventureWorks"

แอปพลิเคชัน. NET อ้างอิงที่ใช้เว็บไซต์อีคอมเมิร์ซโดยใช้สถาปัตยกรรมที่ใช้บริการโดยใช้. NET Aspire

เริ่มต้น

ESHOP รุ่นนี้ขึ้นอยู่กับ. NET 9

รุ่น ESHOP ก่อนหน้า:

• .net 8

ข้อกำหนดเบื้องต้น

• โคลนที่เก็บ eshop: https://github.com/dotnet/eshop
• ติดตั้งและเริ่ม Docker Desktop

Windows พร้อม Visual Studio

• ติดตั้ง Visual Studio 2022 เวอร์ชัน 17.10 หรือใหม่กว่า
  • เลือกเวิร์กโหลดต่อไปนี้:
    • ASP.NET and web development
    • .NET Aspire SDK ใน Individual components
    • ตัวเลือก: .NET Multi-platform App UI development เพื่อเรียกใช้แอปไคลเอนต์

หรือ

• เรียกใช้คำสั่งต่อไปนี้ใน PowerShell & Terminal ที่ทำงานเป็น Administrator เพื่อกำหนดค่าสภาพแวดล้อมของคุณโดยอัตโนมัติด้วยเครื่องมือที่จำเป็นในการสร้างและเรียกใช้แอปพลิเคชันนี้ (หมายเหตุ: จำเป็นต้องรีสตาร์ทและรวมอยู่ในสคริปต์ด้านล่าง)

 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

หรือ

• จาก Dev Home ไปที่ Machine Configuration -> Clone repositories ป้อน URL สำหรับที่เก็บนี้ ในหน้าจอยืนยันค้นหา Configuration File Detected และคลิก Run File

Mac, Linux และ Windows โดยไม่ต้อง Visual Studio

• ติดตั้ง. NET 9 SDK ล่าสุด

หรือ

• เรียกใช้คำสั่งต่อไปนี้ใน PowerShell & Terminal ที่ทำงานเป็น Administrator เพื่อกำหนดค่าสภาพแวดล้อมของคุณโดยอัตโนมัติด้วยเครื่องมือที่จำเป็นในการสร้างและเรียกใช้แอปพลิเคชันนี้ (หมายเหตุ: จำเป็นต้องรีสตาร์ทหลังจากเรียกใช้สคริปต์ด้านล่าง)

ติดตั้งรหัส 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

• ตัวเลือก: ติดตั้ง Visual Studio Code ด้วย C# dev Kit
• ตัวเลือก: ติดตั้ง. net maui เวิร์กโหลด

หมายเหตุ: เมื่อทำงานบน Mac ด้วย Apple Silicon (M Series Processor), Rosetta 2 สำหรับ GRPC-tools

เรียกใช้โซลูชัน

คำเตือน

จำไว้ว่าเพื่อให้แน่ใจว่านักเทียบท่าจะเริ่มต้นขึ้น

• (Windows เท่านั้น) เรียกใช้แอปพลิเคชันจาก Visual Studio:

• เปิดไฟล์ eShop.Web.slnf ใน Visual Studio
• ตรวจสอบให้แน่ใจว่า eShop.AppHost.csproj เป็นโครงการเริ่มต้นของคุณ
• กด Ctrl-F5 เพื่อเปิดตัว Aspire

• หรือเรียกใช้แอปพลิเคชันจากเทอร์มินัลของคุณ:

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

จากนั้นมองหาบรรทัดเช่นนี้ในเอาต์พุตคอนโซลเพื่อค้นหา URL เพื่อเปิด Dashboard Aspire:

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

คุณอาจต้องติดตั้งใบรับรองการพัฒนา ASP.NET Core HTTPS ก่อนจากนั้นปิดแท็บเบราว์เซอร์ทั้งหมด เรียนรู้เพิ่มเติมได้ที่ https://aka.ms/aspnet/https-trust-dev-cert

Azure Open AI

เมื่อใช้ Azure Openai, Inside Eshop.Apphost/AppSettings.json เพิ่มส่วนต่อไปนี้:

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

แทนที่ค่าด้วยของคุณเอง จากนั้นใน โปรแกรม eshop.apphost.cs ตั้งค่านี้เป็น จริง

 bool useOpenAI = false ;

นี่คือคำแนะนำเพิ่มเติมเกี่ยวกับ. NET Aspire Openai Component

ใช้ Azure Developer CLI

คุณสามารถใช้ CLI นักพัฒนา Azure เพื่อเรียกใช้โครงการนี้บน Azure ด้วยคำสั่งเพียงไม่กี่คำ ทำตามคำแนะนำถัดไป:

• ติดตั้งล่าสุดหรืออัปเดตเป็น Azure Developer ล่าสุด CLI (AZD)
• เข้าสู่ azd (ถ้าคุณยังไม่เคยทำมาก่อน) ไปยังบัญชี Azure ของคุณ:

azd auth login

• เริ่มต้น azd จากรูทของ repo

azd init

• ในระหว่างการเริ่มต้น:

  • เลือก Use code in the current directory AZD จะตรวจจับโครงการ. NET Aspire โดยอัตโนมัติ
  • ยืนยัน .NET (Aspire) และดำเนินการต่อ
  • เลือกบริการใดที่จะเปิดเผยต่ออินเทอร์เน็ต (การเปิดเผย webapp นั้นเพียงพอที่จะทดสอบตัวอย่าง)
  • จบการเริ่มต้นโดยให้ชื่อกับสภาพแวดล้อมของคุณ

• สร้างทรัพยากร Azure และปรับใช้ตัวอย่างโดยการรัน:

azd up

หมายเหตุ:

• การดำเนินการใช้เวลาไม่กี่นาทีในครั้งแรกที่เคยมีสภาพแวดล้อม
• ในตอนท้ายของกระบวนการ azd จะแสดง url สำหรับ WebApp ไปตามลิงค์นั้นเพื่อทดสอบตัวอย่าง
• คุณสามารถเรียกใช้ azd up หลังจากบันทึกการเปลี่ยนแปลงตัวอย่างเพื่อปรับใช้และอัปเดตตัวอย่างอีกครั้ง
• รายงานปัญหาใด ๆ ไปยัง Azure-Dev Repo
• คำถามที่พบบ่อยและแก้ไขปัญหาสำหรับ AZD

การบริจาค

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการมีส่วนร่วมในการซื้อคืนนี้อ่านเอกสารประกอบการบริจาคและจรรยาบรรณ

ตัวอย่างข้อมูล

ข้อมูลแคตตาล็อกตัวอย่างถูกกำหนดไว้ในแคตตาล็อก json ชื่อผลิตภัณฑ์คำอธิบายและชื่อแบรนด์เหล่านั้นเป็นตัวละครและถูกสร้างขึ้นโดยใช้ GPT-35-turbo และภาพผลิตภัณฑ์ที่เกี่ยวข้องถูกสร้างขึ้นโดยใช้ Dall · E 3

Eshop บน Azure

สำหรับเวอร์ชันของแอพนี้ที่กำหนดค่าสำหรับการปรับใช้บน Azure โปรดดู ESHOP บน Azure repo