Exercise - Set up the environment

Completed

In this unit, you'll use a script to deploy the existing eShopOnContainers app to AKS.

Launch Azure Cloud Shell

  1. Open the Azure Cloud Shell in your browser.
  2. Select a directory with access to the Azure subscription in which you want to create resources.
  3. Select Bash from the environment drop-down in the upper left.

Run deployment script

Run the following command in the command shell:

. <(wget -q -O - https://aka.ms/microservices-resiliency-aspnet-core-setup)

Tip

You can use the Copy button to copy commands to the clipboard. To paste, right-click on a new line in the Cloud Shell window and select Paste or use the Shift+Insert keyboard shortcut (⌘+V on macOS).

The preceding command retrieves and runs a setup script from a GitHub repository. The script completes the following steps:

  • Installs the required version of the .NET Core SDK.
  • Installs the Linkerd CLI.
  • Clones the eShopOnContainers app from a GitHub repository.
  • Provisions AKS and Azure Container Registry (ACR) resources.
  • Launches the Cloud Shell editor to view the code.
  • Deploys the containers to a fully managed Kubernetes service in Azure, known as AKS.
  • Displays connection information upon completion.

Important

The script installs the required version of the .NET Core SDK alongside the version pre-installed in Azure Cloud Shell. To revert to the default configuration in Cloud Shell, see the instructions in the Summary unit.

The script deploys a modified version of the eShopOnContainers reference app. The solution architecture of the app is pictured in the following diagram:

eShopOnContainers solution architecture diagram

This module focuses on adding resiliency to the coupon service depicted in the preceding diagram.

The script takes several minutes to complete. While the script is running, continue to the next unit to review resiliency concepts.

Note

Non-blocking warnings are expected in the deployment process. An unexpected exception may occur, or the script may enter a Retrying in 5s... loop with no sign of exiting. In the event of an exception, or if the loop has been running for about 5 minutes, reset any changes made by the script. Press Ctrl+C (⌘+C on macOS) to stop the script. Then run the following command:

cd ~ && \
  rm -rf ~/clouddrive/aspnet-learn && \
  az group delete --name eshop-learn-rg --yes

You may then re-run the setup script.