安装 Zinn® GitHub 应用程序，以便我们可以在没有长期令牌的情况下进行部署

连接它能为您带来什么

安装 Zinn® GitHub 应用允许网站从您的代码仓库进行部署，并使项目看板与 GitHub 保持同步，而无需向我们提供个人令牌。我们仅持有该应用的安装编号，它单独存在时没有任何作用，且我们每次需要时都会生成一个有效期为一小时的令牌。对于组织而言，这是更好的选择，因为它不属于任何个人，也不会在有人离职时停止工作。

在您开始之前

您需要一个 GitHub 账户，或者对要安装该应用的组织拥有所有者权限。禁止第三方应用的组织需要所有者予以批准；如果无法做到这一点，请改用细粒度令牌（连接您的 GitHub 账户）。

1. 在 GitHub 创建密钥

无需创建任何密钥。请在您的个人账户或组织上安装 Zinn® GitHub 应用，并选择所有代码仓库或仅选择您希望我们部署的代码仓库。

然后查找安装编号：

• 个人账户 — Settings → Applications → Installed GitHub Apps，然后点击 Zinn® 应用旁的 Configure。
• 组织 — Your organizations → Settings → GitHub Apps，然后点击 Zinn® 应用旁的 Configure。

该页面地址栏末尾的数字 — 例如 github.com/settings/installations/12345678 — 即为安装编号。

2. 在此处进行连接

该应用是在使用它的位置进行选择，而非在“集成”界面上：

• 在网站的代码仓库连接上，选择 GitHub (app install)。
• 在项目看板的 GitHub 链接上，选择 The Zinn® GitHub app。

粘贴安装编号并继续。我们在保存任何内容之前都会检查安装情况；我们无法访问的编号绝不会被存储。

接下来的流程

• 您向该应用授予权限的代码仓库将显示出来以供网站部署，并且推送操作将触发部署。
• 我们执行的每项操作都会以该应用的名称而非您的名称出现在 GitHub 的安装审计日志中。
• 若要向我们提供更多代码仓库，请在同一个 Configure 页面上更改该应用的代码仓库访问权限 — 无需重新连接任何内容。

如果无法连接

缺少代码仓库。该安装仅涵盖您选择的代码仓库。请打开 Configure 并将其添加。

编号被拒绝。请检查该编号是否为地址栏中的安装编号，而非该应用自身的 ID，并确认该应用仍处于安装状态 — 已卸载的应用没有安装编号。

提示密钥被拒绝。通常是以下三种情况之一：复制时夹带了空格或换行符、密钥已过期，或者密钥在您复制后已被撤销或重新生成。请重新创建一个并再次粘贴。

连接成功，但后续操作失败。密钥通过了身份验证，但缺少该操作所需的权限。请使用上面列出的权限创建一个新密钥，然后断开旧连接并连接新密钥。

断开连接

打开 Integrations，找到该账户并点击 Disconnect。这将立即删除存储的密钥。任何正在使用它的功能都将在执行下一次操作时停止，依赖它的界面将显示相应提示，而不是以静默方式失败。

断开连接不会撤销已经完成的操作 — 我们在您账户上更改的记录、部署或设置将保持原样。如果您认为密钥本身可能已泄露，还请在供应商处将其撤销；断开连接只会删除我们的副本，而不会删除他们的副本。