| title | titleSuffix | description | ms.custom | ms.service | ms.topic | ms.author | author | monikerRange | ms.date |
|---|---|---|---|---|---|---|---|---|---|
Azure Boards-GitHub integration |
Azure Boards |
Manage code in GitHub and link to GitHub commits, pull requests, and issues in Azure Boards |
boards-get-started |
azure-devops-boards |
overview |
chcomley |
chcomley |
>= azure-devops-2019 |
06/19/2023 |
[!INCLUDE version-gt-eq-2019]
Stay aligned and coordinated with Azure Boards and link your code activity and issues from GitHub.
:::moniker range="> azure-devops-2022" 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.
- Install and configure the Azure Boards app for GitHub
- Connect an Azure Boards project to one or more GitHub repositories
:::moniker-end
:::moniker range="= azure-devops-2022" 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.
- Install and configure the Azure Boards app for GitHub
- Connect an Azure Boards project to one or more GitHub repositories
:::moniker-end
::: moniker range="< azure-devops-2022" 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. ::: moniker-end :::moniker range="azure-devops-2020"
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. :::moniker-end ::: moniker range="< azure-devops-2022"
- 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)
::: moniker-end
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.
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, 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 GitHub repositories from Azure Boards.
- Change repository access to Azure Boards to change connections, suspend the integration, or uninstall the app.
- 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.