GitLab Runner 설치를 위해 현재 지원되는 Debian, Ubuntu, Mint, RHEL, Fedora 및 CentOS 용 패키지를 제공합니다.

Distribution	Version	End of Life date

Distribution	Version	End of Life date
Debian	buster
Debian	stretch	approx. 2022
Debian	jessie	June 2020
Ubuntu	bionic	April 2023
Ubuntu	xenial	April 2021
Mint	sonya	approx. 2021
Mint	serena	approx. 2021
Mint	sarah	approx. 2021
RHEL/CentOS	7	June 2024
RHEL/CentOS	6	November 2020
Fedora	30	approx. June 2020

사전준비사항

만약, Docker executor를 사용할 경우, Runner를 사용하기 전에 Docker를 설치해야 합니다. 배포용 Docker를 설치하는 방법을 참고하시기 바랍니다.

Runner 설치

1.GitLab의 공식 저장소를 추가합니다.

주의 : Debin 사용자는 APT pinning을 해야 합니다.

# For Debian/Ubuntu/Mint
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash

# For RHEL/CentOS/Fedora
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash

2.최신 버전의 GitLab Runner를 설치하거나 특정 버전을 설치합니다.

주의 : Debian buster 사용자는 No such file or directory Job failures를 방지하기 위해 disable skel을 설정해야 합니다.

최신 버전의 GitLab Runner 설치 :

# For Debian/Ubuntu/Mint
sudo apt-get install gitlab-runner

# For RHEL/CentOS/Fedora
sudo yum install gitlab-runner

특정 버전의 GitLab Runner 설치 :

# for DEB based systems
apt-cache madison gitlab-runner
sudo apt-get install gitlab-runner=10.0.0

# for RPM based systems
yum list gitlab-runner --showduplicates | sort -r
sudo yum install gitlab-runner-10.0.0-1

3.Runner를 등록합니다.

APT pinning

gitlab-ci-multi-runner라고 불리는 네이티브 패키지는 Debian Stretch 에서 사용가능 합니다. 기본으로 gitlab-runner를 설치할 때 공식 저장소의 패키지가 우선 순위가 높습니다.

GitLab에서 제공하는 패키지를 사용하려면, 패키지 소스를 수동으로 설정해야합니다. 가장 좋은 방법은 pinning(고정) 구성 파일을 추가하는 것입니다.

이렇게하면 Runner 패키지의 다음 업데이트(수동 또는 자동)는 동일한 소스를 사용하여 수행됩니다.

cat <<EOF | sudo tee /etc/apt/preferences.d/pin-gitlab-runner.pref
Explanation: Prefer GitLab provided packages over the Debian native ones
Package: gitlab-runner
Pin: origin packages.gitlab.com
Pin-Priority: 1001
EOF

Runner 업데이트

최신 버전을 설치하려면 간단히 아래의 명령을 실행합니다.

# For Debian/Ubuntu/Mint
sudo apt-get update
sudo apt-get install gitlab-runner

# For RHEL/CentOS/Fedora
sudo yum update
sudo yum install gitlab-runner

Disable skel

GitLab 12.10부터 도입

때로 기본 스켈레톤(skel) 디렉토리로 인해 GitLab Runner에 문제 가 발생하여 작업을 실행하지 못하는 경우가 있습니다. GitLab Runner 를 설치할 때 패키지를 설치하기 전에 환경 변수 GITLAB_RUNNER_DISABLE_SKEL를 true설정합니다. 이것은 skel내부에 안에 파일 없이 $HOME디렉토리를 만듭니다 :

예를 들면 다음과 같습니다.

# For Debian/Ubuntu/Mint
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runner

# For RHEL/CentOS/Fedora
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E yum install gitlab-runner

Twoseed 공개 자료

Debian/Ubuntu/CentOS/RedHat 저장소를 이용하여 설치

사전준비사항

Runner 설치

APT pinning

Runner 업데이트

Disable skel