A reference .NET application implementing an e-commerce website using a services-based architecture.
- Clone the eShop repository: https://github.com/dotnet/eshop
- Install & start Docker Desktop: https://docs.docker.com/engine/install/
- Install Visual Studio 2022 version 17.10 Preview.
- Select the following workloads:
ASP.NET and web development
workload..NET Aspire SDK
component inIndividual components
.- Optional:
.NET Multi-platform App UI development
to run client apps
- Select the following workloads:
- Install the latest .NET 8 SDK
- Install the .NET Aspire workload with the following commands:
dotnet workload update
dotnet workload install aspire
dotnet restore eShop.Web.slnf
Note: These commands may require
sudo
- Optional: Install Visual Studio Code with C# Dev Kit
- Optional: Install .NET MAUI Workload
Warning
Remember to ensure that Docker is started
- (Windows only) Run the application from Visual Studio:
- Open the
eShop.Web.slnf
file in Visual Studio - Ensure that
eShop.AppHost.csproj
is your startup project - Hit Ctrl-F5 to launch Aspire
- Or run the application from your terminal:
dotnet run --project src/eShop.AppHost/eShop.AppHost.csproj
then look for lines like this in the console output in order to find the URL to open the Aspire dashboard:
Login to the dashboard at: http://localhost:19888/login?t=uniquelogincodeforyou
You may need to install ASP.NET Core HTTPS development certificates first, and then close all browser tabs. Learn more at https://aka.ms/aspnet/https-trust-dev-cert
The sample catalog data is defined in catalog.json. Those product names, descriptions, and brand names are fictional and were generated using GPT-35-Turbo, and the corresponding product images were generated using DALL·E 3.
You can use the Azure Developer CLI to run this project on Azure with only a few commands. Follow the next instructions:
- Install the latest or update to the latest Azure Developer CLI (azd).
- Log in
azd
(if you haven't done it before) to your Azure account:
azd auth login
- Initialize
azd
from the root of the repo.
azd init
-
During init:
- Select
Use code in the current directory
. Azd will automatically detect the Dotnet Aspire project. - Confirm
.Net (Aspire)
and continue. - Select which services to expose to the Internet (exposing
webapp
is enough to test the sample). - Finalize the initialization by giving a name to your environment.
- Select
-
Create Azure resources and deploy the sample by running:
azd up
Notes:
- The operation takes a few minutes the first time it is ever run for an environment.
- At the end of the process,
azd
will display theurl
for the webapp. Follow that link to test the sample. - You can run
azd up
after saving changes to the sample to re-deploy and update the sample. - Report any issues to azure-dev repo.
- FAQ and troubleshoot for azd.
For more information on contributing to this repo, read the contribution documentation and the Code of Conduct.
For a version of this app configured for deployment on Azure, please view the eShop on Azure repo.