Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 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.
- Install and configure the Azure Boards app for GitHub
- Approve and install the Azure Boards app
- Connect Azure DevOps Server to GitHub Enterprise Server (on-premises)
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, orfixedin 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.