GitLab 컨테이너 레지스트리 관리

GitLab Self-Managed 인스턴스에서 컨테이너 레지스트리를 활성화, 구성, 스토리지 설정, 가비지 컬렉션 등 관리하는 방법을 설명합니다.

Note 차세대 컨테이너 레지스트리 로 GitLab Self-Managed 인스턴스를 업그레이드할 수 있습니다. 이 업그레이드된 레지스트리는 온라인 가비지 컬렉션을 지원하며, 성능과 안정성이 크게 개선되었습니다. GitLab 컨테이너 레지스트리를 사용하면 모든 프로젝트가 Docker 이미지를 저장할 자체 공간을 가질 수 있습니다. Distribution Registry에 대한 자세한 내용은 다음을 참고합니다. 구성 스토리지 드라이버 레지스트리 서버 배포 이 문서는 관리자 가이드입니다. GitLab 컨테이너 레지스트리 사용 방법은 사용자 문서 를 참고합니다. 컨테이너 레지스트리 활성화 # 컨테이너 레지스트리를 활성화하는 과정은 사용하는 설치 유형에 따라 다릅니다. Linux 패키지 설치 # Linux 패키지로 GitLab을 설치한 경우 컨테이너 레지스트리는 기본적으로 사용할 수 있을 수도, 없을 수도 있습니다. 내장 Let's Encrypt 통합 을 사용하는 경우 컨테이너 레지스트리가 자동으로 활성화되며 GitLab 도메인의 5050 포트에서 사용할 수 있습니다. 그렇지 않으면 컨테이너 레지스트리는 활성화되지 않습니다. 활성화하려면 다음 중 하나를 수행합니다. GitLab 도메인 에 대해 구성합니다. 다른 도메인 에 대해 구성합니다. 컨테이너 레지스트리는 기본적으로 HTTPS에서 작동합니다. HTTP를 사용할 수도 있지만 권장하지 않으며 이 문서의 범위를 벗어납니다. Helm Charts 설치 # Helm Charts 설치는 Helm Charts 문서의 컨테이너 레지스트리 사용 을 참고합니다. 자체 컴파일 설치 # GitLab을 직접 컴파일하여 설치한 경우 다음을 수행합니다. 설치하는 GitLab 버전에 해당하는 이미지를 사용해 레지스트리를 배포해야 합니다 (예: registry.gitlab.com/gitlab-org/build/cng/gitlab-container-registry:v3.15.0-gitlab ). 설치가 완료된 후 레지스트리를 활성화하려면 gitlab.yml 에서 레지스트리 설정을 구성해야 합니다. lib/support/nginx/registry-ssl 의 NGINX 샘플 구성 파일을 사용하고 host , port , TLS 인증서 경로에 맞게 편집합니다. gitlab.yml 의 내용은 다음과 같습니다. registry: enabled: true host: <registry.gitlab.example.com> port: <5005> api_url: <http://localhost:5000/> key: <config/registry.key> path: <shared/registry> issuer: <gitlab-issuer> 각 항목의 의미는 다음과 같습니다. 매개변수 설명 enabled true 또는 false . GitLab에서 레지스트리를 활성화합니다. 기본값은 false 입니다. host 레지스트리가 실행되며 사용자가 사용할 수 있는 호스트 URL입니다. port