microsoft / tailwindtraders

Tailwind Traders - Sample Reference Applications

We are happy to announce the release of Tailwind Traders. A fictitious retail company showcasing the future of intelligent application experiences. These reference apps are all are powered by the Azure cloud, built with best-in-class tools, and made smarter through data and AI.

New to Microsoft Azure?

You will need an Azure subscription to work with this demo code. You can:

• Open an account for free Azure subscription. You get credits that can be used to try out paid Azure services. Even after the credits are used up, you can keep the account and use free Azure services and features, such as the Web Apps feature in Azure App Service.
• Activate Visual Studio subscriber benefits. Your Visual Studio subscription gives you credits every month that you can use for paid Azure services.
• Create an Azure Student Account and get free credit when you create your account.

Learn more about it with Microsoft Learn - Introduction to Azure.

Repositories

For this demo reference, we built several consumer and line-of-business applications and a set of backend services. You can find all repositories in the following locations:

• Backend (AKS) ARCHIVED
• Website (ASP.NET & React) ARCHIVED
• Desktop (WinForms & WPF -.NET Core) ARCHIVED
• Rewards (ASP.NET Framework) ARCHIVED
• Shipping Management (Power App + Azure Serverless) ARCHIVED
• Mobile (Xamarin Forms 4.0) - ARCHIVED
• Point of Sale (VB6 to ASP.NET Migration with Mobilize.net) - ARCHIVED

As part of Connect(); 2018 we also released the AI Vision Provision sample mobile app, which allows you to deploy Azure services from scanning Azure Services Logos or Text. The AI Pet Detector demo app is also available, learn how to create a Pet Detector image recognition with Azure Notebooks, Azure Machine Learning and Visual Studio Code.

Demo Scripts

You can find the demo scripts that show the power of Azure, Visual Studio and GitHub.

• Integrating Azure DevOps, Microsoft Teams and GitHub demonstrates the ability to easily use GitHub for hosting source code and use Azure Pipelines for continuous integration and continuous delivery to quickly deploy changes to Azure. Connect Azure Boards with GitHub repositories to take advantage of the rich project management capabilities provided by Azure Boards that spans Kanban boards, backlogs, team dashboards, and custom reporting, etc.

• Managing backend with Azure Kubernetes Service (AKS) learn how AKS allows you to managed orchestration of containers and also provides auto-patching, auto-scaling and updates support which enables you to use the full breadth of the Kubernetes ecosystem. Take advantage of Virtual Node that enables you to elastically provision additional nodes inside your Kubernetes clusters in just seconds, a first-of-its-kind serverless computing option with AKS enables you to provision and scale your Kubernetes based apps more efficiently.

• Modernizing .NET Apps move apps to the cloud and take advantage of cloud native solutions to modernize it and explore the benefits of Azure App Services.

• Productivity Improvements in Visual Studio 2019 the new version contains many new and exciting features and IDE productivity enhancements to support Windows app development, cross-platform mobile development, Azure development, web and cloud development, and more.

• Visual Studio App Center Capabilities Automate the Build-Test-Distribute process for your mobile projects in GitHub. Continuous Integration and Continuous Delivery (CI/CD) with UI Test.

Application Diagram

Application Screens

Feedback

Help us improving this reference applications by providing us your valuable opinion.

Blog posts and videos

Azure Friday: An overview of the Tailwind Traders reference apps for Azure

Visual Studio 2019 Launch Event:

Videos and blog posts from Connect(); 2018:

• Scott Guthrie's blog post

• Scott Guthrie's Keynote:

• Scott Hanselman's Keynote:

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

tailwindtraders's Issues

Azure Dev Spaces is deprecated --> how about updating with Bridge to Kubernetes ?

Hi all,
in this page [https://github.com/microsoft/TailwindTraders/tree/master/Documents/DemoScripts/Managing%20backend%20with%20Azure%20Kubernetes%20Service%20(AKS)] you explain how to use Azure Dev Spaces, but it's deprecated since 2021 [https://azure.microsoft.com/it-it/updates/azure-dev-spaces-is-retiring-on-31-october-2023/].

Could it be possible to update the article with reference to Bridge to Kubernetes https://devblogs.microsoft.com/visualstudio/bridge-to-kubernetes-ga/ ?

Thanks a lot,
Luca Bovo - beanTech

Azure CLI script next to Deploy Button

Provide a AZ CLI based script to deploy the Azure Resources, which will provide more clarity on the resources needed to standup an ENV. This will go next to the Deploy button

ARM Outputs 6 vs keesschollaart.arm-outputs.arm-outputs.ARM Outputs@5

Azure DevOps marketplace has ARM Outputs version 6 while yaml of the project uses 5. Please check this out

.Deploy-Arm-Azure.ps1 issue with postgres version

the prompt to specify a postgres version keeps failing me. I've tried 11.4, 9.6, 9, 11 and all fail. I'm passing it using single quotes''. Please advise, with this failure the WorkspaceDeployment and the SolutionDeployment both succeed so I think it's just the PostGres that isn't created.

Below is error message (RESOURCE ID removed)

{ "id": "/subscriptions/9aa7299f-fdd4-47b8-acaf-825d2bdc8bba/resourceGroups/AKSThirdAttempt/providers/Microsoft.Resources/deployments/deployment/operations/3F5E3780F0842002", "operationId": "3F5E3780F0842002", "properties": { "provisioningOperation": "Create", "provisioningState": "Failed", "timestamp": "2019-07-26T17:08:48.2614439Z", "duration": "PT1M1.0999929S", "trackingId": "0cbfe728-4ada-4d3c-80c8-ccd10fb1e5cc", "statusCode": "Conflict", "statusMessage": { "status": "Failed", "error": { "code": "ResourceDeploymentFailure", "message": "The resource operation completed with terminal provisioning state 'Failed'.", "details": [ { "code": "InvalidVersion", "message": "Version ''11'' is not supported." } ] } }, "targetResource": { "id": "/subscriptions/9aa7299f-fdd4-47b8-acaf-825d2bdc8bba/resourceGroups/AKSThirdAttempt/providers/Microsoft.DBforPostgreSQL/servers/ttpggneoho5zai6dw", "resourceType": "Microsoft.DBforPostgreSQL/servers", "resourceName": "ttpggneoho5zai6dw" } }}

unrecognized arguments: --password Pa$$w0rd01

I'm using Azure CLI 2.4.0 on MacOS.

When I follow the instruction towards the creation of the RBAC security:
az ad sp create-for-rbac --name TTapp --password Pa$$w0rd01

The CLI gives me error: "az: error: unrecognized arguments: --password Pa19428w0rd01"

Following the guide, the password is not complex enough and fails to create Sql Server

Here is the ARM deployment: -

resourceGroups/TailwindBackend/providers/Microsoft.Sql/servers/ttsqlserverjhn2shwkybtso", "resourceType": "Microsoft.Sql/servers", "resourceName": "ttsqlserverjhn2shwkybtso" }, "request": { "content": { "location": "eastus", "properties": { "administratorLogin": "sqladmin", "administratorLoginPassword": "P2SSWORD", "version": "12.0" } } }, "response": { "content": { "name": "68353530-ef45-49b1-b0d9-b7fc60206bb8", "status": "Failed", "startTime": "2019-02-13T17:17:21.39Z", "error": { "code": "PasswordNotComplex", "message": "Password validation failed. The password does not meet policy requirements because it is not complex enough." } } } }}

Backend Deployment Guide is 404

This guide is missing in the repo, https://github.com/microsoft/TailwindTraders/blob/master/Documents/DeploymentGuide.md Not sure if it was moved.

Integrating Azure Pipelines, GitHub, and Azure Boards - Build fails because of userEmail parameter

Following through the Azure Pipelines, GitHub and Azure Boards script, the build pipeline created by the Azure DevOps Demo Generator fails at the "Azure Deployment:Create Or Update Resource Group action on $(resourcegroup)" step as follows

##[error]Deployment template validation failed: 'The template parameters 'userEmail' in the parameters file are not valid; they are not present in the original template and can therefore not be provided at deployment time. The only supported parameters for this template are 'sku, skuCode, registrySku, workerSize, dockerRegistryUrl, dockerimage, apiBaseUrl'. Please see https://aka.ms/arm-deploy/#parameter-file for usage details.'.
##[error]Task failed while creating or updating the template deployment.

The override template parameters section of the step contains a value -userEmail $(useremail) removing this value allows the build to proceed.

Link to AI PetDetect mobile app in README broken

The README.md file links to https://github.com/Microsoft/connect-petdetector
which results in a 404.

Azure Notebook no longer exists, right?

Cart API : wrong type in picture?

In the main overview picture:
https://github.com/microsoft/TailwindTraders/blob/master/Documents/Images/Diagram.png

The Cart API is defined as ".NET Core", however when I look at the code it's node.js ?

Integrating Azure Pipelines, GitHub, and Azure Boards - Build fails because, Could not find any file matching the template file pattern

I'm getting same issue, It fails on step 16 of
https://github.com/microsoft/TailwindTraders/tree/master/Documents/DemoScripts/Integrating%20Azure%20DevOps%2C%20Microsoft%20Teams%20and%20GitHub#integrating-azure-devops-microsoft-teams-and-github

Your help is much appreciated

Starting: Azure Deployment

Task : Azure resource group deployment
Description : Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines
Version : 2.166.1
Author : Microsoft Corporation
Help : https://docs.microsoft.com/azure/devops/pipelines/tasks/deploy/azure-resource-group-deployment

Checking if the following resource group exists: windtailtraders.
Resource group exists: true.
Creating deployment parameters.
##[error]Check out the troubleshooting guide to see if your issue is addressed: https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/deploy/azure-resource-group-deployment?view=azure-devops#troubleshooting
##[error]Error: Could not find any file matching the template file pattern
Finishing: Azure Deployment

Resource 'Microsoft.Web/sites/ under resource group 'myresgrp' was not found

In item 9 it is mentioned
Select the Variables tab and add the following variables as detailed below.

appservice-name | Your appservice-name

it is greyed out, I am not able to understand what this variable should have? I tried the my of
Container Registory
the name of my
Repository

When I create a release I get

2020-07-03T18:17:54.0154275Z [command]/usr/bin/az account set --subscription f151ee3f-4725-460d-8e3b-82512dfda843
2020-07-03T18:17:54.8737754Z [command]/usr/bin/pwsh -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Unrestricted -Command . '/home/vsts/work/_temp/azureclitaskscript1593800269234.ps1'
2020-07-03T18:17:58.0953285Z ResourceNotFound - The Resource 'Microsoft.Web/sites/sierac' under resource group 'IgniteLearningPath' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
2020-07-03T18:17:58.4543468Z ##[error]Script failed with exit code: 1
2020-07-03T18:17:58.4565142Z [command]/usr/bin/az account clear
2020-07-03T18:17:59.2981765Z ##[section]Finishing: Configure Container settings to App Service

Wjat should be the service name?
Thanks

Integrating Azure Pipelines, GitHub, and Azure Boards - Build fails because of missing Dockerfile

Following through the Azure Pipelines, GitHub and Azure Boards script, the build pipeline created by the Azure DevOps Demo Generator fails at the Build an Image step. The error is as follows:

##[error]Unhandled: No Dockerfile matching /home/vsts/work/1/s/Source/Dockerfile was found.

The Dockerfile section of the step contains a value of Source/Dockerfile which appears to be incorrect. Updating this value to Source/Tailwind.Traders.Web/Dockerfile allows the build to progress.

Migrate all Apps to Use GitHub Actions for CI/CD

All Tailwind Traders Apps should use GitHub Actions for CI/CD

• Backend (AKS)
• Website (ASP.NET & React)
• Desktop (WinForms & WPF -.NET Core)
• Rewards (ASP.NET Framework)
• Mobile (Xamarin Forms 4.0)
• Shipping Management (Power App + Azure Serverless)

These Actions should include

• A nightly one to ensure latest in main works
• One for merges into main
• One for PRs
• One for CodeQL Code Scanning (I added it but not sure if some are working)

Clean up App Provisioning

The provisioning of the app takes place in a bootstrap container. The container runs the following (for example):

https://github.com/microsoft/ignite-learning-paths-training-ops/blob/main/deployment/deploy.sh

which does a whole host of tasks including pre-loading the db, etc.

The actions for this script should instead be performed now in a ARM script action.

Also, the ARM templates include hardcoded regions

Search by photo - dividebyzero exception

trying to set up for a demo of the Tailwind website using product search by image - i am getting:
Exception thrown: 'System.DivideByZeroException' in Microsoft.ML.OnnxRuntime.dll

I get this using any of the test images in the Documents/TestImages folder

Demo script: Managing backend with Azure Kubernetes Service (AKS), can't find the files to donwload to storage account

I get an error when trying to follow these links:
product-list.zip: https://1drv.ms/u/s!Asa-selZwiFlg_QVhlC9O8sRaYcAvQ
coupon-list.zip: https://1drv.ms/u/s!Asa-selZwiFlg_QT-bBrsoBLq2yrSQ
product-detail.zip: https://1drv.ms/u/s!Asa-selZwiFlg_QUACkViDBOqpII_Q
profiles-list.zip: https://1drv.ms/u/s!Asa-selZwiFlg_QSAl40JUEPiKivDw

Would be nice to upgrade documentation to use Docker@2 instead of Docker@1

In the "Configuring the Azure Continuous Integration Pipeline"
https://github.com/microsoft/TailwindTraders/tree/master/Documents/DemoScripts/Integrating%20Azure%20DevOps%2C%20Microsoft%20Teams%20and%20GitHub#configuring-the-azure-continuous-integration-pipeline
section
the step to "Replace the default template with the below YAML snippet and substitute the below variables with relevant values" has sample code that uses Docker@1 instead of Docker@2.

While using Docker@1 worked when I tried it today, I believe Docker@2 is recommended now. Docker@2 is what is documented on docs.microsoft.com:
https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/build/docker?view=azure-devops
so it would be nice to update the documentation to use Docker@2 instead of Docker@1

Online demo takes 30 seconds to add an item to a list

I was just trying to learn more about this app but it's painful to use.

I was browsing the list of items and picked the first one from here to Add to List.
http://tailwindtraders.com/list/sink

After 30 seconds this page loads
http://tailwindtraders.com/product/detail/9

I'm not logged in and it happens with other items (tried a few).

Android App crashes when running release mode

When running the android app in Release mode, crashes loading the Login Page. Crashes with null exception where it says "No source code is available"

tailwindtraders.com is not functional.

I just noticed that the tailwindtraders public website is not functional:

1. Login with documented credentials doesn't work (login: [email protected], password: password).

   

2. Clicking on the menu links is not loading anything. Stuck on loading/spinner indicator.

   

3. The related Azure DevOps project seems to have been decommissioned.

   

Can anyone please take a look and verify?

Add Pre-Deployment Checks when possible

Similar to when you deploy a resource via the Azure Portal, we really should have checks in place to better ensure the deployment will succeed. Examples are

• checking resource names
• checking resource availability in regions