This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
CONTENT
- 2023-02-03 - Release 6.0.0
- 2021-11-08 - Release 5.0.0
- 2021-01-21 - Release 3.1.1
- 2020-12-14 - Release 3.1.0
- 2019-11-26 - Release 3.0.0
2023-02-03 - Release 6.0.0
Highlights
- Updates the code to .NET 6.0
Details
Changes
- Updates the code to .NET 6.0
- Updates the dotnet sdk tag in Dockerfiles
- Updated
Envoyversion to 1.22.0 - Created
GlobalUsings.csand migrate using statements to these files for all projects - Removes language preview version from csproj
- Update credit card
Expirationdate WebSPAproject related changes:- Updates packages in
package-lock.jsonfile in WebSPA project. - Updates following
Readmefiles to incorporate latest instructions:README.mdfile.branch-guide.mdfile.CONTRIBUTING.md
- Contains following updates in
eShopOnContainerswiki:- Updates the System-requirements page.
- Docker-compose-deployment-files
- Updates the steps for Windows-setup
- Updates to the docker version images and VS 2022 installation images.
- Updates to Deploy to Local Kubernetes page
- Updates the section to describe how to run WebSPA project via Visual Studio 2022 in debug mode.
- Updated the broken links
Bug Fixes
- Fixes ingress yaml indentation
- Fixes for bundleconfig json
- Fixes a few typos in fields name, documentation, and refactoring.
Contributions
We’d like to acknowledge and thank the following community members for their valuable contributions!
@marranica, @Ich1goSan, @onurkanbakirci
2021-11-08 - Release 5.0.0
Highlights
- Updates the code to .NET 5.0
Details
Changes
- Updates the code to .NET 5.0
- Includes
C# 9.0features. - Removes unused using from different classes.
- Removes mobile project from
eShopOnContainersto eshop-mobile-client - Renames
GracePeriodManagerTaskinGracePeriodManagerService - Updates
CardTypeandEnumerationclass. - Updates the dotnet sdk tag in Dockerfiles
- Migrates
Newtonsoft.JsontoSystem.Text.Json WebSPAproject related changes:- Updates the
WebSPAUI theme. - Updates
WebSPAAngular Version to11.2 - Updates the
Catalog Itemspecific images. - Updates packages in
package-lock.jsonfile in WebSPA project.
- Updates the
GitHubActions specific changes:- Includes first version of GitHub actions as part of CI/CD pipelines
- Updates Job steps to accomodate latest action packages.
- Refactors GitHub Actions workflows to use composite.
- Updates Azure Service Bus ARM Templates in
deploy/azure/az/servicebus/sbusdeploy.json - Updates the Azure Service Bus SDK version and changes the namespace from
Microsoft.Azure.ServiceBustoAzure.Messaging.ServiceBus - Uses the
Microsoft.AspNetCore.DataProtection.StackExchangeRedispackage instead ofMicrosoft.AspNetCore.DataProtection.Redis - Downgrades
Microsoft.AspNetCore.Hosting.Abstractionsto2.2.0 - Updates following
Readmefiles to incorporate latest instructions:Main.mdfile.branch-guide.mdfile.CONTRIBUTING.mdfile.
- Contains following updates in
eShopOnContainerswiki:- Updates the System-requirements page.
- Docker-compose-deployment-files
- Updates the images Visual-Studio-2017-environment
- Updates the steps for Windows-setup
- Updates the steps for Mac-setup
- Moves the Xamarin-setup specific content to
- Architecture
- gRPC
- Using-HealthChecks
- Azure-Key-Vault
- Unit-and-integration-testing
- Updates
Frequent-errorspage. - Includes Github Actions related documentations.
Bug Fixes
- Fixes
SameSitecookie policy. - Fixes
ContentPage.ToolbarItemsin aTabbedPage - Fixes persistency for
ISubscriptionClient - Fixes
ordering-signalrhubworkflow badge image - Fixes
WebSPApager display. - Fixes
WebSPAcatalog filter. - Fixes
mobileshoppingaggaddress in mobileshoppingenvoy.yaml - Fixes serialization in
EventBusServiceBus.csclass. - Fixes to use existing cosumerChannel in
EventRabbitMQqueue. - Fixes few typos in fields name, documentation and scripts.
- Fixes
deploy-all.shdeployment script file
Contributions
We’d like to acknowledge and thank the following community members for their valuable contributions!
@dsrodenas, @vishipayyallore, @borjasanes, @mvelosop, @hetal-kapadia, @william-keller, @Sreenivas-Kalluru, @alecola, @f1nzer, @Marusyk, @n-stefan, @mohamed-seada-1994, @colindembovsky, @sanderobdeijn, @deckerbd, @michaelgregson, @kaypee90, @alan0428a, @GitHubPang, @ryanceleslie, @oliviergaumond, @zedy-wj
2021-01-21 - Release 3.1.1
The latest 3.1.1 release contains multiple changes and bug fixes:
Highlights
- Refactors code for few of the code modules
- Fixes few important bugs
Details
Changes
- Removed unused using and refactored spacing in many classes.
- Removes
dotnet.myget.orgNuGet package feed dependency from theNuGet.configfile. - Removes unnecessary await from
Ordering.BackgroundTasks - Updates packages in
package-lock.jsonfile in WebSPA project.
Bug Fixes
- Fixes total decimal place and drop-down menu hover issue in Web MVC app.
- Fixes Ordering Functional Test case.
Contributions
We’d like to acknowledge and thank the following community members for their valuable contributions !
@vishipayyallore, @william-keller, @hetal-kapadia , @InstanceFactory
2020-12-14 - Release 3.1.0
The latest 3.1.0 release contains multiple changes and bug fixes:
Highlights
- Updates to .NET Core 3.1.0
- Refactors code for few of the code modules
- Fixes few important bugs
Details
Changes
- Removes unused using from different classes.
- Updates Readme with relevant information.
- Updates app manifest to support helm 3.x+ and Kubernetes version 1.16.x+
- Updates different npm package versions in WebSPA
- Changes docker host DNS default value to
host.docker.internal - Changes
OpenIdConnectstring literal toOpenIdConnectDefaults.AuthenticationScheme - Changes ReadAllBytes to ReadAllBytesAsync in PicController
- Updates Solution file
Bug Fixes
- Fixes SignalR 401 Unauthorized error.
- Fixes different
typoin the mainReadmefile. - Fixes Firewall specific rule check in the script.
- Fixes disposing of direct instantiated objects in calalog service
- Fixes typo in
Readmeandappsetting.jsonfile. - Fixes unit test cases
- Fixes parameter error in multiarch job
- Fixes WebSPA build error after updating sha hashes in
packages-lock.json - Fixes missing claimsType for load testing
- Fixes PurchaseUrl port in WebSPA
appsettings.json - Fixes spelling mistake in code comment.
- Fixes k8s manifest deployment error
invalid type for io.k8s.api.core.v1.ConfigMap.datafrom macOS environment.
Contributions
We’d like to acknowledge and thank the following community members for their valuable contributions !
@vishipayyallore, @markharwood101, @hfz-r, @smholvoet, @InstanceFactory, @EdmondShtogu, @nsedoud, @H3RSKO, @MajidAliKhanQuaid, @fjvela, @jeremiahflaga, @zakaria-c, @wojciechrak , @anjoy8, @m-knet, @n-stefan, @synercoder , @Rosenberg96
2019-11-26 - Release 3.0.0
The latest 3.0.0 release contains a LOT of changes and new features:
Highlights - 3.0.0
- Update to .NET Core 3.0
- Use of gRPC for microservice-to-microservice communication
- Use of Envoy Proxy for BFF
- Repo cleanup
- Initial Service Mesh support
- Revise deployment scenarios
Details - 3.0.0
-
Migrate solution from ASP.NET Core 2.2 to 3.0 and update all projects to use the latest .NET Core 3.0 templates.
-
Implement the new .NET Core 3.0 WorkerService in Ordering.API and other background processes.
-
Improve Ordering.API
- Group order items
- apply discounts from Marketing.API
-
Handle two deployment scenarios
-
Basic deployment, better for learning:
-
Advanced deployment, complex but more real-life:
- Deploy to AKS with a Service Mesh for resiliency
- Sidecar implementation with Envoy/Linkerd
- Improved API Gateway and resilience
- gRPC for microservice-to-microservice communications
- Dev Spaces support (only for containers that don't use gRPC)
- Deploy to AKS with a Service Mesh for resiliency
-
New folder structure
The repo also has a new, simpler, folder structure, as shown in the following image:
In the above image you can see that the first folder level contains, basically:
- build: Scripts for building Docker images.
- deploy: Scripts for deployment.
- src: All source projects, including tests.
- ApiGateways: Envoy configuration and Aggregators source code.
- BuildBlocks: Common components used by several projects.
- Mobile: Mobile apps projects.
- Services: Backend for all services. Including unit and functional tests for some projects.
- Basket
- Catalog
- Identity
- Location
- Marketing
- Ordering
- Payment
- Webhooks
- Tests: General functional application tests.
- test-results: Test results
- Web: Web applications
Retired deployment scenarios
- Service Fabric & Service Fabric Mesh.
- Kubernetes using YAML (only Helm charts are supported)
- CLI scripts for build and push (docker-compose and docker multi-stage are used)
eShopOnContainers
Getting started
- System requirements
- Development setup
- Databases & containers
FREQUENT ERRORS
Explore
- Architecture
- Application
- Code
- Logging and Monitoring
- Tests
Deployment
Local
Production (generic)
Cloud
- Azure Kubernetes Service (AKS)
- Azure Kubernetes Service (AKS) - Archived
- Azure Dev Spaces
- Using Azure resources
- Deploying Azure resources
