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

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

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

Enterprise owners can migrate Docker images to the Container registry.

이 문서의 내용

Note

Container registry는 현재 GitHub Enterprise Server의 베타 버전이며 변경될 수 있습니다.

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

Container registry 정보

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

GitHub Enterprise Server 인스턴스의 GitHub Packages를 구성하는 데 대한 자세한 내용은 "엔터프라이즈를 위한 GitHub Packages 시작"을(를) 참조하세요.

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

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

Note

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

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

Container registry로 조직 마이그레이션

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

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

마이그레이션 중

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

Warning

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

마이그레이션 후:

마이그레이션 후에는 Docker 레지스트리의 이미지 파일과 Container registry의 중복으로 인해 인스턴스에 대한 스토리지 부담이 증가합니다. GitHub Enterprise Server의 향후 릴리스에서는 모든 마이그레이션이 완료되면 중복된 파일이 제거됩니다.

GitHub Enterprise Server 인스턴스의 성능 및 스토리지 모니터링에 대한 자세한 내용은 "About the monitor dashboard"을(를) 참조하세요.

마이그레이션 시작

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

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

  2. 페이지 왼쪽의 엔터프라이즈 계정 사이드바에서 설정을 클릭합니다.

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

  4. 마이그레이션할 패키지 수의 오른쪽에서 마이그레이션 시작을 클릭합니다. 마이그레이션하는 동안 GitHub Enterprise Server는 이 페이지에 진행률을 표시합니다.

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

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

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

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

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

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

  3. 페이지 왼쪽의 엔터프라이즈 계정 사이드바에서 설정을 클릭합니다.

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

  5. 마이그레이션할 패키지 수의 오른쪽에서 마이그레이션 다시 실행을 클릭합니다. 마이그레이션하는 동안 GitHub Enterprise Server는 이 페이지에 진행률을 표시합니다.

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