eShop

Aplikasi Referensi Eshop - "AdventureWorks"

Referensi .NET Aplikasi yang mengimplementasikan situs web e-commerce menggunakan arsitektur berbasis layanan menggunakan .NET Aspire.

Memulai

Versi Eshop ini didasarkan pada .NET 9.

Versi Eshop Sebelumnya:

• .Net 8

Prasyarat

• Kloning repositori eShop: https://github.com/dotnet/eshop
• Instal & Mulai Desktop Docker

Windows dengan Visual Studio

• Instal Visual Studio 2022 versi 17.10 atau lebih baru.
  • Pilih beban kerja berikut:
    • ASP.NET and web development .
    • .NET Aspire SDK Komponen dalam Individual components .
    • Opsional: .NET Multi-platform App UI development untuk menjalankan aplikasi klien

Atau

• Jalankan perintah berikut di PowerShell & Terminal berjalan sebagai Administrator untuk secara otomatis mengonfigurasi lingkungan Anda dengan alat yang diperlukan untuk membangun dan menjalankan aplikasi ini. (Catatan: restart diperlukan dan termasuk dalam skrip di bawah ini.)

 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

Atau

• Dari dev home pergi ke Machine Configuration -> Clone repositories . Masukkan URL untuk repositori ini. Di layar konfirmasi, cari Configuration File Detected dan klik Run File .

Mac, Linux, & Windows Without Visual Studio

• Instal .NET 9 SDK terbaru

Atau

• Jalankan perintah berikut di PowerShell & Terminal berjalan sebagai Administrator untuk secara otomatis mengkonfigurasi lingkungan Anda dengan alat yang diperlukan untuk membangun dan menjalankan aplikasi ini. (Catatan: Diperlukan restart setelah menjalankan skrip di bawah ini.)

Instal kode studio visual dan ekstensi terkait

 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

Catatan: Perintah ini mungkin memerlukan sudo

• Opsional: Instal Visual Studio Code dengan C# Dev Kit
• Opsional: Instal .NET Maui Workload

CATATAN: Saat berjalan di Mac dengan Apple Silicon (prosesor Seri M), Rosetta 2 untuk Tools GRPC.

Menjalankan solusinya

Peringatan

Ingatlah untuk memastikan bahwa Docker dimulai

• (Hanya Windows) Jalankan aplikasi dari Visual Studio:

• Buka file eShop.Web.slnf di Visual Studio
• Pastikan bahwa eShop.AppHost.csproj adalah proyek startup Anda
• Tekan Ctrl-F5 untuk meluncurkan Aspire

• Atau jalankan aplikasi dari terminal Anda:

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

Kemudian cari baris seperti ini di output konsol untuk menemukan URL untuk membuka dasbor Aspire:

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

Anda mungkin perlu menginstal sertifikat pengembangan HTTPS ASP.NET Core terlebih dahulu, dan kemudian tutup semua tab Browser. Pelajari lebih lanjut di https://aka.ms/aspnet/https-trust-dev-cert

Azure Open AI

Saat menggunakan azure openai, di dalam eshop.apphost/appsettings.json , tambahkan bagian berikut:

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

Ganti nilai -nilainya dengan nilai sendiri. Kemudian, di Eshop.Apphost Program.cs , tetapkan nilai ini ke True

 bool useOpenAI = false ;

Berikut panduan tambahan pada komponen .net Aspire OpenAi.

Gunakan Azure Developer CLI

Anda dapat menggunakan Azure Developer CLI untuk menjalankan proyek ini di Azure dengan hanya beberapa perintah. Ikuti instruksi berikutnya:

• Instal yang terbaru atau perbarui ke Azure Developer CLI (AZD) terbaru.
• Masuk azd (jika Anda belum pernah melakukannya sebelumnya) ke akun Azure Anda:

azd auth login

• Inisialisasi azd dari akar repo.

azd init

• Selama init:

  • Pilih Use code in the current directory . AZD akan secara otomatis mendeteksi proyek Aspire .net.
  • Konfirmasikan .NET (Aspire) dan Lanjutkan.
  • Pilih layanan mana yang akan diekspos ke Internet (mengekspos webapp sudah cukup untuk menguji sampel).
  • Selesaikan inisialisasi dengan memberikan nama ke lingkungan Anda.

• Buat sumber daya Azure dan sebarkan sampel dengan menjalankan:

azd up

Catatan:

• Operasi membutuhkan waktu beberapa menit saat pertama kali berjalan untuk lingkungan.
• Di akhir proses, azd akan menampilkan url untuk WebApp. Ikuti tautan itu untuk menguji sampel.
• Anda dapat menjalankan azd up setelah menyimpan perubahan pada sampel untuk menggunakan kembali dan memperbarui sampel.
• Laporkan masalah apa pun ke repo Azure-dev.
• FAQ dan pemecahan masalah untuk AZD.

Berkontribusi

Untuk informasi lebih lanjut tentang berkontribusi pada repo ini, baca dokumentasi kontribusi dan kode etik.

Data sampel

Data katalog sampel didefinisikan dalam katalog.json. Nama-nama produk, deskripsi, dan nama merek itu fiksi dan dihasilkan menggunakan GPT-35-turbo, dan gambar produk yang sesuai dihasilkan menggunakan Dall · E 3.

Eshop di Azure

Untuk versi aplikasi ini yang dikonfigurasi untuk penempatan di Azure, silakan lihat eShop pada repo Azure.