Bundle URI

Bundle URI에 대해 설명합니다.

히스토리 GitLab 17.0에서 gitaly_bundle_uri 라는 기능 플래그 와 함께 도입 되었습니다. 기본적으로 비활성화되어 있습니다. Gitaly는 Git 번들 URI 를 지원합니다. 번들 URI는 원격에서 나머지 객체를 가져오기 전에 객체 데이터베이스를 부트스트랩하도록 Git이 번들을 하나 이상 내려받을 수 있는 위치입니다. 번들 URI는 Git 프로토콜에 내장되어 있습니다. 번들 URI를 사용하면 다음과 같은 효과가 있습니다: GitLab 서버와의 네트워크 연결 상태가 좋지 않은 사용자의 클론과 페치 속도를 높입니다. 번들을 CDN에 저장하면 전 세계에서 사용할 수 있습니다. CI/CD job을 실행하는 서버의 부하를 줄입니다. CI/CD job이 다른 곳에서 번들을 미리 받아 올 수 있다면, 누락된 객체와 참조를 점진적으로 가져오는 나머지 작업이 서버에 훨씬 적은 부하를 발생시킵니다. 사전 요구 사항 # 번들 URI를 사용하기 위한 사전 요구 사항은 CI/CD job에서 클론하는지, 터미널에서 로컬로 클론하는지에 따라 달라집니다. CI/CD job에서 클론 # CI/CD job에서 번들 URI를 사용할 준비를 하려면: GitLab Runner가 사용하는 GitLab Runner 헬퍼 이미지 를 다음을 실행하는 버전으로 업데이트합니다: Git 버전 2.49.0 이상. GitLab Runner 헬퍼 버전 18.0 이상. 번들 URI는 git clone 중 Git 서버의 부하를 줄이는 것을 목표로 하는 방식이므로 이 단계가 필요합니다. 따라서 CI/CD 파이프라인이 실행될 때 git clone 명령을 시작하는 git 클라이언트는 GitLab Runner이며, git 프로세스는 헬퍼 이미지 안에서 실행됩니다. GitLab 러너에 사용하는 운영 체제 배포판과 아키텍처에 맞는 이미지를 선택합니다. 다음 명령을 실행해 이미지가 요구 사항을 충족하는지 확인할 수 있습니다: docker run -it <image:tag> $ git version $ gitlab-runner-helper -v gitlab-runner-helper 이미지의 Git 버전은 운영 체제 배포판의 패키지 관리자에 의존해 관리합니다. 따라서 최신 이미지 중 일부는 여전히 Git 2.49를 실행하지 않을 수 있습니다. 요구 사항을 충족하는 이미지를 찾지 못했다면 gitlab-runner-helper 를 베이스 이미지로 삼아 직접 이미지를 빌드합니다. 직접 빌드한 이미지는 GitLab 컨테이너 레지스트리 로 호스팅할 수 있습니다. config.toml 파일을 업데이트해 선택한 이미지를 사용하도록 GitLab Runner 인스턴스를 구성합니다: [[runners]] (...) executor = "docker" [runners.docker] (...) helper_image = "image:tag" ## <-- put the image name and tag here 자세한 내용은 헬퍼 이미지 정보 를 참고합니다. 새 구성이 적용되도록 러너를 재시작합니