워크호스 핸들러
긴 HTTP 요청은 Rails에서 효율적으로 처리하기 어렵습니다.
요청은 메모리 비효율적이거나(파일 업로드) 짧은 타임아웃으로 인해 전혀 불가능합니다.
(예를 들어, Puma 서버는 60초 타임아웃이 있습니다.)
워크호스는 많은 긴 HTTP 요청을 효율적으로 처리할 수 있습니다.
워크호스는 모든 HTTP 요청을 가로채고 이를 변경하지 않고 전파하거나 추가 로직을 수행하여 직접 처리하는 프록시 역할을 합니다.
주입기
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
participant Client
participant Workhorse
participant Rails
Client->>+Workhorse: 요청
Workhorse->>+Rails: 요청을 있는 그대로 전파
Rails-->>-Workhorse: 요청 진행에 대한 지침을 포함한 특별 헤더로 응답
Workhorse-->>Client: 응답
예시: Git blob 전송
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
participant Client
participant Workhorse
participant Rails
participant Gitaly
Client->>+Workhorse: blob에 대한 HTTP 요청
Workhorse->>+Rails: 요청을 있는 그대로 전파
Rails-->>-Workhorse: git-blob:{encoded_data} 헤더로 응답
Workhorse->>+Gitaly: BlobService.GetBlob gRPC 요청
Gitaly-->>-Workhorse: BlobService.GetBlob gRPC 요청
Workhorse-->>Client: 데이터 스트리밍
GitLab Rails가 요청을 처리하는 방법
워크호스가 헤더를 처리하는 방법
예시: 파일 전송
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
participant Client
participant Workhorse
participant Rails
participant Object Storage
Client->>+Workhorse: 파일에 대한 HTTP 요청
Workhorse->>+Rails: 요청을 있는 그대로 전파
Rails-->>-Workhorse: send-url:{encoded_data} 헤더로 응답
Workhorse->>+Object Storage: 파일 요청
Object Storage-->>-Workhorse: 데이터 스트리밍
Workhorse-->>Client: 데이터 스트리밍
사전 승인된 요청
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
participant Client
participant Workhorse
participant Rails
participant Object Storage
Client->>+Workhorse: PUT /artifacts/uploads
Note right of Rails: 원래 URL에 `/authorize`를 추가하고 Rails에 Auth 확인 요청
Workhorse->>+Rails: GET /artifacts/uploads/authorize
Rails-->>-Workhorse: 승인 성공
Client->>+Workhorse: 파일 내용을 스트리밍
Workhorse->>+Object Storage: 파일 업로드
Object Storage-->>-Workhorse: 성공
Workhorse->>+Rails: 요청 마무리
Note right of Rails: Workhorse가 데이터베이스 레코드를 생성하기 위해 원래 URL을 호출
Rails-->>-Workhorse: 성공적으로 마무리됨
Workhorse-->>Client: 성공적으로 업로드됨
HTTP(S)에서의 Git
Workhorse는 Git HTTP 프로토콜 요청을 처리하여 HTTP(S)에서 Git을 가속화합니다. 예를 들어, Git push/pull은 대량의 데이터를 제공해야 할 수 있습니다. 이를 GitLab Rails를 통해 전송하는 것을 피하기 위해, Workhorse는 GitLab Rails에 대해 인증 확인만 수행한 다음, Gitaly gRPC 요청을 직접 수행하고 Gitaly에서 Git 클라이언트로 데이터를 스트리밍합니다.
Git pull
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
participant Git on client
participant Workhorse
participant Rails
participant Gitaly
Note left of Git on client: git clone/fetch
Git on client->>+Workhorse: GET /foo/bar.git/info/refs/?service=git-upload-pack
Workhorse->>+Rails: GET Repositories::GitHttpController#info_refs
Note right of Rails: 접근 확인/활동 기록
Rails-->>Workhorse: 200 OK, Gitlab::Workhorse.git_http_ok
Workhorse->>+Gitaly: SmartHTTPService.InfoRefsUploadPack gRPC 요청
Gitaly -->>-Workhorse: SmartHTTPService.InfoRefsUploadPack gRPC 응답
Workhorse-->>-Git on client: info-refs 응답 전송
Git on client->>+Workhorse: GET /foo/bar.git/info/refs/?service=git-upload-pack
Workhorse->>+Rails: GET Repositories::GitHttpController#git_receive_pack
Note right of Rails: 접근 확인/통계 업데이트
Rails-->>Workhorse: 200 OK, Gitlab::Workhorse.git_http_ok
Workhorse->>+Gitaly: SmartHTTPService.PostUploadPackWithSidechannel gRPC 요청
Gitaly -->>-Workhorse: SmartHTTPService.PostUploadPackWithSidechannel gRPC 응답
Workhorse-->>-Git on client: 응답 전송
Git push
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
participant Git on client
participant Workhorse
participant Rails
participant Gitaly
Note left of Git on client: git push
Git on client->>+Workhorse: GET /foo/bar.git/info/refs/?service=git-receive-pack
Workhorse->>+Rails: GET Repositories::GitHttpController#info_refs
Note right of Rails: 접근 확인/활동 기록
Rails-->>Workhorse: 200 OK, Gitlab::Workhorse.git_http_ok
Workhorse->>+Gitaly: SmartHTTPService.InfoRefsReceivePack gRPC 요청
Gitaly -->>-Workhorse: SmartHTTPService.InfoRefsReceivePack gRPC 응답
Workhorse-->>-Git on client: info-refs 응답 전송
Git on client->>+Workhorse: GET /foo/bar.git/info/refs/?service=git-receive-pack
Workhorse->>+Rails: GET Repositories::GitHttpController#git_receive_pack
Note right of Rails: 접근 확인/통계 업데이트
Rails-->>Workhorse: 200 OK, Gitlab::Workhorse.git_http_ok
Workhorse->>+Gitaly: SmartHTTPService.PostReceivePackWithSidechannel gRPC 요청
Gitaly -->>-Workhorse: SmartHTTPService.PostReceivePackWithSidechannel gRPC 응답
Workhorse-->>-Git on client: 응답 전송
도움말