Share via

About GitHub integration

  • Article

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
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 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. For more information, see Build GitHub repositories, CI triggers.
Use GitHub-specific tasks and utilities Supported tasks include Download GitHub Release task, GitHub Release task, and Open source Azure Pipelines tasks.
Manage GitHub releases Inline GitHub connection as a release artifact source. Automate GitHub releases using the GitHub Release task. For more information, see CI triggers, Download GitHub Release task, and GitHub Release task.
Filter GitHub branches for GitHub, GitHub Enterprise, or external Git artifacts Configure the specific branches to release when you release from GitHub, GitHub Enterprise, or external Git repositories. For more information, see Release triggers, Continuous deployment triggers.
Use build tags to trace GitHub sources 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. For more information, see Build GitHub repositories, Label sources.