[GitLab] Runner 설치 및 등록

Git | GitLab

[GitLab] Runner 설치 및 등록

비번변경 2025. 2. 18. 11:33

개요

2025.02.06-[GitLab] 파이프라인 구성에서는 GitLab 호스팅 러너를 사용하여 파이프라인을 실행해 보았다. 이번 글에서는 직접 구성하고 등록한 러너에서 파이프라인을 실행해보려고 한다.

테스트 환경은 다음과 같다.

GitLab 서비스 : gitlab.com
러너 유형 : 프로젝트 러너
사용 서버 : AWS EC2 Ubuntu 22.04 LTS arm64

방법을 적어둔다.

프로젝트 러너 생성

1. New project runner 버튼 클릭

프로젝트의 CI/CD 설정 페이지에서 New project runner 버튼을 클릭한다.

2. 신규 프로젝트 러너 생성

러너의 태그 값을 지정하고, 필요시 추가 구성 옵션을 설정한다. 설정이 완료되면 러너 만들기 버튼을 클릭한다.

이번 글에서는 별도 설정 없이 생성했다. 별다른 이상이 없으면 아래와 같이 Runner created라는 메시지와 함께 러너 등록 페이지로 이동한다.

러너 설치

GitLab 프로젝트에 러너를 등록하기 위해서는 먼저 러너 설치가 선행되어야 한다.

1. 러너 설치

적절할 환경을 선택한 후 하단의 How do I install GitLab Runner? 버튼을 클릭하면 위 그림과 같이 오른쪽에서 설치 방법을 확인할 수 있다. 사용하고자 하는 구조를 선택한 후 명령어를 복사 및 실행하여 러너를 설치하자.

이 글에서는 Ubuntu arm64 서버를 사용하고자 한다.

1.1) GitLab 러너 다운로드 및 실행 권한 추가

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

# Give it permission to execute
sudo chmod +x /usr/local/bin/gitlab-runner

1.2) gitlab-ruuner 사용자 추가

# Create a GitLab Runner user
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

1.3) GitLab Runner 설치 및 시작

# Install and run as a service
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

러너 등록

위의 Register runner 페이지를 이어서 진행한다.

1. gitlab runner 등록

gitlab-runner register 명령을 실행해 runner를 등록한다.

gitlab-runner register \
    --url GITLAB_URL \
    --token TOKEN
    
# 예시
gitlab-runner register \
    --url https://gitlab.com \
    --token TOKENTOKEN