Docker 레지스트리에서 컨테이너 레지스트리로 엔터프라이즈 마이그레이션

GitHub Enterprise Server 인스턴스의 Docker 레지스트리에 이전에 저장된 Docker 이미지를 Container registry로 마이그레이션할 수 있습니다.

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

Enterprise owners can migrate Docker images to the Container registry.

이 기사에서

참고

Container registry는 현재 공개 미리 보기의 GitHub Enterprise Server 버전이며 변경될 수 있습니다.

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

Container registry에 대한 정보

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

GitHub Packages용 GitHub Enterprise Server 인스턴스 구성에 대한 자세한 내용은 엔터프라이즈용 GitHub 패키지 시작을 참조하세요.

Docker 레지스트리에서의 마이그레이션 정보

Container registry는 GitHub의 Docker 레지스트리 대신 사용됩니다. Docker 레지스트리에 GitHub Enterprise Server 인스턴스 이미지가 포함된 경우 이미지를 Container registry수동으로 마이그레이션해야 합니다.

참고

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

모든 스크립트 또는 Docker 레지스트리, GitHub Actions에 대한 네임스페이스를 사용하는 docker.HOSTNAME 워크플로는 Container registry에서 containers.HOSTNAME로 마이그레이션한 후 계속 작동합니다.마이그레이션이 미치는 영향에 대한 자세한 내용은 Container registry을 참조하세요.

조직을 Container registry로 마이그레이션

조직의 모든 Docker 이미지를 Container registry로 마이그레이션하는 작업을 시작할 수 있습니다. 마이그레이션 작업의 지속 시간은 마이그레이션할 총 이미지 수와 인스턴스의 전체 부하에 따라 달라집니다. 마이그레이션이 성공적으로 완료되면 GitHub Enterprise Server에 요약이 표시되며, 이후 Docker 이미지의 모든 업로드에는 Container registry가 사용됩니다.

사이트 관리자가 전자 메일 알림을 GitHub Enterprise Server 인스턴스구성한 경우 마이그레이션이 완료된 후 전자 메일을 받게 됩니다. 자세한 내용은 알림에 대한 메일 구성을(를) 참조하세요.

마이그레이션 중

마이그레이션하는 동안 인스턴스의 CPU 및 메모리 사용량이 증가합니다. 사용자 GitHub 에 대한 인스턴스의 성능을 보장하려면 활동 감소 기간 동안 마이그레이션을 시작하는 것이 좋습니다.

경고

엔터프라이즈의 설정을 수정하거나 관리 SSH 세션에서 ghe-config-apply를 실행하지 마세요. 이러한 작업은 구성 실행을 트리거하며 이 경우 서비스가 다시 시작될 수 있으며 마이그레이션이 중단될 수 있습니다.

마이그레이션 후:

마이그레이션 후에는 Docker 레지스트리와 Container registry에 이미지 파일이 중복되기 때문에 인스턴스의 스토리지 압박이 증가합니다. 향후 릴리스 GitHub Enterprise Server 에서는 모든 마이그레이션이 완료되면 중복된 파일이 제거됩니다.

성능 및 스토리지 GitHub Enterprise Server 인스턴스모니터링에 대한 자세한 내용은 모니터 대시보드 정보을 참조하세요.

마이그레이션 시작

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 Enterprise settings를 차례로 클릭합니다.
  2. 페이지 맨 위에서 클릭합니다****.
  3. 왼쪽 사이드바에서 Packages(패키지)를 클릭합니다.
  4. 마이그레이션할 패키지 수의 오른쪽에서 마이그레이션 시작을 클릭합니다. 마이그레이션하는 동안 GitHub Enterprise Server가 이 페이지에 진행 상황을 표시합니다.

마이그레이션이 완료되면 페이지에 결과가 표시됩니다. 마이그레이션에 실패하면 실패를 일으킨 패키지를 소유한 조직이 페이지에 표시됩니다.

실패한 조직 마이그레이션 다시 실행

마이그레이션 전에 사용자가 Docker 레지스트리의 Container registry 기존 패키지와 동일한 이름을 가진 패키지를 만든 경우 마이그레이션이 실패합니다.

  1. 에서 영향을 받는 컨테이너를 삭제합니다 Container registry. 자세한 내용은 패키지 삭제 및 복원을(를) 참조하세요.

  2. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 Enterprise settings를 차례로 클릭합니다.

  3. 페이지 맨 위에서 클릭합니다****.

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

  5. 마이그레이션할 패키지 수의 오른쪽에서 마이그레이션 다시 실행을 클릭합니다. 마이그레이션 중에는 GitHub Enterprise Server이(가) 이 페이지에 진행 상황을 표시합니다.

  6. 마이그레이션이 다시 실패하면 1단계부터 시작하여 마이그레이션을 다시 실행합니다.