安装 GitHub Insights

您可以安装 GitHub Insights 并将独立应用程序连接到 GitHub Enterprise Server。

GitHub Enterprise 中对 "github/insights-releases" 仓库具有读取权限以及对应用程序服务器具有管理权限的组织所有者可以安装 GitHub Insights。

GitHub Insights 可用于 GitHub One。更多信息请参阅“GitHub 的产品”。

本文内容

基本要求
创建 GitHub 应用程序
安装 GitHub Insights
配置 GitHub Insights
延伸阅读

基本要求

您必须拥有包含 GitHub Insights 的 GitHub Enterprise 许可文件。在购买 GitHub Insights 后，您可以在 GitHub Enterprise 网站门户中下载更新的许可文件。
GitHub Insights 需要一台托管在云端或本地的机器，称为应用程序服务器。更多信息请参阅“GitHub Insights 的系统概述”。
您必须在应用程序服务器上安装依赖项。
- Docker 1.13.0+
- Docker Compose v1.17.0+
注意： 应用程序服务器可能需要 Docker 守护程序以 sudo 身份运行。不支持 Kubernetes。

创建 GitHub 应用程序

要将 GitHub Insights 连接到 GitHub Enterprise，您必须在 GitHub Enterprise 上的组织中创建 GitHub 应用程序。当您的集成执行操作时，应用程序名称的缓存版本将显示在 GitHub Enterprise 上。

登录到 http(s)://HOSTNAME/login 上的您的 GitHub Enterprise Server 实例。
导航至要连接到 GitHub Insights 的组织。
在组织名称下，单击 Settings（设置）。
在左侧边栏中，单击 GitHub 应用程序。
单击新建 GitHub 应用程序。
在“GitHub 应用程序名称”下，输入应用程序的名称。您的应用程序不能与现有用户或组织同名，除非该名称是您自己拥有的用户或组织名称。
在“Homepage URL（主页 URL）”下，输入用于 GitHub Insights 的应用程序服务器的 URL。更多信息请参阅“GitHub Insights 的系统概述”。
在“User authorization callback URL（用户授权回调 URL）”下，输入以下内容，将 <application-server-url> 替换为应用程序服务器的 URL。
```
<application-server-url>/public/applogin
```
在“Setup URL（设置 URL）”下，输入 <application-server-url>/public/setup。
在“Webhook URL（Web 挂钩 URL）”，输入 <application-server-url>/webhooks。
在“Webhook secret（Web 挂钩密码）”下，输入密码，然后记录该密码供以后参考。
在“Permissions（权限）”下，使用下拉菜单为应用程序配置以下权限。
- 仓库:
  - 内容：Read-only（只读）
  - 元数据：Read-only（只读）
  - 拉取请求：Read-only（只读）
  - 提交状态：Read-only（只读）
- 组织:
  - 成员：Read-only（只读）
  - 项目：Read-only（只读）
在“Subscribe to events（订阅事件）”下，选择：
- 成员
- 拉取请求
- 推送
- 仓库
- 团队
要启用 GitHub 应用程序访问您的 GitHub Enterprise Server 实例中任何用户或组织的数据，请在“此 GitHub 应用程序可安装在何处？”下，选择 Any account（任何帐户）。
单击创建 GitHub 应用程序。
检查应用程序的配置。
在“Private keys（私钥）”下，单击 Generate a private key（生成私钥）。
保存生成的 PEM 文件供以后参考。
记录关于应用程序的以下信息，供以后参考。
- 应用程序 ID
- 客户端 ID
- 客户端密钥
- 私钥
- Web 挂钩密码

安装 GitHub Insights

从应用程序服务器中 github/insights-releases 的发行版页面上，找到 GitHub Insights 的最新版本。
要下载最新版本，请在“Assets（资产）”下单击 insights-VERSION.tar.gz。
解压缩目录。
运行 shell 脚本 install.sh。
要启用 SSL，请输入 SSL 证书 (.crt/.cer/.pem)。如果不想启用 SSL，请留空。
如果选择启用 SSL，请输入 SSL 密钥 (.key)。否则，请留空。
输入主机名，即创建 GitHub 应用程序时用于应用程序服务器的 URL。
安装的运行需要几分钟。完成后，您将看到终端上显示一条消息。
```
安装完成
运行 /opt/insights/scripts/start.sh 以启动 GitHub Insights
```
要启动 GitHub Insights，请运行 shell 脚本 /opt/insights/scripts/start.sh。
如果这是第一次启动 GitHub Insights，该脚本需要几分钟才能运行。完成后，您将看到终端上显示一条消息。
```
GitHub Insights 正在运行！
```