관리 프로젝트 템플릿에서 이미 프로젝트를 생성했다고 가정하면, 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).

• 러너 토큰: GitLab 인스턴스에서 가져와야 합니다. 다음 토큰 중 하나를 사용할 수 있습니다.

  • runnerToken: GitLab UI에서 생성한 러너 구성의 러너 인증 토큰입니다.
  • runnerRegistrationToken(GitLab 15.6에서 더 이상 사용되지 않으며 GitLab 20.0에서 제거될 예정입니다.): GitLab에 새 러너를 추가하는 데 사용하는 등록 토큰입니다.

이 값들은 CI/CD 변수로 지정할 수 있습니다.

• CI_SERVER_URL은 gitlabUrl에 사용합니다. GitLab.com을 사용한다면 이 변수를 설정하지 않아도 됩니다.
• GITLAB_RUNNER_TOKEN은 runnerToken에 사용합니다.
• GITLAB_RUNNER_REGISTRATION_TOKEN은 runnerRegistrationToken에 사용합니다(더 이상 사용되지 않음).

이 값들을 지정하는 두 방법은 함께 사용할 수 없습니다. 다음 중 하나를 선택합니다.

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

러너 등록 토큰은 러너가 프로젝트에 연결하도록 허용합니다. 러너를 통한 악의적인 사용과 코드 유출을 막기 위해 이 토큰을 비밀 정보로 취급합니다. 러너 등록 토큰은 보호된 변수와 마스킹된 변수로 지정합니다. values.yaml.gotmpl 파일에 토큰을 넣어 Git 리포지터리에 커밋하지 않습니다.

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