安装 Zinn® GitHub 应用，以便我们无需使用长期令牌即可进行部署

连接 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。这会立即删除存储的密钥。任何使用该密钥的内容将在下一次操作时停止，且依赖于它的屏幕会明确提示，而不会悄无声息地失败。

断开连接不会撤销已完成的操作 — 我们在您的帐号上更改的记录、部署或设置将保持原样。如果您认为密钥本身可能已泄露，请同时在提供商处将其撤销；断开连接仅会删除我们保存的副本，不会删除对方的副本。