Skip to main content

从第三方途径安装 GitHub Apps

你可以直接从应用所有者安装 GitHub Apps 以用于个人帐户或组织。

关于安装 GitHub Apps

本文介绍如何直接从应用所有者而不是从 GitHub Marketplace 安装 GitHub App。 有关从 GitHub Marketplace 安装 GitHub Apps 的详细信息,请参阅“通过 GitHub 市场安装 GitHub App 以用于个人帐户”和“通过 GitHub 市场安装 GitHub App 以用于组织”。 若要详细了解如何安装你拥有的 GitHub Apps,请参阅“安装自己的 GitHub 应用”。

若要在存储库或组织上使用 GitHub App,必须在组织或个人帐户上安装该应用。 可以在多个帐户上安装相同的 GitHub App。 例如,如果在个人帐户和拥有的几个组织上安装应用,则可以在个人存储库、安装应用的组织以及这些组织所拥有的存储库中使用该应用。

在安装应用时,需要授予该应用访问其请求的组织和存储库资源的权限。 在安装过程中,GitHub 将告知你 GitHub App 请求了哪些权限。 若需详细了解 GitHub App 可以使用这些权限发出的 REST API 请求,请参阅“GitHub 应用程序所需的权限”。

安装应用时,还将选择要授予 GitHub App 访问权限的存储库。

在安装 GitHub App 之前,应确保自己信任 GitHub App 的所有者。 还应查看 GitHub App 请求的权限,并确保自己愿意授予这些权限。 若需详细了解 GitHub App 可以使用这些权限发出的 REST API 请求,请参阅“GitHub 应用程序所需的权限”。

可以安装的应用数量是没有限制的。

安装与授权之间的区别

安装 GitHub App 后,系统可能还会要求你授权该应用。

在帐户或组织上安装 GitHub App 时,即表示向应用授予访问其请求的组织和存储库资源的权限。 还需要指定应用可以访问的存储库。 在安装过程中,GitHub App 将指示你授予哪些存储库和组织权限。 有关允许 GitHub App 执行操作的不同权限的详细信息,请参阅“为 GitHub Apps 选择权限”。

例如,可以向 GitHub App 授予读取存储库元数据和写入问题的权限,也可以向 GitHub App 授予访问所有存储库的权限。

用于安装 GitHub 应用的页面的屏幕截图。 应用正在请求对元数据的读取访问权限和对问题的写入访问权限。 应用还可以请求对电子邮件的读取访问权限和对 Gist 的写入访问权限的用户授权。

授权 GitHub App 时,即表示根据应用请求的帐户权限授予应用访问 GitHub 帐户的权限。 在授权过程中,应用将指示应用可以在你的帐户上访问的资源。 授权 GitHub App 后,还会授予应用代表你执行操作的权限。

例如,可以向 GitHub App 授予读取电子邮件地址和编写 Gist 的权限。

授权 GitHub 应用的页面的屏幕截图。 应用正在请求对电子邮件的读取访问权限和对 Gist 的写入访问权限。

无需授权应用即可安装 GitHub App。 同样,无需安装应用即可授权应用。

若要详细了解授权 GitHub Apps,请参阅“授权 GitHub Apps”。

安装 GitHub App 的要求

任何人都可以在其个人帐户上安装 GitHub Apps。

组织所有者可在其组织上安装 GitHub Apps。

组织拥有的存储库的管理员还可以在组织上安装 GitHub Apps,前提是他们仅授予应用访问其管理的存储库的权限,且应用不请求任何组织权限或“存储库管理”权限。 组织所有者可以阻止身为存储库管理员的外部协作者安装 GitHub Apps。

不是组织所有者或存储库管理员的组织成员仍然可以在安装过程中选择组织。 GitHub 不会安装应用,而是向组织所有者发送通知,请求组织所有者安装应用。

组织中具有“应用管理员”角色人员不会拥有在组织中安装 GitHub App 的能力。 有关详细信息,请参阅“关于 GitHub App 管理员”。

安装 GitHub App

在安装过程中,应用所有者会将你定向到 GitHub URL 以安装 GitHub App。 URL 类似于 https://github.com/apps/APP-NAME/installations/new,其中 APP-NAME 是 GitHub App 的名称。

  1. 选择要安装 GitHub App 的位置。 可以选择个人帐户或你所属的组织。

  2. 如果应用需要存储库权限,请选择“所有存储库”或“仅选定存储库” 。 该应用将始终至少对 GitHub 上的所有公共存储库具有只读访问权限。

    如果应用不需要存储库权限,将省略这些选项。

  3. 如果在上一步中选择了“仅选定存储库”,则在“所选存储库”下拉列表下,选择希望应用访问的存储库 。

    如果应用创建了任何存储库,则应用也将自动获得访问这些存储库的权限。

  4. 查看应用正在请求的权限。 若需详细了解 GitHub App 可以使用这些权限发出的 REST API 请求,请参阅“GitHub 应用程序所需的权限”。

  5. 单击“安装”、“安装和请求”或“请求” 。 显示的按钮取决于组织所有者是否必须批准应用请求的部分或全部访问权限或不批准。 有关详细信息,请参阅“安装 GitHub App 的要求”。