• 에이전트 서버 비활성화
  • Ingress 지정
  • 설치 명령줄 옵션
• TLS 통신 활성화
• kas 차트 테스트
• KEDA 구성
  • serviceAccount
  • affinity
• 디버그 로깅 활성화

GitLab kas 차트 사용하기

kas 서브 차트는
GitLab 에이전트 서버(KAS)의
구성 가능한 배포를 제공합니다.
에이전트 서버는 GitLab과 함께 설치하는 구성 요소로,
Kubernetes용 GitLab 에이전트를
관리하는 데 필요합니다.

이 차트는 GitLab API 및 Gitaly 서버에 대한 액세스에 의존합니다.
이 차트를 활성화하면 Ingress가 배포됩니다.

최소한의 리소스를 소비하기 위해 kas 컨테이너는
디스트롤레스 이미지를 사용합니다.
배포된 서비스는 Ingress에 의해 공개되며, 이는
WebSocket 프록싱을 통해
통신합니다.
이 프록시는 외부 구성 요소인
agentk와
오래 지속되는 연결을 가능하게 합니다.
agentk는 Kubernetes 클러스터 측의 에이전트입니다.

서비스에 접근하는 경로는 Ingress 구성에 따라 달라집니다.

자세한 내용은
Kubernetes용 GitLab 에이전트 아키텍처를
참고하십시오.

에이전트 서버 비활성화

GitLab 에이전트 서버(kas)는 기본적으로 활성화되어 있습니다.
GitLab 인스턴스에서 이를 비활성화하려면 헬름 속성
global.kas.enabled를 false로 설정하십시오.

예를 들어:

helm upgrade --install kas --set global.kas.enabled=false  

Ingress 지정

기본 구성으로 차트의 Ingress를 사용할 때,
에이전트 서버의 서비스는 서브 도메인에서
접근할 수 있습니다.
예를 들어, global.hosts.domain: example.com의 경우,
에이전트 서버는 kas.example.com에서 접근할 수 있습니다.

KAS Ingress는
global.hosts.domain과 다른 도메인을 사용할 수 있습니다.

예를 들어 global.hosts.kas.name을 설정하십시오:

global.hosts.kas.name: kas.my-other-domain.com  

이 예시는 KAS Ingress 전용으로 kas.my-other-domain.com을 호스트로 사용합니다.
다른 서비스(GitLab, Registry, MinIO 등)는
global.hosts.domain에 지정된 도메인을 사용합니다.

설치 명령줄 옵션

helm install 명령에 이러한 매개변수를 --set 플래그를 사용하여
전달할 수 있습니다.

TLS 통신 활성화

귀하의 kas 포드와 기타 GitLab 차트 구성 요소 간의 TLS 통신을 활성화하려면 전역 KAS 속성을 통해 설정하세요.

kas 차트 테스트

차트를 설치하려면:

1. 자신의 Kubernetes 클러스터를 생성합니다.
2. 병합 요청의 작업 브랜치를 체크아웃합니다.

3. 로컬 차트 브랜치에서 기본적으로 kas가 활성화된 GitLab을 설치(또는 업그레이드)합니다:

   helm upgrade --force --install gitlab . \
     --timeout 600s \
     --set global.hosts.domain=your.domain.com \
     --set global.hosts.externalIP=XYZ.XYZ.XYZ.XYZ \
     --set certmanager-issuer.email=your@email.com
   

4. GDK를 사용하여 프로세스를 실행하고 Kubernetes용 GitLab 에이전트를 구성하고 사용합니다: (에이전트를 수동으로 구성하고 사용하는 단계도 따를 수 있습니다.)

   1. GDK GitLab 리포지토리에서 QA 폴더로 이동합니다: cd qa.

   2. 다음 명령을 실행하여 QA 테스트를 실행합니다:

      GITLAB_USERNAME=$ROOT_USER
      GITLAB_PASSWORD=$ROOT_PASSWORD
      GITLAB_ADMIN_USERNAME=$ROOT_USER
      GITLAB_ADMIN_PASSWORD=$ROOT_PASSWORD
      bundle exec bin/qa Test::Instance::All https://your.gitlab.domain/ -- --tag orchestrated --tag quarantine qa/specs/features/ee/api/7_configure/kubernetes/kubernetes_agent_spec.rb
      

      환경 변수를 사용하여 설치할 agentk 버전을 사용자 정의할 수 있습니다: GITLAB_AGENTK_VERSION=v13.7.1

KEDA 구성

이 keda 섹션은 일반 HorizontalPodAutoscalers 대신 KEDA ScaledObjects의 설치를 활성화합니다.

이 구성은 선택 사항이며, 사용자 정의 또는 외부 메트릭에 따라 자동 확장이 필요할 때 사용할 수 있습니다.

대부분의 설정은 적용 가능한 경우 hpa 섹션에 설정된 값의 기본값을 사용합니다.

다음 조건이 충족되면 CPU 및 메모리 임계값에 따라 CPU 및 메모리 트리거가 자동으로 추가됩니다:

• triggers가 설정되지 않음.
• 해당 request.cpu.request 또는 request.memory.request 설정이 0이 아닌 값으로 설정됨.

트리거가 설정되지 않으면 ScaledObject가 생성되지 않습니다.

자세한 설정 정보는 KEDA 문서를 참조하세요.

serviceAccount

이 섹션은 ServiceAccount를 생성할지 여부와 기본 액세스 토큰이 파드에 마운트되어야 하는지를 제어합니다.

affinity

자세한 내용은 affinity를 참조하세요.

디버그 로깅 활성화

KAS 서브 차트에 대한 디버그 로깅을 활성화하려면 values.yaml 파일의 kas 섹션에 다음을 추가하세요:

customConfig:
   observability:
      logging:
         level: debug
         grpc_level: debug