GitLab Runner와 클러스터 관리 프로젝트 설치

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

이미 관리 프로젝트 템플릿을 사용하여 프로젝트를 생성했다고 가정하고, GitLab Runner를 설치하려면 helmfile.yaml에서 다음 줄의 주석 처리를 해제해야 합니다. 

  - path: applications/gitlab-runner/helmfile.yaml

GitLab Runner는 클러스터의 gitlab-managed-apps 네임스페이스에 기본적으로 설치됩니다.

필수 변수

GitLab Runner를 사용하려면 반드시 다음을 applications/gitlab-runner/values.yaml.gotmpl 파일에 지정해야 합니다:

  • gitlabUrl: Runner를 등록할 GitLab 서버의 전체 URL (예: https://gitlab.example.com).

  • Runner 토큰: 이는 GitLab 인스턴스에서 검색해야 합니다. 다음 중 하나를 사용할 수 있습니다:

    • runnerToken: GitLab UI에서 생성된 runner 구성을 위한 runner 인증 토큰.
    • runnerRegistrationToken(GitLab 15.6에서 중단 예정, GitLab 17.0에서 제거 예정): GitLab에 새 runner를 추가하기 위한 등록 토큰.

이러한 값을 지정하는 방법은 상호 배타적입니다. 다음 중 하나를 선택할 수 있습니다:

  • GITLAB_RUNNER_TOKEN 및 CI_SERVER_URL을 CI 변수로 지정합니다(권장).
  • applications/gitlab-runner/values.yaml.gotmpl에서 runnerToken: 및 gitlabUrl:의 값을 제공합니다.

Runner 등록 토큰은 runner에 의해 프로젝트에 연결을 허용하므로 악용 및 코드 유출을 방지하기 위해 비밀로 다루어야 합니다. 따라서, runner 등록 토큰을 보호된 변수로 지정하고 마스크된 변수로 처리하고 values.yaml.gotmpl 파일에 커밋하지 않는 것이 좋습니다.

GitLab Runner의 설치를 사용자 정의하려면 클러스터 관리 프로젝트에서 applications/gitlab-runner/values.yaml.gotmpl 파일을 정의할 수 있습니다. 사용 가능한 구성 옵션에 대한 자세한 내용은 차트를 참조하세요.