Challenge 00 - Prerequisites - Ready, Set, GO!

Home - Next Challenge >

Introduction

Thank you for participating in the Cosmic Troubleshooting What The Hack. Before you can hack, you will need to set up some prerequisites.

:warning: NOTE: This is not an Introduction to Cosmos DB hack. This hack assumes you already have a solid understanding on Azure Cosmos DB (and more specifically the Core API). If you need to skill-up with enough knowledge to get through this What The Hack, please have a look at the following resources:

• Work with NoSQL data in Azure Cosmos DB
• Azure Cosmos DB Labs - .NET (V3)

Common Prerequisites

We have compiled a list of common tools and software that will come in handy to complete most What The Hack Azure-based hacks!

You might not need all of them for the hack you are participating in. However, if you work with Azure on a regular basis, these are all things you should consider having in your toolbox.

• Azure Subscription
• Windows Subsystem for Linux
• Managing Cloud Resources
  • Azure Portal
  • Azure Powershell - v7.2 or newer required
    • Azure PowerShell Cmdlets
  • Azure CLI
    • Note for Windows Users
    • Azure PowerShell Cmdlets
  • Azure Cloud Shell
• Visual Studio Code
  • VS Code plugin for ARM Templates
  • VS Code plugin for Bicep
• Azure Storage Explorer

Description

Now that you have the common prerequisites installed on your workstation, there are prerequisites specific to this hack.

Your Azure Subscription should have a quota of at least 4 instances for Azure Load Testing. Please also ensure you have the Microsoft.LoadTestService Resource provider registered (How-To register a Resource provider)

Your coach will provide you with a Resources.zip file that contains resources you will need to complete the hack. If you plan to work locally, you should unpack it on your workstation. If you plan to use the Azure Cloud Shell, you should upload it to the Cloud Shell and unpack it there.

Please install these additional tools:

• .NET SDK 6.0 or later installed on your development machine. This can be downloaded from here for multiple platforms.

In the /Challenge00/ folder of the Resources.zip file given by your coach, you will find two deployment scripts that deploy a bicep template with the required services for the challenge, as well as building and deploying our sample web application.

Please deploy the infrastructure by running one of the following scripts in the /Challenge00/ folder:

• Powershell:

  # Update your Az Powershell commandlets
  Update-Module Az
  
  # Connect to your Azure Account
  Connect-AzAccount
  
  # Deploy the infrastructure
  # Please make sure you are using Powershell v7.2 or newer
  # You might need to unblock the file
  .\deploy.ps1 
  

• Bash:

  # Make sure your machine has the prerequisites
  # Also does an "az login"
  ./setup-machine.sh
  
  # Deploy the infrastructure
  ./deploy.sh
  

Success Criteria

To complete this challenge successfully, you should check:

• The deployment script (either Powershell or Bash) has completed successfully
• The deployment script has deployed in your subscription under a Resource Group called rg-wth-azurecosmosdb (if left at the default value) and it contains the following resources:
  • Azure App Service Plan
  • Azure Application Insights
  • Azure App Service
  • Azure Cosmos DB Account
  • Azure Load Testing
  • A Managed Identity
  • Azure Function App
• You should have a web application running in your Azure Web App.