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. 在 数据变量.product.prodname_ghe_server %} 的管理控制台中,打开 聊天集成 页面,然后勾选 启用 数据变量.product.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 实例在公共互联网无法直接访问,并且需要使用代理,请在 公共终结点 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 的通知设定。