GitLab Runner을 GNU/Linux에 수동으로 설치하기

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed

deb/rpm 저장소를 사용하여
GitLab Runner을 설치할 수 없거나,
당신의 GNU/Linux OS가 지원되는 운영 체제 목록에 없다면,
아래 방법 중 하나를 사용하여 수동으로 설치할 수 있습니다.
마지막 수단으로 이용하세요.

Docker executor를 사용하려면,
GitLab Runner을 사용하기 전에
Docker를
설치해야 합니다.

GitLab Runner과 관련된 가장 일반적인 문제를 설명하는
FAQ 섹션을 반드시 읽어보세요.

deb/rpm 패키지 사용

필요하다면 deb 또는 rpm 패키지를 사용하여
다운로드하고 설치할 수 있습니다.

다운로드

시스템에 적합한 패키지를 다운로드하려면:

https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html에서
최신 파일 이름과 옵션을 확인하세요.

  1. 버전을 선택하고,
    다른 태그 릴리스를 다운로드하는 문서에서
    설명된 대로 바이너리를 다운로드하세요.

예를 들어, Debian 또는 Ubuntu의 경우:

# ${arch}를 지원되는 아키텍처 중 하나로 교체하세요, e.g. amd64, arm, arm64  
# 지원되는 아키텍처의 전체 목록은 여기에서 확인할 수 있습니다  
# https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html  
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/deb/gitlab-runner_${arch}.deb"

예를 들어, CentOS 또는 Red Hat Enterprise Linux의 경우:

# ${arch}를 지원되는 아키텍처 중 하나로 교체하세요, e.g. amd64, arm, arm64  
# 지원되는 아키텍처의 전체 목록은 여기에서 확인할 수 있습니다  
# https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html  
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/rpm/gitlab-runner_${arch}.rpm"

예를 들어, RHEL에서 FIPS 준수 GitLab Runner의 경우:

# 현재 amd64만 지원되는 아키텍처입니다  
# 지원되는 아키텍처의 전체 목록은 여기에서 확인할 수 있습니다  
# https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html  
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/rpm/gitlab-runner_amd64-fips.rpm"

설치

다음과 같이 시스템에 맞는 패키지를 설치하세요.

예를 들어, Debian 또는 Ubuntu의 경우:

dpkg -i gitlab-runner_<arch>.deb

예를 들어, CentOS 또는 Red Hat Enterprise Linux의 경우:

rpm -i gitlab-runner_<arch>.rpm
  1. 러너 등록하기

업그레이드

시스템에 맞는 최신 패키지를 다운로드한 후 다음과 같이 업그레이드하세요:

예를 들어, Debian 또는 Ubuntu의 경우:

dpkg -i gitlab-runner_<arch>.deb

예를 들어, CentOS 또는 Red Hat Enterprise Linux의 경우:

rpm -Uvh gitlab-runner_<arch>.rpm

바이너리 파일 사용

필요한 경우 바이너리 파일을 통해 다운로드 및 설치가 가능합니다.

설치

caution

GitLab Runner 10에서 실행 파일 이름이 gitlab-runner로 변경되었습니다.

  1. 시스템에 맞는 바이너리 중 하나를 간단히 다운로드합니다:

    # Linux x86-64
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-amd64"

# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-386"

# Linux arm
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-arm"

# Linux arm64
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-arm64"

# Linux s390x
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-s390x"

# Linux ppc64le
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-ppc64le"

# Linux x86-64 FIPS 준수
sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-amd64-fips"

    Bleeding Edge - 다른 태그 릴리스를 다운로드하는 방법에서 설명한 대로 모든 사용 가능한 버전의 바이너리를 다운로드할 수 있습니다.

  2. 실행 권한을 부여합니다:

    sudo chmod +x /usr/local/bin/gitlab-runner

  3. GitLab CI 사용자를 생성합니다:

    sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

  4. 서비스로 설치하고 실행합니다:

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

    /usr/local/bin/가 root의 $PATH에 있는지 확인하세요. 그렇지 않으면 command not found 오류가 발생할 수 있습니다.

    대안으로, /usr/bin/와 같은 다른 위치에 gitlab-runner를 설치할 수 있습니다.

  5. 러너 등록

note
gitlab-runner가 설치되고 서비스로 실행되면 (이 페이지에 설명된 대로) root로 실행되지만, install 명령으로 지정된 사용자가 작업을 실행하게 됩니다.

즉, 캐시 및 아티팩트와 같은 작업 기능 중 일부는 /usr/local/bin/gitlab-runner 명령을 실행해야 하므로, 작업이 실행되는 사용자는 실행 파일에 접근할 수 있어야 합니다.

업그레이드

  1. 서비스를 중지합니다 (이전과 같이 관리자 권한이 필요함):

    sudo gitlab-runner stop

  2. GitLab Runner 실행 파일을 교체할 바이너리를 다운로드합니다. 예를 들어:

    sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-amd64"

    Bleeding Edge - 다른 태그 릴리스를 다운로드하는 방법에서 설명한 대로 모든 사용 가능한 버전의 바이너리를 다운로드할 수 있습니다.

  3. 실행 권한을 부여합니다:

    sudo chmod +x /usr/local/bin/gitlab-runner

  4. 서비스를 시작합니다:

    sudo gitlab-runner start