Git 프로토콜 v2 구성

Tier: Free, Premium, Ultimate Offering: Self-Managed

Git 프로토콜 v2는 여러 측면에서 v1 와이어 프로토콜을 개선하고 있으며 HTTP 요청의 경우 GitLab에서 기본적으로 활성화되어 있습니다. SSH를 활성화하려면 관리자가 추가 구성을 해야합니다.

새로운 기능과 개선 사항에 대한 자세한 내용은 Google 오픈 소스 블로그와 프로토콜 문서에서 확인할 수 있습니다.

사전 요구 사항

클라이언트 측에서는 git v2.18.0 또는 그 이상이 설치되어 있어야 합니다.

서버 측에서는 SSH를 구성하려면 sshd 서버가 GIT_PROTOCOL 환경을 수락하도록 설정해야 합니다.

GitLab Helm Charts 및 All-in-one Docker image를 사용하는 경우 SSH 서비스는 이미 GIT_PROTOCOL 환경을 수락하도록 구성되어 있습니다. 사용자는 더 이상 다른 작업을 할 필요가 없습니다.

Linux 패키지 또는 자체 컴파일 설치에서는 서버의 SSH 구성을 수동으로 업데이트하여 /etc/ssh/sshd_config 파일에 다음 라인을 추가해야 합니다. 

AcceptEnv GIT_PROTOCOL

SSH 데몬을 구성한 후 변경 사항이 적용되도록 재시작하십시오. 

# CentOS 6 / RHEL 6
sudo service sshd restart

# 다른 모든 지원되는 배포판
sudo systemctl restart ssh

지침

새 프로토콜을 사용하려면 클라이언트는 Git 명령에 구성 -c protocol.version=2을 전달하거나 전역으로 설정해야 합니다.

HTTP 연결

클라이언트에서 Git v2가 사용되는지 확인합니다. 

GIT_TRACE_CURL=1 git -c protocol.version=2 ls-remote https://your-gitlab-instance.com/group/repo.git 2>&1 | grep Git-Protocol

Git-Protocol 헤더가 전송되었는지 확인해야 합니다. 

16:29:44.577888 http.c:657              => Send header: Git-Protocol: version=2

서버에서 Git v2가 사용되는지 확인합니다. 

GIT_TRACE_PACKET=1 git -c protocol.version=2 ls-remote https://your-gitlab-instance.com/group/repo.git 2>&1 | head

Git 프로토콜 v2를 사용하는 예시 응답: 

$ GIT_TRACE_PACKET=1 git -c protocol.version=2 ls-remote https://your-gitlab-instance.com/group/repo.git 2>&1 | head
10:42:50.574485 pkt-line.c:80           packet:          git< # service=git-upload-pack
10:42:50.574653 pkt-line.c:80           packet:          git< 0000
10:42:50.574673 pkt-line.c:80           packet:          git< version 2
10:42:50.574679 pkt-line.c:80           packet:          git< agent=git/2.18.1
10:42:50.574684 pkt-line.c:80           packet:          git< ls-refs
10:42:50.574688 pkt-line.c:80           packet:          git< fetch=shallow
10:42:50.574693 pkt-line.c:80           packet:          git< server-option
10:42:50.574697 pkt-line.c:80           packet:          git< 0000
10:42:50.574817 pkt-line.c:80           packet:          git< version 2
10:42:50.575308 pkt-line.c:80           packet:          git< agent=git/2.18.1

SSH 연결

클라이언트에서 Git v2가 사용되는지 확인합니다. 

GIT_SSH_COMMAND="ssh -v" git -c protocol.version=2 ls-remote ssh://git@your-gitlab-instance.com/group/repo.git 2>&1 | grep GIT_PROTOCOL

GIT_PROTOCOL 환경 변수가 전송되었는지 확인해야 합니다. 

debug1: Sending env GIT_PROTOCOL = version=2

서버 측에서는 HTTP에서 동일한 예시를 사용하고 URL을 SSH로 변경하여 사용할 수 있습니다.

연결의 Git 프로토콜 버전 확인

프로덕션 환경에서 사용되는 Git 프로토콜 버전을 확인하려면 관련 문서를 참조하세요.