Migrating your enterprise to the Container registry from the Docker registry

You can migrate Docker images previously stored in the Docker registry on GitHub Enterprise Server 인스턴스 to the Container registry.

누가 이 기능을 사용할 수 있는 있나요?

Enterprise owners can migrate Docker images to the Container registry.

이 문서의 내용

참고: GitHub Enterprise Server에 대한 Container registry는 현재 베타 버전이며 변경될 수 있습니다.

GitHub Packages 및 하위 도메인 격리를 모두 사용하도록 설정해야 Container registry를 사용할 수 있습니다. 자세한 내용은 "컨테이너 레지스트리 작업"을(를) 참조하세요.

About the Container registry

Container registry는 조직 또는 개인 계정 내에 컨테이너 이미지를 저장하고 이미지를 리포지토리와 연결할 수 있습니다. 리포지토리에서 사용 권한을 상속할지 또는 리포지토리와 독립적으로 세분화된 권한을 설정할지 선택할 수 있습니다. 퍼블릭 컨테이너 이미지에 익명으로 액세스할 수도 있습니다. For more information, see "컨테이너 레지스트리 작업."

For more information about configuring GitHub Packages for GitHub Enterprise Server 인스턴스, see "엔터프라이즈를 위한 GitHub Packages 시작."

About migration from the Docker registry

Container registry는 GitHub의 Docker 레지스트리 대신 사용됩니다. If the Docker registry on GitHub Enterprise Server 인스턴스 contains images, you must manually migrate the images to the Container registry.

Note: GitHub Enterprise Server 3.6은 조직에 저장된 Docker 이미지에 대한 마이그레이션을 지원합니다. 향후 릴리스에서는 사용자 소유 이미지의 마이그레이션을 지원합니다.

모든 스크립트 또는 Docker 레지스트리, docker.HOSTNAME에 대한 네임스페이스를 사용하는 GitHub Actions 워크플로는 containers.HOSTNAME에서 Container registry로 마이그레이션한 후 계속 작동합니다. For more information about the impact of migration to the Container registry, see "Docker 레지스트리에서 컨테이너 레지스트리로 마이그레이션."

Migrating organizations to the Container registry

You can start a migration of all your organizations' Docker images to the Container registry. The duration of the migration operation depends on the total number of images to migrate, and the overall load on your instance. After a successful migration, GitHub Enterprise Server will display a summary, and all future uploads of Docker images will use the Container registry.

If a site administrator has configured email notifications for GitHub Enterprise Server 인스턴스, you will receive an email after the migration is complete. For more information, see "알림에 대한 메일 구성."

Notes:

  • During the migration, the CPU and memory usage for your instance will increase. To ensure the performance of the instance for your users, GitHub recommends that you begin a migration during a period of reduced activity.
  • During the migration, do not modify settings for your enterprise or run ghe-config-apply from an administrative SSH session. These actions will trigger a configuration run, which can restart services and may interrupt the migration.
  • After the migration, storage pressure on your instance will increase due to the duplication of image files in the Docker registry and the Container registry. A future release of GitHub Enterprise Server will remove the duplicated files when all migrations are complete.

For more information about monitoring the performance and storage of GitHub Enterprise Server 인스턴스, see "모니터 대시보드 액세스."

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 엔터프라이즈 설정을 차례로 클릭합니다.

    GitHub Enterprise Server에서 프로필 사진 클릭할 때 나타나는 드롭다운 메뉴의 스크린샷 "엔터프라이즈 설정" 옵션이 진한 주황색 윤곽선으로 강조 표시됩니다.

  2. 엔터프라이즈 계정 사이드바에서 설정을 선택합니다.

  3. In the left sidebar, click Packages.

  4. To the right of the number of packages to migrate, click Start migration. During the migration, GitHub Enterprise Server will display progress on this page.

After the migration completes, the page will display the results. If a migration fails, the page will show the organizations that own the package that caused the failure.

Re-running a failed organization migration

Prior to migration, if a user has created a package in the Container registry that has an identical name to an existing package in the Docker registry, the migration will fail.

  1. Delete the affected container in the Container registry. For more information, see "패키지 삭제 및 복원."

  2. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 엔터프라이즈 설정을 차례로 클릭합니다.

    GitHub Enterprise Server에서 프로필 사진 클릭할 때 나타나는 드롭다운 메뉴의 스크린샷 "엔터프라이즈 설정" 옵션이 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 엔터프라이즈 계정 사이드바에서 설정을 선택합니다.

  4. 왼쪽 사이드바에서 Packages(패키지)를 클릭합니다.

  5. To the right of the number of packages to migrate, click Re-run migration. During the migration, GitHub Enterprise Server will display progress on this page.

  6. If the migration fails again, start from step 1 and re-run the migration.