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: Runner 구성을 위한 runner 인증 토큰 GitLab UI에서 생성.
    • runnerRegistrationToken (deprecated) (GitLab 15.6부터 삭제 예정되어 있음): GitLab에 새로운 Runner를 추가하는 데 사용되는 등록 토큰입니다.

이러한 값들은 CI/CD 변수를 사용하여 지정할 수 있습니다.

  • CI_SERVER_URL은 gitlabUrl에 사용됩니다. GitLab.com을 사용하는 경우 이 변수를 설정할 필요가 없습니다.
  • GITLAB_RUNNER_TOKEN은 runnerToken에 사용됩니다.
  • GITLAB_RUNNER_REGISTRATION_TOKEN은 runnerRegistrationToken에 사용됩니다 (deprecated).

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

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

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

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