eShopOnAzure  by Azure-Samples

A .NET reference application showcasing a microservices e-commerce architecture

Created 2 years ago
257 stars

Top 98.3% on SourcePulse

GitHubView on GitHub
Project Summary

Summary This repository offers eShopOnAzure, a reference .NET e-commerce application demonstrating Azure services and .NET Aspire. It targets developers and architects building scalable, microservices-based e-commerce solutions on Azure, providing a practical example of modern .NET development and cloud integration.

How It Works A variant of the eShop reference app, this project is re-architected for .NET Aspire orchestration of distributed services. It implements an e-commerce website with a services-based architecture, designed for Azure deployment. The approach simplifies microservice development and deployment via built-in observability, resilience, and configuration management, integrated with Azure. Sample data and images are AI-generated using GPT-3.5-Turbo and DALL-E 3.

Quick Start & Requirements Installation varies:

  • Windows with Visual Studio: Requires VS 2022 (17.10+), ASP.NET workload, .NET Aspire SDK. Auto-config PowerShell script (restart needed). Docker Desktop essential. Clone, open eShop.Web.slnf, set eShop.AppHost.csproj as startup, run.
  • Mac, Linux, & Windows without VS: Install .NET 8 SDK, dotnet workload install aspire. Restore (dotnet restore eShop.Web.slnf), run from terminal.
  • Azure Deployment: Install Azure Developer CLI (azd). Authenticate (azd auth login), initialize (azd init), deploy (azd up).

Prerequisites: Docker Desktop (Windows), VS 2022 (17.10+), .NET 8 SDK, .NET Aspire workload, Azure Developer CLI. Links: eShop context: https://github.com/dotnet/eShop. Trusting dev certs: https://aka.ms/aspnet/https-trust-dev-cert.

Highlighted Details

  • .NET Aspire for service orchestration.
  • Azure services integration, including Azure OpenAI.
  • AI-generated sample data (GPT-3.5-Turbo, DALL-E 3).
  • Simplified Azure deployment via Azure Developer CLI (azd).

Maintenance & Community Specific maintainer, sponsorship, or community channel details are absent from the README snippet. Issue reporting is directed to the azure-dev repo.

Licensing & Compatibility The license type and compatibility notes for commercial use or closed-source linking are not specified in the provided README content.

Limitations & Caveats A system restart is mandatory after environment setup scripts. Mac with Apple Silicon (M series) requires Rosetta 2 for grpc-tools. Azure OpenAI integration needs manual configuration in appsettings.json and Program.cs.

Health Check
Last Commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
3 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.