Runner 등록은 Runner를 GitLab 인스턴스와 바인딩하는 프로세스입니다.

참고 사이트
- Supported options for self-signed certificates
- Registering Runners

준비사항

GitLab 인터페이스를 통해 Shared 또는 Specific Runner의 token을 확인합니다.
- token은 GitLab 메뉴의 Admin > Runner에서 확인할 수 있습니다.

자체 서명 된 인증서를 지원 옵션

GitLab Runner는 기본적으로 시스템 인증서 저장소를 읽고 시스템에 저장된 인증 기관(CA)에 대해 GitLab 서버를 확인합니다.

GitLab Runner 는 사전 정의 된 파일에서 PEM 인증서(DER 형식은 지원되지 않음)를 읽습니다 .

/etc/gitlab-runner/certs/hostname.crt GitLab Runner가 root로 실행될 때 * nix 시스템
~/.gitlab-runner/certs/hostname.crt GitLab Runner가 root 이외의 계정으로 실행될 때 * nix 시스템
./certs/hostname.crt다른 시스템인 경우. Runner를 Windows 서비스로 실행하는 경우 동작하지 않습니다. 마지막 옵션을 사용해야 합니다.

서버 주소가 https://my.gitlab.server.com:8443/이면, /etc/gitlab-runner/certs/my.gitlab.server.com.crt에 인증 파일을 생성합니다.

본 예제는 GitLab 설치시 생성된 자체 서명된 인증서(/etc/gitlab/ssl/gitlab.twoseed.com.crt)를 GitLab Runner가 설치된 위치(/etc/gitlab-runner)에 certs 디렉터리를 생성 후 복사하였습니다.

$ cp /etc/gitlab/ssl/gitlab.twoseed.com.crt /etc/gitlab-runner/certs/gitlab.twoseed.com.crt

1.다음 명령을 실행합니다.

sudo gitlab-runner register

2.GitLab 인스턴스 URL을 입력합니다.

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com )
https://gitlab.com

3.Runner를 등록하기 위한 token을 입력합니다.

Please enter the gitlab-ci token for this runner
xxx

4.Runner에 대한 설명을 입력합니다. (GitLab 인터페이스를 통해 변경할 수 있습니다)

5.Runner와 관련된 tag를 입력합니다. (GitLab 인터페이스를 통해 변경할 수 있습니다)

6.사용할 Runner executor를 입력합니다.

다른 환경의 Runner를 등록할 경우 Registering Runner를 참고합니다.

gitlab runner 검사 후 불필요한 runner를 삭제하는 명령어는 아래와 같습니다.

$ gitlab-runner verify --delete