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: GitLab 서버의 전체 URL(예: https://gitlab.example.com), Runner를 등록할 서버입니다.

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

    • runnerToken: Runner 구성을 위해 러너 인증 토큰입니다. 이는 GitLab UI에서 생성됩니다.
    • runnerRegistrationToken (deprecated) (GitLab 15.6에서 deprecated되었으며, 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 파일에 이러한 정보를 커밋하지 않는 것이 좋습니다.

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