GitLab 컨테이너 레지스트리 문제 해결

GitLab 컨테이너 레지스트리의 일반적인 오류 문제 해결 팁.

GitLab 컨테이너 레지스트리의 대부분의 문제를 해결하려면 관리자 권한으로 GitLab에 로그인해야 합니다. GitLab 컨테이너 레지스트리 관리 문서에서 추가 문제 해결 정보 를 확인할 수 있습니다. GitLab 컨테이너 레지스트리로 OCI 컨테이너 이미지 마이그레이션 # 컨테이너 이미지를 GitLab 레지스트리로 마이그레이션하는 기능은 지원되지 않지만, 에픽 5210 에서 이 동작의 변경을 제안하고 있습니다. 서드파티 도구를 사용하여 컨테이너 이미지를 마이그레이션할 수 있습니다. 예를 들어 skopeo 는 다양한 스토리지 메커니즘 간에 컨테이너 이미지를 복사 할 수 있습니다. skopeo를 사용하면 컨테이너 레지스트리, 컨테이너 스토리지 백엔드, 로컬 디렉터리, 로컬 OCI 레이아웃 디렉터리에서 GitLab 컨테이너 레지스트리로 복사할 수 있습니다. Docker 연결 오류 # 그룹, 프로젝트 또는 브랜치 이름에 특수 문자가 있으면 Docker 연결 오류가 발생할 수 있습니다. 특수 문자에는 다음이 포함됩니다. 선행 밑줄. 후행 하이픈 또는 대시. 이 오류를 해결하려면 그룹 경로 , 프로젝트 경로 또는 브랜치 이름을 변경합니다. Docker Engine 17.11 이하를 사용하는 경우 404 Not Found 또는 Unknown Manifest 오류 메시지가 표시될 수 있습니다. 현재 버전의 Docker Engine은 v2 API 를 사용합니다. GitLab 컨테이너 레지스트리의 이미지는 Docker v2 API를 사용해야 합니다. 버전 1 이미지를 버전 2로 업데이트하는 방법은 Docker 문서 를 참고합니다. 매니페스트 목록 푸시 시 Blob unknown to registry 오류 # GitLab 컨테이너 레지스트리에 Docker 매니페스트 목록을 푸시 할 때 manifest blob unknown: blob unknown to registry 오류가 발생할 수 있습니다. 이 오류는 아키텍처가 서로 다른 여러 이미지가 하나의 리포지터리가 아니라 여러 리포지터리에 분산되어 있을 때 발생할 가능성이 높습니다. 예를 들어 각각 하나의 아키텍처를 나타내는 이미지가 두 개 있을 수 있습니다. amd64 플랫폼. arm64v8 플랫폼. 이 이미지들로 멀티 아키텍처 이미지를 빌드하려면 멀티 아키텍처 이미지와 동일한 리포지터리에 푸시해야 합니다. Blob unknown to registry 오류를 해결하려면 개별 이미지의 태그 이름에 아키텍처를 포함합니다. 예를 들어 mygroup/myapp:1.0.0-amd64 와 mygroup/myapp:1.0.0-arm64v8 을 사용합니다. 그런 다음 매니페스트 목록에 mygroup/myapp:1.0.0 태그를 지정할 수 있습니다. 프로젝트 경로를 변경하거나 프로젝트를 이전할 수 없음 # 프로젝트 경로를 변경하거나 프로젝트를 새 네임스페이스로 이전하려고 하면 다음 오류 중 하나가 발생할 수 있습니다. 컨테이너 레지스트리에 태그가 있으므로 프로젝트를 이전할 수 없습니다. 프로젝트 중 하나 이상의 컨테이너