GitLab Runner 설치

본 문서에서는 기본적인 GitLab Runner 설치 방법을 알아보도록 하겠습니다.

GitLab Runner는 GitLab CI/CD를 실행하기 위한 Job Agent 입니다.
GitLab에서 CI/CD 파이프라인을 구동하기 위해서는 반드시 필요한 모듈입니다.

설치 환경

GitLab Runner는 다양한 OS 환경에 설치가 가능합니다. 기본적으로 리눅스, MacOS, 윈도우즈를 지원합니다.
리눅스는 공식지원하는 배포판은 다음과 같습니다.

• CentOS, Debian, Ubuntu, RHEL, Fedora, Mint, Oracle, Amazon

본 가이드는 리눅스 환경을 기준으로 설치를 진행합니다.

설치 방법

GitLab Runner는 바이너리 다운로드, 리눅스 패키지, 컨테이너 환경 설치로 진행될 수 있습니다.

바이너리 설치

먼저 GitLab Runner 바이너리 다운로드 방식을 알아 보겠습니다.
다음 명령을 통해 OS 환경에 맞는 바이너리를 다운 받습니다.

# For Debian/Ubuntu/Mint
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_amd64.deb"

# For RHEL/CentOS/Fedora
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_amd64.rpm"

다운로드 파일에 실행 명령을 추가 합니다.

chmod +x ./gitlab-runner

GitLab Runner 를 설치하고, 서비스를 시작합니다.

sudo ./gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

패키지 설치

리눅스 패키지를 다운로드 받아 설치를 진행합니다.
다음 명령을 통해 OS 환경에 맞는 패키지를 설치 합니다.

# For Debian/Ubuntu/Mint
curl -LJO <https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_amd64.deb>
# Install the runner
sudo dpkg -i gitlab-runner_amd64.deb

# For RHEL/CentOS/Fedora
curl -LJO <https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_amd64.rpm>
# Install the runner
sudo rpm -i gitlab-runner_amd64.rpm

컨테이너 설치

리눅스 컨테이너 환경에서 GitLab Runner를 구동할 수 있습니다.
여기서는 Docker와 Docker Compose가 이미 설치되어 있다는 가정하에 진행하겠습니다.

먼저, GitLab Runner를 구동하기 위한 디렉토리를 생성합니다.

## GitLab Runner가 사용할 디렉토리 생성
sudo mkdir -p /data/gitlab-runner/config

## 디렉토리 권한 변경
sudo chown -R $USER:$USER /app/gitlab-runner

위에서 생성한 /data/gitlab-runner 경로 아래 다음 내용으로 docker-compose.yml 파일을 생성합니다.

version: '3.9'

services:
  gitlab-runner:
    container_name: gitlab-runner
    image: 'gitlab/gitlab-runner:latest'
    restart: always
    volumes:
      - './config:/etc/gitlab-runner'
      - '/var/run/docker.sock:/var/run/docker.sock'

Docker Compose를 기동합니다.

cd /app/gitlab-runner
docker-compose up -d

GitLab Runner가 설치가 완료되었다면, 다음으로 GitLab Runner를 GitLab에 등록합니다.