220630 목 GitLab Runner 설치 방법

GitLab Runner 설치 방법

GitLab 파이프라인을 사용하여 job을 생성했는데, 자꾸 failed 가 발생합니다.

CI / CD > Jobs 를 확인해보면 활성화된 Runner 가 없다는 에러가 발생했다는 것을 확인할 수 있었습니다.

This job is stuck because you don't have any active runners that can run this job.
Go to project CI Settings

안내가 요구한 대로 Settings > CI / CD 메뉴에서 Runners 탭을 활성화 시켜줍니다.

---

그럼 Show runner installation instructions (설치 가이드) 버튼을 클릭하여,
현재 사용하고 있는 서버의 (또는 필요한 서버의) OS에 맞게 설치를 해주면 됩니다.

저는 제 로컬에서 runner를 실행할 예정이고, 저는 macOS 를 사용하고 있으므로, macOS 탭을 클릭해서 설치를 해줄 겁니다.

# Download the binary for your system
sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64

# Give it permission to execute (gitlab runner 에게 권한 허가해주기)
sudo chmod +x /usr/local/bin/gitlab-runner

# The rest of the commands execute as the user who will run the runner
# Register the runner (steps below), then run (runner 설치)
cd ~
gitlab-runner install
gitlab-runner start

설치방식은 깃 랩 버전에 따라 달라질 수 있으니 GitLab 이 하라는 대로 커맨드 라인에 따라 하면 됩니다.

저는 한번 runner를 설치한 이력이 있어서 에러가 발생했습니다.

이럴 땐 삭제하고 다시 설치해주면 됩니다.

gitlab-runner uninstall
gitlab-runner install
gitlab-runner start

runner 설치가 완료되었으면, runner를 등록해주어야 합니다. 이 부분도 가이드 하단(Command to register runner)에 적힌 것처럼 따라 하면 됩니다.

gitlab-runner register --url <$URL> --registration-token <$REGISTRATION_TOKEN>

$URL 과 $REGISTRATION_TOKEN 에는, 프로젝트 URL과, Setting > CI/CD > Runners 탭에서 지급받았던 토큰을 입력하면 됩니다.

---

Enter an executor:
shell, ssh, kubernetes, custom, docker, docker-ssh, parallels, virtualbox, docker+machine, docker-ssh+machine:

마지막에 Executor를 선택하라고 합니다. 저는 로컬로 돌렸기 때문에 shell 로 선택했습니다.
이 부분은 나의 상황에 맞게 설정해주세요.

Executor에 관한 설명은 CI Runners & Executors 가이드를 참고해주세요

Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

runner 등록이 완료되었습니다.

다시 JOB을 돌리면 성공이 뜨는 것을 확인할 수 있습니다.