Skip to main content

企业 GitHub Packages 使用入门

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

谁可以使用此功能?

Site administrators can enable and configure GitHub Packages.

注意: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 管理实例”。