Exercise - Set up your Azure DevOps environment

In this unit, you'll ensure that your Microsoft Azure DevOps organization is set up to complete the rest of this module.

To do this, you'll:

Get the Azure DevOps project

Here, you'll ensure that your Azure DevOps organization is set up to complete the rest of this module. You do this by running a template that creates a project for you in Azure DevOps.

The modules in this learning path form a progression, where you follow the Tailspin web team through their DevOps journey. For learning purposes, each module has an associated Azure DevOps project.

Run the template

Run a template that sets up your Azure DevOps organization.

1. Get and run the ADOGenerator project in Visual Studio or the IDE of your choice.

2. When prompted to Enter the template number from the list of templates, enter 23 for Implement a code workflow in your build pipeline using Git and GitHub, then press Enter.

3. Choose your authentication method. You can set up and use a Personal Access Token (PAT) or use device login.

   Note

   If you set up a PAT, make sure to authorize the necessary scopes. For this module, you can use Full access, but in a real-world situation, you should ensure you grant only the necessary scopes.

4. Enter your Azure DevOps organization name, then press Enter.

5. If prompted, enter your Azure DevOps PAT, then press Enter.

6. Enter a project name such as Space Game - web - Workflow, then press Enter.

7. Once your project is created, go to your Azure DevOps organization in your browser (at https://dev.azure.com/<your-organization-name>/) and select the project.

Fork the repository

If you haven't already, fork the mslearn-tailspin-spacegame-web repository.

1. On GitHub, go to the mslearn-tailspin-spacegame-web repository.

2. Select Fork at the top-right of the screen.

3. Choose your GitHub account as the Owner, then select Create fork.

Set your project's visibility

Initially, your fork of the Space Game repository on GitHub is set to public while the project created by the Azure DevOps template is set to private. A public repository on GitHub can be accessed by anyone, while a private repository is only accessible to you and the people you choose to share it with. Similarly, on Azure DevOps, public projects provide read-only access to non-authenticated users, while private projects require users to be granted access and authenticated to access the services.

At the moment, it is not necessary to modify any of these settings for the purposes of this module. However, for your personal projects, you must determine the visibility and access you wish to grant to others. For instance, if your project is open source, you may choose to make both your GitHub repository and your Azure DevOps project public. If your project is proprietary, you would typically make both your GitHub repository and your Azure DevOps project private.

Later on, you may find the following resources helpful in determining which option is best for your project:

• Use private and public projects
• Quickstart: Make your private project public
• Setting repository visibility

Move the work item to Doing

In this section, you'll assign yourself a work item that relates to this module on Azure Boards. You'll also move the work item to the Doing state. In practice, you and your team would create work items at the start of each sprint or work iteration.

Assigning work in this way gives you a checklist from which to work. It gives others on your team visibility into what you're working on and how much work is left. It also helps the team enforce work in process (WIP) limits so that the team doesn't take on too much work at one time.

Recall that the team settled on these seven top issues:

Here, you'll move the second item, Create a Git-based workflow, to the Doing column and assign yourself to the work item.

Recall that Create a Git-based workflow relates to moving to a code workflow that enables better collaboration among team members.

To set up the work item:

1. In Azure DevOps, select Boards in the left pane, then select Boards.

   

2. In the Create a Git-based workflow work item, select the To Do down arrow, and then assign the work item to yourself.

   

3. Drag the work item from the To Do column to the Doing column.

   

At the end of this module, after you've completed the task, you'll move the item to the Done column.

Set up the project locally

Here, you load the Space Game project in Visual Studio Code, configure Git, clone your repository locally, and set the upstream remote so that you can download the starter code.

Open the integrated terminal

Visual Studio Code comes with an integrated terminal, so you can edit files and work from the command line all in one place.

1. Start Visual Studio Code.

2. On the View menu, select Terminal.

3. In the dropdown list, select bash. If you're familiar with another Unix shell that you prefer to use, such as Zsh, select that shell instead.

   

   The terminal window lets you choose any shell that's installed on your system, like Bash, Zsh, and PowerShell.

   Here you'll use Bash. Git for Windows provides Git Bash, which makes it easy to run Git commands.

   Note

   On Windows, if you don't see Git Bash listed as an option, make sure you've installed Git, and then restart Visual Studio Code.

4. Run the cd command to navigate to the directory you want to work from, like your home directory (~). You can choose a different directory if you want.

   cd ~
   

Configure Git

If you're new to Git and GitHub, you first need to run a few commands to associate your identity with Git and authenticate with GitHub.

Set up Git explains the process in greater detail.

At a minimum, you'll need to complete the following steps. Run these commands from the integrated terminal:

1. Set your username.
2. Set your commit email address.
3. Cache your GitHub password.

Set up your project in Visual Studio Code

In this part, you clone your fork locally so that you can make changes and build out your pipeline configuration.

Clone your fork locally

You now have a copy of the Space Game web project in your GitHub account. Now you'll download, or clone, a copy to your computer so you can work with it.

A clone, just like a fork, is a copy of a repository. When you clone a repository, you can make changes, verify they work as you expect, and then upload those changes back to GitHub. You can also synchronize your local copy with changes other authenticated users have made to GitHub's copy of your repository.

To clone the Space Game web project to your computer:

1. Go to your fork of the Space Game web project (mslearn-tailspin-spacegame-web) on GitHub.

2. Select Code. Then, from the HTTPS tab, select the button next to the URL that's shown to copy the URL to your clipboard.

   

3. In Visual Studio Code, go to the terminal window.

4. In the terminal, move to the directory you want to work from, like your home directory (~). You can choose a different directory if you want.

   cd ~
   

5. Run the git clone command. Replace the URL that's shown here with the contents of your clipboard:

   git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
   

6. Move to the mslearn-tailspin-spacegame-web directory. This is the root directory of your repository.

   cd mslearn-tailspin-spacegame-web
   

Set the upstream remote

A remote is a Git repository where team members collaborate (like a repository on GitHub). Here you list your remotes and add a remote that points to Microsoft's copy of the repository so that you can get the latest sample code.

1. Run this git remote command to list your remotes:

   git remote -v
   

   You see that you have both fetch (download) and push (upload) access to your repository:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
   

   Origin specifies your repository on GitHub. When you fork code from another repository, it's common to name the original remote (the one you forked from) as upstream.

2. Run this git remote add command to create a remote named upstream that points to the Microsoft repository:

   git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
   

3. Run git remote a second time to see the changes:

   git remote -v
   

   You see that you still have both fetch (download) and push (upload) access to your repository. You also now have fetch and push access to the Microsoft repository:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)
   

Open the project in the file explorer

In Visual Studio Code, your terminal window points to the root directory of the Space Game web project. To view its structure and work with files, from the file explorer, you'll now open the project.

1. The easiest way to open the project is to reopen Visual Studio Code in the current directory. To do so, run the following command from the integrated terminal:

   code -r .
   

   You see the directory and file tree in the file explorer.

2. Reopen the integrated terminal. The terminal places you at the root of your web project.

If the code command fails, you need to add Visual Studio Code to your system PATH. To do so:

1. In Visual Studio Code, select F1 or select View > Command Palette to access the command palette.
2. In the command palette, enter Shell Command: Install 'code' command in PATH.
3. Repeat the previous procedure to open the project in the file explorer.

You're now set up to work with the Space Game source code and your Azure Pipelines configuration from your local development environment.