개요

• GitLab Agent for Kubernetes는 GitLab과 Kubernetes 간의 통합 작업을 해결하기 위한 클러스터 내에서 활성화된 구성 요소입니다.
• 클러스터 내에서 실행되는 GitLab Agent (agentk)와 GitLab 측에서 실행되는 GitLab Agent Server (gitlab-kas) 두 가지로 구성됩니다.

High-level architecture

• GitLab 에이전트와 GitLab 에이전트 서버는 양방향 스트리밍을 사용하여 GitLab 에이전트 서버가 클라이언트처럼 동작할 수 있게 합니다.
• GitLab 에이전트 서버는 gRPC 응답으로 요청을 보냅니다. 클라이언트-서버 관계가 역전되는 이유는 방화벽이나 NAT 뒤에 위치할 수 있는 쿠버네티스 클러스터 내부에서 연결을 시작해야 하기 때문입니다. 관련 이슈 : https://gitlab.com/gitlab-org/gitlab/-/issues/212810

graph LR
  agentk <-- gRPC 양방향 통신 --> kas
  
  subgraph "GitLab"
  kas[kas]
  GitLabRoR[GitLab RoR] -- gRPC --> kas
  kas -- gRPC --> Gitaly[Gitaly]
  kas -- REST API --> GitLabRoR
  end
  
  subgraph "Kubernetes Cluster"
  agentk[agentk]
  end

• GitLab RoR은 주요 GitLab 어플리케이션으로 kas와 통신하기 위해 gRPC를 사용합니다.
• agentk는 GitLab 에이전트로 요청을 처리하기 위해 kas와 통신을 유지합니다. 클러스터에서 발생하는 이벤트에 대한 정보를 전송합니다.
• kas는 GitLab 에이전트 서버로 다음과 같은 역할을 담당합니다.
  • agentk의 요청 수락
  • GitLab RoR에 쿼리하여 agentk의 요청 인증
  • Gitaly에 쿼리하여 해당 Git 리포지토리에서 에이전트의 구성 가져오기
  • Gitlab RoR로부터의 들어오는 요청을 적절한 agentk와의 기존 연결과 매칭하여 요청을 전달하고 응답을 전달
  • [Option] agentk로부터 수신된 이벤트에 대한 알림을 ActionCable을 통해 전송
  • Gitaly와 통신하여 GitOps 지원을 위해 매니페스트 리포지토리 폴링

참조

https://gitlab.com/gitlab-org/cluster-integration/gitlab-agent/-/blob/master/doc/architecture.md