将 GitHub 链接到 Azure Boards

GitHub 与 Azure Boards 之间的集成创建了一种功能强大的混合方法，将 GitHub 的开发人员友好环境与 Azure Boards 的企业规划功能相结合。 通过此连接，组织可以保持集中式项目治理，同时允许开发团队在其首选 GitHub 环境中工作。

集成的业务优势：

• 统一可见性：利益干系人无需直接访问 GitHub 即可跟踪开发进度
• 合规性和审核：在保留开发人员工作流时保持正式项目跟踪
• 跨职能协作：弥合项目经理与开发团队之间的差距
• 自动同步：减少使项目状态保持最新状态的手动开销

Azure Boards 应用：集成基础

Azure Boards 应用充当在 GitHub 和 Azure Boards 之间实现无缝数据流的技术桥。 此市场应用程序提供安全、经过身份验证的访问，同时保持这两个平台的完整性。

关键集成功能：

• 双向链接：使用 GitHub 提交、PR 和问题连接 Azure Boards 工作项
• 自动状态转换：当 GitHub 引用包含关键字（如“修复”）时完成工作内容
• 实时同步：GitHub 中的更改立即反映在 Azure Boards 中
• 灵活的范围控制：选择组织范围或选择性存储库集成

安装要求和权限

GitHub 先决条件：

• 存储库访问权限：目标存储库的管理员或所有者权限
• 组织权限：全组织安装所有者角色
• 市场访问：能够从 GitHub 市场安装应用程序

Azure DevOps 先决条件：

• 项目集合管理员：初始连接设置所必需的
• 项目权限：贡献者访问权限或更高的访问权限以查看链接的工作项
• 身份验证凭据：用于安全 API 访问的 PAT 或 OAuth

身份验证和安全注意事项

安全身份验证对于维护两个平台的数据完整性和访问控制至关重要。 Azure Boards 支持多种身份验证方法，每个方法具有特定的安全影响和用例。

GitHub 身份验证选项：

安全最佳做法：

• 最低权限原则：仅授予集成功能所需的权限
• 令牌轮换：定期更新 PAT 并查看访问权限
• 审核日志记录：监视集成活动以发现异常访问模式
• 存储库隔离：仅连接需要 Azure Boards 集成的存储库

分步连接过程：

1. 从 GitHub 市场安装 Azure Boards 应用
2. 配置存储库访问 （所有存储库或选择性）
3. 使用首选方法通过 Azure DevOps 进行身份验证
4. 将存储库映射到 Azure Boards 中的项目
5. 测试集成 包含示例链接和提交

有关详细的实施指南，请参阅： 将 Azure Boards 连接到 GitHub

配置灵活性和管理

GitHub 端管理功能：

• 存储库范围控制：添加或删除集成中的特定存储库
• 项目映射：配置哪些 Azure Boards 项目连接到每个存储库
• 暂停集成：暂时禁用而保留配置
• 完全删除：卸载应用并删除所有连接

Azure Boards 端管理功能：

• 多存储库连接：将多个 GitHub 存储库链接到单个项目
• 跨项目链接：允许存储库连接到多个 Azure Boards 项目
• 连接运行状况监视：跟踪集成状态并解决连接问题
• 权限管理：控制哪些用户可以修改 GitHub 连接

支持的集成方案

Azure Boards-GitHub 集成支持以下连接：

• 从 GitHub：

  • 支持集成 GitHub 帐户或组织的所有存储库，或选择存储库。
  • 添加或删除参与集成的 GitHub 存储库，并配置它们连接到的项目。
  • 暂停 Azure Boards-GitHub 集成或卸载应用。

• 来自 Azure Boards：

  • 将一个或多个 GitHub 存储库连接到 Azure Boards 项目。
  • 在 Azure Boards 项目中的 GitHub 连接中添加或删除 GitHub 存储库。
  • 完全删除项目的 GitHub 连接。
  • 允许 GitHub 存储库连接到同一 Azure DevOps 组织或集合中的一个或多个 Azure Boards 项目。

Azure Boards-GitHub 集成支持以下操作任务：

• 创建工作项与 GitHub 提交、拉取请求和基于 GitHub 提及的问题之间的链接。
• 支持在使用 GitHub 提及内容时使用“修复”或“已修复”将工作项的状态转换为“已结束”或“已完成”状态。
• 在从工作项链接到 GitHub 提交、拉取请求或问题时，向 GitHub 发布讨论注释，从而支持完全可跟踪性。
• 在工作项“开发”部分显示链接到 GitHub 的代码项目。
• 在看板卡片上将链接到 GitHub 的项目显示为注释。
• 支持添加到 GitHub 存储库的看板列的状态徽章。

目前不支持以下任务：

• 使用指向 GitHub 项目的链接查询工作项。 但是，可以查询外部链接计数大于 0 的工作项。

有关详细信息，请参见:

• 更改 GitHub 存储库访问权限，或者暂停或卸载集成。
• 添加或删除 GitHub 存储库。
• 有关链接到工作项的详细信息，请参阅将 GitHub 提交、拉取请求和问题链接到工作项。