About Azure Boards-GitHub integration
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Stay aligned and coordinated with Azure Boards and link your code activity and issues from GitHub.
Integrate Azure Boards and GitHub
Azure Boards and Azure DevOps support integration with GitHub.com and GitHub Enterprise Server repositories.
You can start from either Azure Boards or GitHub to integrate and connect up to 500 GitHub repositories to an Azure Boards project.
Azure Boards and Azure DevOps support integration with GitHub.com and GitHub Enterprise Server repositories.
You can start from either Azure Boards or GitHub to integrate and connect up to 500 GitHub repositories to an Azure Boards project.
Azure DevOps Server supports integration with GitHub Enterprise Server repositories.
You can start from either Azure Boards or GitHub to integrate and connect up to 100 GitHub repositories to an Azure Boards project.
Note
When you install the Azure DevOps Server 2020.1.1 Patch 2, you can create connections from your Azure DevOps Server to GitHub.com repositories in addition to GitHub Enterprise Server repositories.
Important
We recommend that you use the Azure Boards app for GitHub to configure and manage your connections to GitHub.com. The app provides a more streamlined configuration experience and has the advantage of authenticating and operating as the app rather than an individual. Once you're connected, you can manage the repositories either from Azure Boards or GitHub.com.
Use integration features
You can do the following tasks with Azure Boards-GitHub integration:
- Transition work items to a "Done" or "Completed" state with
fix
,fixes
, orfixed
in GitHub. - Post a comment to a GitHub commit, pull request, or issue when linked to a work item.
- Link from a work item to a GitHub commit, pull request, branch, or issue.
- View GitHub objects on a board.
- Configure status badges
- Manage GitHub repository access
- Troubleshoot Azure Boards-GitHub integration
- Enable DevSecOps with Azure and GitHub
Add or remove connections
- Add or remove GitHub repositories from Azure Boards.
- Change repository access to Azure Boards to change connections, suspend the integration, or uninstall the app.
Restrictions
- Only connect a GitHub repository to one Azure DevOps organization and project.
If you connect the same GitHub repo to projects defined in two or more Azure DevOps organizations, it can lead to unexpected AB# mention linking. For more information, see Troubleshoot GitHub & Azure Boards integration. - Azure DevOps can only integrate with GitHub repositories or Azure Repos Git repositories. Integration with other Git repositories isn't supported.
- You can't query for work items with links to GitHub artifacts. However, you can query for work items with an
External Link Count > 0
.