- Lab
- A Cloud Guru
Tracking Changes from GitHub in Azure Boards
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.
Path Info
Table of Contents
-
Challenge
Create a New Azure DevOps Organization
- Click All services in the left-hand menu, and select Azure DevOps.
- Click the My Azure DevOps Organizations link (this will open a new tab).
- Once the fields have auto-populated with the name, email, and location, click Continue.
- Under Get started with Azure DevOps, click Create new organization.
- If prompted to agree to the terms of service, click Continue.
- Choose a name for your new DevOps organization (the default will suffice).
- Choose the location Central US for the region to host your projects in, and click Create.
- Use the Demo Generator to populate the Azure Board.
- On the Demo Generator website, click Sign In, scroll to the bottom, and click Accept.
- On the Create New Project screen, select the organization you just created in the previous steps from the dropdown menu.
- Enter the project name "PartsUnlimited".
- Click Choose template, choose PartsUnlimited from the pop-up menu, and click Select Template.
- Click Create Project.
-
Challenge
(Optional) Create a New GitHub Account for Free
- In a new browser tab, navigate to https://github.com.
- Click Sign up.
- Create a new username, enter your email address, and create a new password.
- Click Verify to verify your account, and click Next: Select a plan.
- Under Choose a plan, select Choose Free.
- On the Welcome to GitHub page, scroll down and select Skip this step.
- GitHub should have 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 GitHub.com).
-
Challenge
Fork the PartsUnlimited Repo and Connect GitHub Account
- Fork the PartsUnlimited repo to your GitHub account.
- Open the Azure DevOps project you created in the first task.
- Click Project settings in the lower left corner.
- Select GitHub connections, and then Connect your GitHub account.
- Select Authorize AzureBoards when prompted (This directs you to GitHub.com temporarily).
- Back in your project settings, select the PartsUnlimited forked repo and click Save in the bottom right corner.
- Click Approve, Install, & Authorize when prompted (This directs you to GitHub.com temporarily).
-
Challenge
Change the Code in GitHub and View Tracking Info Within the Work Item
- Click Boards in the left-hand menu.
- Click Boards as the sub-menu item, and select PartsUnlimited Team boards.
- View the bug labeled Decline in orders noticed - Please Investigate immediately, and copy the issue number (needed for the following steps).
- Go over to the repository you forked in the previous task (in GitHub).
- Select the PartsUnlimited.Mobile.sln file from within the repository.
- Click the pencil icon to edit the file.
- Type in your changes to the file (e.g., add the comment "# Orders Change").
- Scroll down and enter your commit message and paste in the issue number (This must be in the format
fixed AB#<issue number>
). - Select Create a new branch for this commit and start a pull request, and click Propose file change.
- Leave a comment in the pull request (e.g., "change orders"), and click Create pull request.
- Click Merge pull request to merge this branch to the master branch, and click Confirm merge.
- 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.
-
Challenge
(Optional) Delete your GitHub Account
- Go to GitHub, and click your avatar in the upper right corner.
- Select Settings from the dropdown menu.
- Click Account in the left-hand menu.
- Click Delete your account.
- Type your username or email, and verify by typing in delete my account.
What's a lab?
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.
Provided environment for hands-on practice
We will provide the credentials and environment necessary for you to practice right within your browser.
Guided walkthrough
Follow along with the author’s guided walkthrough and build something new in your provided environment!
Did you know?
On average, you retain 75% more of your learning if you get time for practice.