GitLab Runner Helm 차트는 Kubernetes 클러스터에 GitLab Runner 인스턴스를 배포하는 공식 방법입니다. 이 차트는 GitLab Runner를 다음과 같이 설정합니다:

• GitLab Runner에 Kubernetes executor를 사용하여 실행합니다.
• 각 새로운 CI/CD 잡에 대해 지정된 네임스페이스에 새 파드를 프로비저닝합니다.

Helm 차트로 GitLab Runner 설정#

GitLab Runner 설정 변경 사항을 values.yaml에 저장하세요. 이 파일 설정에 대한 도움말은 다음을 참조하세요:

• 차트 리포지터리의 기본 values.yaml 설정.
• values 파일이 기본값을 재정의하는 방법을 설명하는 Values Files에 대한 Helm 문서.

GitLab Runner가 제대로 실행되려면 설정 파일에 다음 값을 설정해야 합니다:

• gitlabUrl: 러너를 등록할 GitLab 서버의 전체 URL(https://gitlab.example.com과 같은 형식).
• rbac: { create: true }: GitLab Runner가 잡을 실행할 파드를 생성할 수 있도록 RBAC(권한 기반 액세스 제어) 규칙을 생성합니다.

  • 기존 serviceAccount를 사용하려면 rbac에 서비스 계정 이름을 추가하세요:

    rbac:
      create: false
    serviceAccount:
      create: false
      name: your-service-account
    

  • serviceAccount에 필요한 최소 권한에 대해서는 러너 API 권한 설정을 참조하세요.

• runnerToken: GitLab UI에서 러너를 생성할 때 얻는 인증 토큰.
  • 이 토큰을 직접 설정하거나 시크릿에 저장하세요.

추가적인 선택적 설정도 사용할 수 있습니다.

이제 GitLab Runner를 설치할 준비가 되었습니다!

Helm 차트로 GitLab Runner 설치#

사전 요구 사항:

• GitLab 서버의 API가 클러스터에서 접근 가능해야 합니다.
• 베타 API가 활성화된 Kubernetes 1.4 이상.
• kubectl CLI가 로컬에 설치되어 있고 클러스터에 대해 인증되어 있어야 합니다.
• Helm 클라이언트가 로컬 머신에 설치되어 있어야 합니다.
• values.yaml에 필요한 모든 값을 설정했어야 합니다.

Helm 차트에서 GitLab Runner를 설치하려면:

1. GitLab Helm 리포지터리를 추가하세요:

   helm repo add gitlab https://charts.gitlab.io
   

2. Helm 2를 사용하는 경우 helm init으로 Helm을 초기화하세요.

3. 접근 가능한 GitLab Runner 버전을 확인하세요:

   helm search repo -l gitlab/gitlab-runner
   

4. 최신 버전의 GitLab Runner에 접근할 수 없는 경우 다음 명령으로 차트를 업데이트하세요:

   helm repo update gitlab
   

5. values.yaml 파일에서 GitLab Runner를 설정한 후 필요에 따라 파라미터를 변경하여 이 명령을 실행하세요:

   # Helm 2의 경우
   helm install --namespace  --name gitlab-runner -f  gitlab/gitlab-runner
   
   # Helm 3의 경우
   helm install --namespace  gitlab-runner -f  gitlab/gitlab-runner
   

   • : GitLab Runner를 설치할 Kubernetes 네임스페이스.
   • : 사용자 지정 설정을 포함하는 values 파일의 경로. 생성 방법은 Helm 차트로 GitLab Runner 설정을 참조하세요.
   • 특정 버전의 GitLab Runner Helm 차트를 설치하려면 helm install 명령에 --version 을 추가하세요. 모든 버전의 차트를 설치할 수 있지만 최신 values.yml은 이전 버전의 차트와 호환되지 않을 수 있습니다.

사용 가능한 GitLab Runner Helm 차트 버전 확인#

Helm 차트와 GitLab Runner는 같은 버전 관리 체계를 따르지 않습니다. 두 버전 간의 매핑을 보려면 사용하는 Helm 버전에 맞는 명령을 실행하세요:

# Helm 2의 경우
helm search -l gitlab/gitlab-runner

# Helm 3의 경우
helm search repo -l gitlab/gitlab-runner

출력 예시:

NAME                  CHART VERSION APP VERSION DESCRIPTION
gitlab/gitlab-runner  0.64.0        16.11.0     GitLab Runner
gitlab/gitlab-runner  0.63.0        16.10.0     GitLab Runner
gitlab/gitlab-runner  0.62.1        16.9.1      GitLab Runner
gitlab/gitlab-runner  0.62.0        16.9.0      GitLab Runner
gitlab/gitlab-runner  0.61.3        16.8.1      GitLab Runner
gitlab/gitlab-runner  0.61.2        16.8.0      GitLab Runner
...

Helm 차트로 GitLab Runner 업그레이드#

사전 요구 사항:

• GitLab Runner 차트가 설치되어 있어야 합니다.
• GitLab에서 러너를 일시 중지했어야 합니다. 이렇게 하면 잡과 관련된 문제(예: 완료 시 인증 오류)를 방지할 수 있습니다.
• 모든 잡이 완료되었는지 확인했어야 합니다.

설정을 변경하거나 차트를 업데이트하려면 필요에 따라 파라미터를 변경하여 helm upgrade를 사용하세요:

helm upgrade --namespace  -f   gitlab/gitlab-runner

• : GitLab Runner가 설치된 Kubernetes 네임스페이스.
• : 사용자 지정 설정을 포함하는 values 파일의 경로. 생성 방법은 Helm 차트로 GitLab Runner 설정을 참조하세요.
• : 설치 시 차트에 지정한 이름. 설치 섹션에서는 gitlab-runner라고 명명했습니다.
• 최신 버전이 아닌 특정 버전의 GitLab Runner Helm 차트로 업데이트하려면 helm upgrade 명령에 --version 을 추가하세요.

Helm 차트로 GitLab Runner 제거#

GitLab Runner를 제거하려면:

1. GitLab에서 러너를 일시 중지하고 모든 잡이 완료되었는지 확인하세요. 이렇게 하면 잡 관련 문제(예: 완료 시 인증 오류)를 방지할 수 있습니다.

2. 필요에 따라 수정하여 다음 명령을 실행하세요:

   helm delete --namespace  
   

   • 는 GitLab Runner가 설치된 Kubernetes 네임스페이스입니다.
   • 은 설치 시 차트에 지정한 이름입니다. 이 페이지의 설치 섹션에서는 gitlab-runner라고 명명했습니다.