Skip to content

Latest commit

 

History

History
65 lines (42 loc) · 4.58 KB

Setup.md

File metadata and controls

65 lines (42 loc) · 4.58 KB

Challenge 1 - Setup

Prerequisities

  1. Your laptop: Win, MacOS or Linux
  2. Your GitHub account, if not yet it's time to create one! ;)
  3. Your Azure Subscription
  4. Your Azure DevOps account, if not yet it's time to create one! ;)

Introduction

Set up your local environment.

The first challenge is to setup an environment that will help you build the Rock Paper Scissors Boom! Game Server and deploy it locally. We need to make sure everything is working before bringing it to Azure.

To really do this locally, you would need the app platform (.NET Core, SQL Server, IIS, etc) running locally. We probably do not have enough time for that. Enter Azure! We can set up server in Azure to replicate a local environment where we can build our application and test deploying it. All we need running on that server is Docker and we can leverage containers for building and deploying the application; even hosting the database!

But, even in that case, we need some tools locally to manage Azure and that can take a while to setup. The good news is that by using the Azure Shell - we have all the tools we need. All we really need is a browser and an Azure subscription.

The use of Azure Cloud Shell is our recommendation to simplify your experience. But if you prefer using your local machine to do the lab, feel free to do it. Based on our experience, the setup of Docker on local machine (which is required for the challenges) could take some time and could have some issues.*

Setting up this mock local environment is important. We will be using this environment for future challenges.

Challenges

  1. Fork this repo in your GitHub account. We want you to create your own fork so that if you have suggestions or fixes, you can issue a pull-request and submit them back to the main repo.
  2. Clone your repo in Azure Cloud Shell
    • cloning the entire WhatTheHack repo will take several minutes.
    • Make sure you clone your OWN fork of the repo, not the Microsoft/WhatTheHack repo.
    • We recommend using Bash (Linux) mode in the cloud shell for this Hack
    • Have limited screen real estate? Try the full screen shell
  3. Setup a VM in Azure that will be your Docker Host. This is the VM where you will build the application, deploy it and test it. Azure Cloud Shell has the Docker client installed. You will be able to connect the Docker Client in Azure Cloud Shell to your VM. (instructions here).

Optional Challenges

  1. Create a new Private project in Azure DevOps (with Git and Agile under advanced options)
    1. The source code will be in GitHub, but the rest (backlog, build, release and tests) will be in Azure DevOps.
  2. Populate your Azure DevOps (Boards) backlog with user stories (work items). One user story per challenge. (List of challenges in the ReadMe)

Success criteria

  1. In Azure Cloud Shell, make sure git status is showing you the proper branch
  2. In Azure Cloud Shell, make sure docker images command runs successfuly (without error).
  3. In Azure Cloud Shell, let's play with the following commands: ls -la, git version, az --version, docker images, code ., etc.

Tips

  1. In Azure Cloud Shell, you will leverage the Bash (Linux) mode, we all love Linux! <3
  2. To create the Docker Host VM in Azure and connect to it, follow these instructions.

Advanced challenges

Too comfortable? Eager to do more? Here you are:

  1. Instead of leveraging Azure Cloud Shell and a Docker Host VM in Azure to build your images and run them, you could do that locally on your laptop by installing Docker CE and Docker-compose.
  2. Instead of leveraging GitHub to host your source code, you could leverage Azure Repos (Git) in Azure DevOps.

Learning resources

Next challenge (Run the App) >