Skip to main content

企业 GitHub Packages 使用入门

可以通过启用功能、配置第三方存储、配置想要支持的生态系统以及更新 TLS 证书,开始在 你的 GitHub Enterprise Server 实例 上使用 GitHub Packages。

谁可以使用此功能?

Site administrators can enable and configure GitHub Packages.

Note

GitHub Enterprise Server 上的 GitHub Packages 目前不支持群集。

步骤 1:检查 GitHub Packages 是否可用于您的企业

GitHub Packages 在 GitHub Enterprise Server 3.0 或更高版本中可用。 如果您使用的是早期版本的 GitHub Enterprise Server,则必须升级才能使用 GitHub Packages。 有关升级 GitHub Enterprise Server 实例的详细信息,请参阅“关于升级到新版本”。

步骤 2:查看硬件要求

如果计划为实例的用户启用 Container registry,则至少再需要增加 10% 的 CPU 资源。

建议查看实例上用户和自动化的活动级别,以确保已为用户预配了足够的 CPU。 有关详细信息,请参阅“监视实例”。

有关 你的 GitHub Enterprise Server 实例 的最低硬件要求的更多信息,请参阅实例的平台的硬件注意事项。

有关为现有实例调整资源的详细信息,请参阅“增加 CPU 或内存资源”。

步骤 3:启用 GitHub Packages 并配置外部存储

GitHub Enterprise Server 上的 GitHub Packages 使用外部 Blob 存储来存储您的软件包。

在为 你的 GitHub Enterprise Server 实例 启用 GitHub Packages 后,需要准备第三方存储桶。 所需的存储量取决于您对 GitHub Packages 的使用,且设置指南可能因存储提供商而异。

支持的外部存储提供商

  • Amazon Web Services (AWS) S3
  • Azure Blob Storage
  • MinIO

要启用 GitHub Packages 并配置第三方存储,请参阅:

步骤 4:指定包生态系统以支持实例

选择要在 你的 GitHub Enterprise Server 实例 上启用、禁用或设置为只读的包生态系统。 可用选项包括 Container registry、Docker、RubyGems、npm、Apache Maven、Gradle 或 NuGet。 有关详细信息,请参阅“为企业配置包生态系统支持”。

步骤 5:如果需要,请确保具有包主机 URL 的 TLS 证书

如果为 你的 GitHub Enterprise Server 实例 启用了子域隔离,则需要创建并上传 TLS 证书,该证书允许要使用的每个生态系统的包主机 URL,例如 containers.HOSTNAME。 确保每个包主机 URL 包含 https://

可以手动创建证书,也可以使用“让我们加密”。 如果已经使用“让我们加密”,必须在启用 GitHub Packages 后申请新的 TLS 证书。 有关包主机 URL 的详细信息,请参阅“启用子域隔离”。 有关将 TLS 证书上传到 GitHub Enterprise Server 的详细信息,请参阅“配置 TLS”。

步骤 6:检查并重命名保留名称

如果要在禁用子域隔离的情况下使用 Docker 生态系统,必须先重命名 你的 GitHub Enterprise Server 实例 上名为 v2 的任何用户或组织,然后才能在 管理控制台 中启用 Docker 生态系统支持。 Docker 使用 v2 帐户名称来管理与 Docker API 的路径冲突;启用 Docker 注册表支持后,将无法再使用此名称。

可导航到站点管理仪表板中的“保留登录名”页来查看已保留供内部使用的登录名完整列表。 有关详细信息,请参阅“从 Web UI 管理实例”。