GitLab Self-Managed 인스턴스에서 컨테이너 레지스트리를 활성화, 구성, 스토리지 설정, 가비지 컬렉션 등 관리하는 방법을 설명합니다.
차세대 컨테이너 레지스트리 는 이제 GitLab Self-Managed 인스턴스에서 업그레이드할 수 있습니다. 이 업그레이드된 레지스트리는 온라인 가비지 컬렉션을 지원하며, 성능과 안정성이 크게 향상되었습니다. GitLab 컨테이너 레지스트리를 사용하면, 모든 프로젝트에서 Docker 이미지를 저장할 수 있는 고유한 공간을 가질 수 있습니다. Distribution Registry에 대한 자세한 내용: 구성 스토리지 드라이버 레지스트리 서버 배포 이 문서는 관리자 가이드입니다. GitLab 컨테이너 레지스트리 사용 방법은 사용자 문서 를 참고하세요. 컨테이너 레지스트리 활성화 # 컨테이너 레지스트리를 활성화하는 방법은 설치 유형에 따라 다릅니다. Linux 패키지 설치 # GitLab을 Linux 패키지로 설치한 경우, 컨테이너 레지스트리는 기본적으로 활성화되어 있거나 그렇지 않을 수 있습니다. 내장된 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 에서 Registry의 설정을 구성해야 합니다. 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에서 Registry를 활성화합니다. 기본값은 false입니다. host Registry가 실행되고 사용자가 접속할 수 있는 호스트 URL입니다. port 외부 Registry 도메인이 수신하는 포트입니다.
