GNU/Linux에 매뉴얼으로 GitLab Runner 설치

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

만약 deb/rpm repository를 사용하여 GitLab Runner를 설치할 수 없거나, GNU/Linux OS가 지원되지 않는 경우, 아래 방법 중 하나를 사용하여 매뉴얼으로 설치할 수 있습니다.

도커 실행자를 사용하려면 GitLab Runner를 사용하기 전에 도커를 설치해야 합니다.

GitLab Runner에서 가장 흔한 문제들에 대해 설명하는 FAQ 섹션을 꼭 읽어보세요.

deb/rpm 패키지 사용

필요한 경우에 deb 또는 rpm 패키지를 다운로드하고 설치할 수 있습니다.

다운로드

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

  1. 최신 파일 이름과 옵션은 다음에서 찾을 수 있습니다: https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html.
  2. 적절한 버전을 선택하고, 다른 태그된 릴리스 다운로드 설명서에 나와 있는대로 바이너리를 다운로드하세요.

예를 들어, Debian이나 Ubuntu의 경우:

# ${arch}를 지원되는 아키텍처 중 하나로 바꿔 사용하세요. 예: 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}를 지원되는 아키텍처 중 하나로 바꿔 사용하세요. 예: 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

러너 등록

업그레이드

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

예를 들어, 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
    

    root$PATH/usr/local/bin/이 포함되어 있거나, command not found 오류가 발생할 수 있습니다. 다른 위치(예: /usr/bin/)에 gitlab-runner를 설치할 수도 있습니다.

러너 등록

note
만약 gitlab-runner가 설치되어 서비스로 실행 중이라면(이 페이지에 설명된대로), 루트로 실행되지만 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