관리 프로젝트 템플릿에서 이미 프로젝트를 만들었다고 가정하면, 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 설치를 사용자 정의할 수 있습니다. 사용 가능한 구성 옵션에 대해서는 차트를 참조하세요.