Tracking Changes from GitHub in Azure Boards

45 minutes
  • 5 Learning Objectives

About this Hands-on Lab

In this hands-on lab, you will be integrating a GitHub repository with your Kanban board in Azure DevOps. The integration will allow you to track commits, pull requests, and merges in your GitHub repository and automatically sync those changes with Azure Boards, so you can better visualize work in progress.

Learning Objectives

Successfully complete this lab by achieving the following learning objectives:

Create a New Azure DevOps Organization
  1. Click All services in the left-hand menu, and select Azure DevOps.
  2. Click the My Azure DevOps Organizations link (this will open a new tab).
  3. Once the fields have auto-populated with the name, email, and location, click Continue.
  4. Under Get started with Azure DevOps, click Create new organization.
  5. If prompted to agree to the terms of service, click Continue.
  6. Choose a name for your new DevOps organization (the default will suffice).
  7. Choose the location Central US for the region to host your projects in, and click Create.
  8. Use the Demo Generator to populate the Azure Board.
  9. On the Demo Generator website, click Sign In, scroll to the bottom, and click Accept.
  10. On the Create New Project screen, select the organization you just created in the previous steps from the dropdown menu.
  11. Enter the project name "PartsUnlimited".
  12. Click Choose template, choose PartsUnlimited from the pop-up menu, and click Select Template.
  13. Click Create Project.
(Optional) Create a New GitHub Account for Free
  1. In a new browser tab, navigate to
  2. Click Sign up.
  3. Create a new username, enter your email address, and create a new password.
  4. Click Verify to verify your account, and click Next: Select a plan.
  5. Under Choose a plan, select Choose Free.
  6. On the Welcome to GitHub page, scroll down and select Skip this step.
  7. GitHub has just sent you an email. Click the link inside the email to verify your email address. (Once you’ve clicked the link in the email, you are brought back to
Fork the PartsUnlimited Repo and Connect GitHub Account
  1. Fork the PartsUnlimited repo to your GitHub account.
  2. Open the Azure DevOps project you created in the first task.
  3. Click Project settings in the lower left corner.
  4. Select GitHub connections and then Connect your GitHub account.
  5. Select Authorize AzureBoards when prompted. (This directs you to temporarily.)
  6. Back in your project settings, select the PartsUnlimited forked repo and click Save in the bottom right corner.
  7. Click Approve, Install, & Authorize when prompted. (This directs you to temporarily.)
Change the Code in GitHub and View Tracking Info Within the Work Item
  1. Click Boards in the left-hand menu.
  2. Click Boards as the sub-menu item, and select PartsUnlimited Team boards.
  3. View the bug labeled Decline in orders noticed – Please Investigate immediately, and copy the issue number (needed for the following steps).
  4. Go over to the repository you forked in the previous task (in GitHub).
  5. Select the PartsUnlimited.Mobile.sln file from within the repository.
  6. Click the pencil icon to edit the file.
  7. Type in your changes to the file (e.g., add the comment "# Orders Change").
  8. Scroll down and enter your commit message and paste in the issue number. (This must be in the format fixed AB#<issue number>).
  9. Select Create a new branch for this commit and start a pull request, and click Propose file change.
  10. Leave a comment in the pull request (e.g., "change orders"), and click Create pull request.
  11. Click Merge pull request to merge this branch to the master branch, and click Confirm merge.
  12. Go back to the Kanban board and view the changes, as they were automatically synced with the work item. Notice the issue has been moved across the board into the Done lane.
(Optional) Delete your GitHub Account
  1. Go to GitHub, and click your avatar in the upper right corner.
  2. Select Settings from the dropdown menu.
  3. Click Account in the left-hand menu.
  4. Click Delete your account.
  5. Type your username or email, and verify by typing in "delete my account."

Additional Resources

With the provided credentials, log in to the Azure Portal and create a new Azure DevOps organization. Proceed to create a new project or import an existing project (with work items pre-populated) using the Demo Generator.

In order to synchronize your GitHub account with Azure DevOps, you will create and authenticate a connection in the project settings. You may use your existing GitHub account or create a new one for free.

Once you have connected your GitHub account to an existing project, create a change to the code, create a new branch for the commit, create a pull request, and then merge into the master branch. You should see all these changes automatically appear in the Kanban Board.

Note: Your commit messages must be in the following format: fixed AB#<issue number> (e.g., fixed AB#123).

What are Hands-on Labs

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Sign In
Welcome Back!

Psst…this one if you’ve been moved to ACG!

Get Started
Who’s going to be learning?