About GitHub integration

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Boards and Azure Pipelines offer multiple integration points with GitHub and GitHub Enterprise. These integrations enable seamless collaboration between development and project management, enhancing traceability, workflow efficiency, and overall productivity. By connecting your GitHub repositories with Azure DevOps, you can streamline your development processes and gain better insights into your projects.

Authenticate and collaborate with GitHub

Feature	Description
Sign into Azure DevOps using your GitHub credentials	Allows users to sign in using their GitHub credentials and link their GitHub account to a Microsoft account. For more information, see Signing into Azure DevOps using your GitHub credentials (Release Notes).
Invite GitHub collaborators into Azure DevOps	Provides support for inviting GitHub account users to collaborate within an Azure DevOps project. For more information, see Invite GitHub collaborators into Azure DevOps (Release Notes).
Connect to a GitHub repository from Visual Studio	Provides a user interface to support cloning GitHub repositories, pushing and pulling commits, and more. For more information, see Side-by-side comparison of Git and Team Explorer.

Integrate Azure Boards with GitHub

By integrating Azure Boards with GitHub repositories, you can link GitHub commits, pull requests, branches, and issues to work items. This integration allows you to use GitHub for software development while using Azure Boards to plan and track your work. To get started, see Azure Boards-GitHub integration.

Benefits of integration

• Enhanced traceability: Link work items to GitHub commits, pull requests, branches, and issues for better traceability.
• Streamlined workflow: Use GitHub for development and Azure Boards for planning and tracking, ensuring a seamless workflow.
• Improved collaboration: Collaborate more effectively by connecting development activities in GitHub with project management in Azure Boards.

Features of Azure Boards and GitHub integration

Feature	Description
Link work items	Easily link work items to GitHub commits, pull requests, branches, and issues.
View linked objects	Quickly view and open linked objects from the board.
Add status badges	Add status badges of Azure Boards to a GitHub repository README file.
View release summary	Review work items linked to GitHub commits in the Release summary page.
Sync GitHub issues	Sync GitHub Issues to Azure Boards Work Items using the GitHub Action.

Integrate Azure Pipelines with GitHub

You can use Azure Pipelines to automatically build, test, package, release, and deploy your GitHub repository code. To get started, see Build GitHub repositories.

Additionally, you can map your GitHub repositories to one or more projects in Azure DevOps, enabling seamless integration and management across your development lifecycle.

Benefits of integration

• Automated workflows: Automatically build, test, package, release, and deploy your GitHub repository code using Azure Pipelines.
• Continuous integration and continuous deployment (CI/CD): Implement CI/CD practices to ensure that your code changes are automatically tested and deployed.
• Seamless integration: Map your GitHub repositories to one or more projects in Azure DevOps for seamless integration and management across your development lifecycle.
• Enhanced collaboration: Collaborate more effectively by linking work items to GitHub commits, pull requests, branches, and issues.
• Improved traceability: Achieve better traceability by reviewing work items linked to GitHub commits in the release summary page.
• Status badges: Add status badges of Azure Boards to a GitHub repository README file and display the build status.
• Issue synchronization: Sync GitHub Issues to Azure Boards work items using the GitHub Action for better issue tracking and management.

Features of Azure Pipelines and GitHub integration

Feature	Description
Create GitHub repository and pull request builds	- Automatically build your GitHub pull requests. After the build is done, status is reported back with a comment in your GitHub pull request. - Manually run a pipeline or test suite triggered by a GitHub pull request comment. - Configure draft PR validation for GitHub repository. Supports adding drafts to the pr trigger YAML syntax for GitHub draft pull requests. You can choose if you want your draft PRs to queue a build. The default option is true (a build is queued) like it currently is for GitHub PRs. - Rebuild GitHub pull request builds upon failure. Provides support for queueing a failed build. - Configure draft PR validation for GitHub repositories. - Automatically build pull requests from repository forks to ensure changes successfully build and tests pass before they get merged. For more information, see Build GitHub repositories.
Create GitHub Enterprise builds	- Supports continuous integration (CI) builds for GitHub Enterprise repositories. - Create a pipeline to build code contained within a GitHub Enterprise repository using the build pipeline wizard. For more information, see Build GitHub repositories, CI triggers.
Use GitHub service connections	The pipeline wizard automatically creates and reuses a service connection for the repository you choose. If you wish to manually choose a connection other than the one that is automatically selected, follow the Choose connection hyperlink. For more information, see Build GitHub repositories.
Manage GitHub releases	- Inline GitHub connection as a release artifact source. - Automate GitHub releases using the GitHub Release task. - Link your GitHub releases as an artifact source in release pipelines. This function lets you consume the GitHub release as part of your deployments. For more information, see CI triggers, Download GitHub Release task, and GitHub Release task.
Use build tags to trace GitHub sources or trigger GitHub releases	- Use build tags to trace GitHub sources to builds. While choosing a GitHub repository in a build definition, you can select the types of builds you want to tag, along with the tag format. - Specify a tag pattern to determine when to trigger a GitHub release. By specifying a tag regular expression, you can control when a GitHub release is created based on the triggering commit. For more information, see Build GitHub repositories, Label sources.
Support GitHub packages in YAML pipelines	In your YAML pipeline, specify a package type (NuGet or npm) that you want to consume from GitHub. For more information, see Resources: packages.
Get status checks, tracking, and traceability	- GitHub Checks: - Display status for each pipeline job: Run a pipeline or test suite to validate a GitHub pull request from the comments section of the GitHub pull request. - Send detailed information about the pipeline status, test, code coverage, and errors. Status is posted to GitHub Checks for each job in the pipeline. - Status badges: Add Markdown syntax to a GitHub repo README.md file and display the pipeline status. - GitHub artifacts: Show associated commits deployed in a release. To enhance traceability, you can see all the commits that were deployed to an environment for GitHub repositories, as a part of a specific release. - Track GitHub commits and associated issues in releases. List commits made in GitHub repos and the associated GitHub issues that are being deployed with a release. For more information, see Track GitHub commits and associated issues in releases (Release Notes). For more information, see: - Create your first pipeline, Add a status badge to your repository - GitHub Checks API - Display status for each pipeline job in GitHub Checks (Release Notes)

Related articles

• Azure Boards-GitHub integration
• Build GitHub repositories
• Git experience in Visual Studio