Skip to main content

将 GitHub 与 Teams 集成

设置与 Teams 的GitHub集成,以改进协作并简化工作流。

关于 GitHub 的 Teams 集成

GitHub 集成适用于 Microsoft Teams,使你和你的团队可以直接在 Teams 频道中查看和监控 数据变量.product.github %} 项目。 你可以对问题进行筛选、协作处理拉取请求,并跟踪更改,而无需离开 Teams。

通过 GitHub 的 Teams 集成,你可以:

  • 在 Teams 频道中获取 GitHub 通知
  • 使用 命令 对 GitHub 执行操作。
  • 共享指向 GitHub 资源的链接时,查看预览

向 GitHub 应用授予对 Teams 工作区的访问权限时,你将向其授予某些权限。 提供的权限是应用正常运行所必需的,并提供所需的功能。 请参阅“Teams 中的 GitHub 权限”。

先决条件

若要使用适用于 Teams 的 GitHub 集成,需要,

  • GitHub 帐户。
  • 你有权安装应用的 Teams 工作区。

在 GitHub Enterprise Server 上为 Teams 安装 GitHub 集成

要将 GitHub Enterprise Server 与 Microsoft Teams 集成,你首先需要在你的实例上配置聊天集成,并在 Microsoft Azure 中注册一个应用。

注册应用并预配 Teams 机器人

  1. 在 GitHub Enterprise Server 实例的 管理控制台 中,打开聊天集成页面,然后选中启用 GitHub 聊天集成复选框。
  2. 在“选择聊天客户端”下,选择 Microsoft Teams,并按照链接在 azure Microsoft 中注册应用。
  3. 在 Azure 中,配置应用注册的详细信息:
    • 输入应用程序注册 名称
    • 将支持的帐户类型设置为 多个 Entra ID 租户 ,并允许 所有租户
  4. 单击“注册”。
  5. 记录显示的应用程序(客户端)ID 和租户 ID。
  6. “证书和机密”下,创建新的客户端密码。
  7. 记录显示的客户端机密值。
  8. 返回到您的 GitHub Enterprise Server 实例中的 管理控制台 和 聊天集成 页面。
  9. 单击“部署到 Azure”,然后按照提示在 Microsoft Azure 中配置 Teams 机器人。
  10. 在 Azure 中,选择要部署的 Azure 机器人的 订阅资源组
  11. 在 Teams 机器人配置中输入之前记录的应用程序(客户端)ID 和租户 ID。
  12. 取决于 GitHub Enterprise Server 的网络配置:
    • 如果实例在公共 Internet 上_可访问_,请选中将“_msteams”追加到路径中复选框。
    • 如果您的实例在公共 Internet 上 不可访问,并且需要代理:
      • 确保未选中将“_msteams”追加到路径中复选框。
      • GHES 实例主机名 字段中,输入将流量转发到实例的 URL。
  13. 单击“ 审阅 + 创建 ”选项卡,然后单击“ 创建 ”以保存设置并开始预配应用。
  14. 等待 Teams 机器人在 Azure 中进行预配。

配置 GitHub Enterprise Server 并在 Teams 中安装应用

  1. 在 GitHub Enterprise Server 实例上返回到 管理控制台 和聊天集成页面。
  2. 输入 Microsoft客户端 IDMicrosoft客户端密钥Microsoft租户 ID,使用之前记录的应用程序详细信息。
  3. (可选)如果你的 GitHub Enterprise Server 实例在公共 Internet 上_无法访问_,并且需要代理,请在公共终结点 URL 字段中输入将流量转发到你的实例的 URL。
  4. 单击“ 保存客户端设置”。
  5. 单击“ 生成清单 ”下载集成清单以供以后使用。
  6. 单击“ 保存设置” ,将更改应用到实例。
  7. 登录到 Teams 客户端,并打开 Teams 管理中心。
  8. 转到 Teams 应用 > 管理应用,然后单击上传以上传在上一步中下载的集成清单。 有关详细信息,请参阅 将应用上传到 Teams
  9. 在 Teams 中安装应用,然后运行 @GHE signin 以连接 GitHub 帐户。

延伸阅读

  •         [AUTOTITLE](/integrations/how-tos/teams/use-github-in-teams) - 了解如何为 Teams 使用 GitHub 集成。
    
  •         [AUTOTITLE](/integrations/how-tos/teams/customize-notifications) - 了解如何在 Teams 中自定义 GitHub 的通知设定。