管理部署密钥

在服务器上运行过程，并记住保存生成的公共和专用 rsa 密钥对的位置。
在 GitHub 上，导航到存储库的主页面。1. 在仓库名称下，单击 “Settings”****。如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
在边栏中，单击“部署密钥”。
单击“添加部署密钥”。
在“标题”字段中，提供标题。
在“密钥”字段中，粘贴公钥。
如果希望此密钥具有对存储库的写入权限，请选择“允许写入权限”。具有写入权限的部署密钥允许将部署推送到仓库。
单击“添加密钥”。

也可以使用 REST API 创建部署密钥。有关详细信息，请参阅“AUTOTITLE”。

在一台服务器上使用多个仓库

如果在一台服务器上使用多个仓库，则需要为每个仓库生成专用密钥对。不能对多个仓库重复使用一个部署密钥。

在服务器的 SSH 配置文件中（通常为），为每个存储库添加别名条目。例如：

Host github.com-repo-0
        Hostname github.com
        IdentityFile=/home/user/.ssh/repo-0_deploy_key

Host github.com-repo-1
        Hostname github.com
        IdentityFile=/home/user/.ssh/repo-1_deploy_key

- 存储库的别名。
- 将主机名配置为与别名一起使用。
- 将私钥分配给别名。

然后可以使用主机名的别名通过 SSH 与仓库进行交互，SSH 将使用分配给该别名的唯一部署密钥。例如：

git clone git@github.com-repo-1:OWNER/repo-1.git

GitHub App 安装访问令牌

如果服务器需要访问一个或多个组织的存储库，可以使用 GitHub App 来定义所需的访问权限，然后从该 GitHub App 生成范围严格的安装访问令牌。安装访问令牌可以限定在单个或多个存储库，并且可以具有细致的权限设置。例如，您可以生成对仓库内容具有只读权限的令牌。

由于 GitHub Apps 是 GitHub 上的一类角色，因此安装访问令牌不限于任何 GitHub 用户，这使它们堪比“服务令牌”。此外，安装访问令牌有专用的速率限制，随着所服务的组织规模增长而调整。有关详细信息，请参阅 GitHub Apps 的速率限制。

安装访问令牌的优点

范围严格限制的令牌具有明确定义的权限集和到期时间（默认为 1 小时，或者如果使用 API 手动撤销则为更短时间）
随着您的组织发展而增长的专属速率限制
与 GitHub 用户身份脱钩，因此它们不占用任何许可证
从未授予密码，因此无法直接登录

安装访问令牌的缺点

要创建 GitHub App，需要进行额外的设置。
安装访问令牌 1 小时后过期，因此需要重新生成，通常是按需使用代码。

设置安装访问令牌

确定 GitHub App 应为公共还是专用。如果您的 GitHub App 将仅在您组织内的存储库上操作，您可能希望它是私有的。
确定 GitHub App 所需的权限，例如对存储库内容的只读访问权限。
通过组织的设置页面创建您的 GitHub App。有关详细信息，请参阅创建 GitHub App。
记下 GitHub App 。
生成并下载 GitHub App 的私钥，并妥善保管。有关详细信息，请参阅生成私钥。
将 GitHub App 安装到需要执行它的存储库中，或者，可以在组织中的所有存储库中安装 GitHub App。
标识与 GitHub App 可以访问的组织存储库之间连接的内容。每个 GitHub App 和组织对最多有一个。可以通过获取经过身份验证的应用的组织安装来标识这一点。这需要使用 JWT 作为 GitHub App 进行身份验证。有关详细信息，请参阅作为 GitHub App 进行身份验证。
使用相应的 REST API 终结点生成安装访问令牌，为应用创建安装访问令牌。这需要使用 JWT 作为 GitHub App 进行身份验证。有关详细信息，请参阅作为 GitHub App 的身份验证，以及作为安装的身份验证。
使用此安装访问令牌，通过 REST、GraphQL API 或 Git 客户端与存储库进行交互。

有关详细信息，请参阅“AUTOTITLE”。

机器用户

如果服务器需要访问多个存储库，你可以创建一个新的 GitHub.com 帐户并附加专用于自动化的 SSH 密钥。由于人们不会使用 GitHub.com 上的这个帐户，因此它被称为计算机用户。可以将机器用户添加为个人存储库上的协作者（授予读取和写入访问权限），或添加为组织存储库上的外部协作者（授予读取、写入或管理员访问权限），或添加到有权访问其需要自动化的存储库的团队（授予团队权限）。

计算机用户的优点

有权访问仓库和服务器的任何人都能够部署项目。
没有（人类）用户需要更改其本地 SSH 设置。
不需要多个密钥；每台服务器一个就足够了。

计算机用户的缺点

只有组织才能将机器用户限制为只读访问。个人仓库始终授予协作者读取/写入权限。
机器用户密钥（如部署密钥）通常不受密码保护。

设置计算机用户

在服务器上运行过程，并将公钥附加到计算机用户帐户。
授予机器用户帐户访问要自动化的仓库的权限。可以通过将帐户添加为协作者、外部协作者，或添加到组织中的一个团队来执行此操作。

延伸阅读

配置通知

管理部署密钥

本文内容