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 구성의 인증 토큰입니다.
    • runnerRegistrationToken (deprecated in GitLab 15.6, GitLab 17.0에서 제거 예정): 새로운 러너를 GitLab에 추가하기 위해 사용되는 등록 토큰입니다.

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

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

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

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

러너 등록 토큰은 러너에 의해 프로젝트와 연결을 허용하므로, 악의적인 사용 및 코드 유출을 방지하기 위해 비밀로 취급해야 합니다. 이 이유로, 러너 등록 토큰을 보호 변수와 마스킹된 변수로 지정하고 values.yaml.gotmpl 파일에 Git 리포지토리에 커밋하지 않을 것을 권장합니다.

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