关于 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 机器人
- 在 数据变量.product.prodname_ghe_server %} 的管理控制台中,打开 聊天集成 页面,然后勾选 启用 数据变量.product.github %} 聊天集成 复选框。
- 在“选择聊天客户端”下,选择 Microsoft Teams,并按照链接在 azure Microsoft 中注册应用。
- 在 Azure 中,配置应用注册的详细信息:
- 输入应用程序注册 名称。
- 将支持的帐户类型设置为 多个 Entra ID 租户 ,并允许 所有租户。
- 单击“注册”。
- 记录显示的应用程序(客户端)ID 和租户 ID。
- 在 “证书和机密”下,创建新的客户端密码。
- 记录显示的客户端机密值。
- 返回到您的 GitHub Enterprise Server 实例中的 管理控制台 和 聊天集成 页面。
- 单击“部署到 Azure”,然后按照提示在 Microsoft Azure 中配置 Teams 机器人。
- 在 Azure 中,选择要部署的 Azure 机器人的 订阅 和 资源组 。
- 在 Teams 机器人配置中输入之前记录的应用程序(客户端)ID 和租户 ID。
- 取决于 GitHub Enterprise Server 的网络配置:
- 如果实例在公共 Internet 上 可达,请勾选 在路径中追加'_msteams' 复选框。
- 如果您的实例在公共 Internet 上 不可访问,并且需要代理:
- 确保未选中 在路径中追加 "_msteams" 的 复选框。
- 在 GHES 实例主机名 字段中,输入将流量转发到实例的 URL。
- 单击“ 审阅 + 创建 ”选项卡,然后单击“ 创建 ”以保存设置并开始预配应用。
- 等待 Teams 机器人在 Azure 中进行预配。
配置 GitHub Enterprise Server 并在 Teams 中安装应用
- 请返回到 管理控制台 和您的 GitHub Enterprise Server 实例中的聊天工具集成页面。
- 输入 Microsoft客户端 ID、Microsoft客户端密钥 和 Microsoft租户 ID,使用之前记录的应用程序详细信息。
- (可选)如果您的 GitHub Enterprise Server 实例在公共互联网无法直接访问,并且需要使用代理,请在 公共终结点 URL 字段中输入将流量转发到您实例的 URL。
- 单击“ 保存客户端设置”。
- 单击“ 生成清单 ”下载集成清单以供以后使用。
- 单击“ 保存设置” ,将更改应用到实例。
- 登录到 Teams 客户端,并打开 Teams 管理中心。
- 转到 Teams 应用 > 管理应用,然后点击上传以上传在前一步下载的集成清单文件。 有关详细信息,请参阅 将应用上传到 Teams。
- 在 Teams 中安装应用,然后运行
@GHE signin以连接 GitHub 帐户。
延伸阅读
-
[AUTOTITLE](/integrations/how-tos/teams/use-github-in-teams) - 了解如何为 Teams 使用 GitHub 集成。 -
[AUTOTITLE](/integrations/how-tos/teams/customize-notifications) - 了解如何在 Teams 中自定义 GitHub 的通知设定。