将企业从 Docker 注册表迁移到容器注册表

必须启用 GitHub Packages 和子域隔离才能使用 Container registry。 有关详细信息，请参阅“使用容器注册表”。

关于 Container registry

Container registry 将容器映像存储在组织或个人帐户中，并允许你将映像与存储库相关联。 可以选择是从存储库继承权限，还是独立于存储库设置精细权限。 你也可以匿名访问公共容器映像。 有关详细信息，请参阅 使用容器注册表。

有关为GitHub Packages配置你的 GitHub Enterprise Server 实例的更多信息，请参阅企业 GitHub Packages 使用入门。

关于从 Docker 注册表迁移

Container registry 替代 GitHub 的 Docker 注册表。 如果 你的 GitHub Enterprise Server 实例 上的 Docker 注册表中有映像，则必须手动将这些映像迁移到 Container registry。

任何使用 Docker 注册表 GitHub Actions 的命名空间的脚本或 docker.HOSTNAME 工作流在迁移到 Container registry 处的 containers.HOSTNAME 后都将继续工作。 有关迁移到 Container registry 的影响的详细信息，请参阅 从 Docker 注册表迁移到容器注册表。

将组织迁移至 Container registry

您可以开始将您所有组织的 Docker 镜像迁移到 Container registry。 迁移操作的持续时间取决于要迁移的映像总数以及实例上的总体负载。 成功迁移后， GitHub Enterprise Server 将显示摘要，Docker 映像的所有未来上传都将使用 Container registry。

如果站点管理员已配置 你的 GitHub Enterprise Server 实例电子邮件通知，则迁移完成后将收到一封电子邮件。 有关详细信息，请参阅“配置电子邮件通知”。

迁移期间

在迁移过程中，实例的 CPU 和内存使用率将会增加。 若要确保用户实例的性能， GitHub 建议在活动减少期间开始迁移。

迁移后

迁移后，由于 Docker 注册表和 Container registry 中的映像文件发生重复，您的实例上的存储压力将会增加。 将来的版本 GitHub Enterprise Server 将在完成所有迁移时删除重复的文件。

有关监控 你的 GitHub Enterprise Server 实例 的性能和存储的详细信息，请参阅 ** 关于监控仪表板。

开始迁移

1. 在 GitHub Enterprise Server 的右上角，单击你的个人资料头像，然后单击“Enterprise settings”****。
2. 在页面顶部，单击“ 设置”。
3. 在左侧边栏中，点击“软件包”。
4. 在要迁移的包数量的右侧，单击“开始迁移”。 在迁移过程中， GitHub Enterprise Server 将在此页上显示进度。

迁移完成后，该页将显示结果。 如果迁移失败，该页将显示拥有导致失败的包的组织。

重新执行失败的组织迁移

在迁移之前，如果用户在 Docker 注册表中 Container registry 创建了与现有包具有相同名称的包，迁移将失败。

1. 删除 Container registry 中受影响的容器。 有关详细信息，请参阅“删除和恢复包”。

2. 在 GitHub Enterprise Server 的右上角，单击你的个人资料头像，然后单击“Enterprise settings”****。

3. 在页面顶部，单击“ 设置”。

4. 在左侧边栏中，单击“包”。

5. 在要迁移的包数量的右侧，单击“重新开始迁移”。 在迁移过程中， GitHub Enterprise Server 将在此页上显示进度。

6. 如果迁移再次失败，请从步骤 1 开始并重新运行迁移。