개요

• GitLab Shell은 GitLab의 Git SSH 세션을 처리하고 승인된 키 목록을 수정합니다.

• GitLab Shell은 유닉스 쉘이 아니며 Bash나 Zsh의 대체품도 아닙니다.

• GitLab 서버에 SSH를 통해 접근할 때, GitLab Shell은 다음 역할을 수행합니다.
  • 미리 정의된 Git 명령어(git push, git pull, git fetch)로 제한합니다.
  • GitLab Rails API를 호출하여 사용자가 권한이 있는지, 그리고 리포지토리가 어떤 Gitaly 서버에 있는지를 확인합니다.
  • SSH 클라이언트와 Gitaly 서버 간에 데이터를 주고받습니다.
• HTTP(S)를 통해 GitLab 서버에 접근하면 gitlab-workhorse로 연결됩니다.

Workflow

git pull over SSH

graph LR
	GitPull[Git Pull] --> |via SSH| GitLabShell[gitlab-shell]
	GitLabShell --> |API call| GitLabRails[gitlab-rails\\nauthorization]
	GitLabRails --> |accept or decline| Gitaly[Gitaly session]

git push over SSH

graph LR
	subgraph "User initiates"
		GitPush[Git push] --> |via SSH| GitLabShell[gitlab-shell]
	end
	
	GitLabShell --> |establish Gitaly session| GitlabShellReceiveHook[gitlab-shell\\npre-receive hook]
	subgraph "Gitaly"
		GitlabShellReceiveHook --> |API auth call| GitLabRails[Gitlab-rails]
		GitLabRails --> AcceptOrDecline[accept or decline push]
	end

Architect

%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
	participant Git on client
	participant GitLab SSHD
	participant Rails
	participant Gitaly
	participant Git on server
	Note left of Git on client: git fetch
		Git on client->>+GitLab SSHD: ssh git fetch-pack request
		GitLab SSHD->>+Rails: GET /internal/api/authorized_keys?key=AAAA...
	Note right of Rails: Lookup key ID
		Rails-->>-GitLab SSHD: 200 OK, command="gitlab-shell upload-pack key_id=1"
		GitLab SSHD->>+Rails: GET /internal/api/allowed?action=upload_pack&amp
	Note right of Rails: Auth check
		Rails-->>-GitLab SSHD: 200 OK, { gitaly: ... }
		GitLab SSHD->>+Gitaly: SSHService.SSHUploadPack request
		Gitaly->>+Git on server: git upload-pack request
	Note over Git on client,Git on server: Bidirectional communication between Git client and server
		Git on server-->>-Gitaly: git upload-pack response
		Gitaly -->>-GitLab SSHD: SSHService.SSHUploadPack response
		GitLab SSHD-->>-Git on client: ssh git fetch-pack response

참조

https://docs.gitlab.com/ee/development/gitlab_shell/index.html