GitLab Runner 등록

GitLab UI에는 액세스 할 사용자에 따라 세 가지 유형의 러너가 있습니다.

  • 공유 러너는 GitLab 인스턴스의 모든 그룹 및 프로젝트에서 사용할 수 있습니다. (Admin Area의 CI/CD > Runners)
  • 그룹 러너는 그룹의 모든 프로젝트와 하위 그룹에서 사용할 수 있습니다. (그룹의 Settings > CI/CD > Runners 섹션)
  • 특정 러너는 특정 프로젝트와 연결됩니다. 일반적으로 특정 러너는 하나의 프로젝트에서만 사용됩니다. (프로젝트의 Settings > CI/CD > Runners 섹션)

여기에서는 공유 러너(Shared runner) 를 등록하는 방법을 설명합니다. (Admin 권한 필요)

  1. GitLab Admin Area 페이지로 이동합니다.

    Get Token

  2. 사이드 바에서 CI/CD > Runners를 클릭합니다. 이후 New instance runner 를 클릭합니다.

    Get Token

  3. 태그 없이 Runner을 사용하기 위해 Run untaged jobs 를 체크합니다. 이후 Create runner 를 클릭하여 러너를 생성합니다.

    Get Token

  4. Step1 의 명령어를 복사합니다.

    Get Token

    gitlab-runner register  --url https://gitlab.com/  --token glrt-_QMDghM_5bBuCa_FHy1J

    https://gitlab.com/을 이전 단계에서 호스팅한 GitLab의 external_url로 바꾸고 glrt-_QMDghM_5bBuCa_FHy1J을 사용자의 토큰 값으로 바꿔야 합니다.

  5. 터미널에서 아래 명령을 실행하여 gitlab-runner 컨네이너에 대화형(interactive) bash 셸을 실행합니다.

    docker exec -it gitlab-runner bash

  6. 4번에서 복사한 gitlab-runner register ~ 명령을 실행하고 지침에 따라 아래 항목을 입력합니다.

    • Enter the GitLab instance URL : 아무것도 입력하지 않고 Enter 키를 누릅니다. --url 값이 설정됩니다.

    • Enter the registration token : 아무것도 입력하지 않고 Enter 키를 누릅니다. --token 값이 설정됩니다.

    • Enter a description for the runner : 러너에 대한 설명을 입력하고 Enter 키를 누릅니다. (예: workshop runner)

    • Enter tags for the runner : 아무것도 입력하지 않고 Enter 키를 누릅니다.

    • Enter an executor : docker을 입력하고 Enter 키를 누릅니다.

    • Enter the default Docker image : alpine:latest을 입력하고 Enter 키를 누릅니다.

      root@bed0fbecb393:/# gitlab-runner register  --url https://gitlab.com/  --token glrt-_QMDghM_5bBuCa_FHy1J
Runtime platform                                    arch=amd64 os=linux pid=77 revision=b72e108d version=16.1.0
Running in system-mode.

Enter the GitLab instance URL (for example, https://gitlab.com/):
[https://gitlab.com/]:
Verifying runner... is valid                        runner=_QMDghM_5
Enter a name for the runner. This is stored only in the local config.toml file:
[bed0fbecb393]: workshop runner
Enter an executor: docker-windows, parallels, docker-autoscaler, docker+machine, instance, kubernetes, custom, docker, shell, ssh, virtualbox:
docker
Enter the default Docker image (for example, ruby:2.7):
alpine:latest
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

Configuration (with the authentication token) was saved in "/etc/gitlab-runner/config.toml"

    정상적으로 등록이 완료되면 You’ve created a new runner! 문구가 나타납니다. Get Token

  7. CI/CD > Runners 페이지에서 GitLab UI를 새로고침하면 등록된 러너가 목록에 나타납니다.

    Get Token