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

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

만약 deb/rpm 리포지터리를 사용하여 GitLab Runner를 설치할 수 없거나 GNU/Linux OS가 지원되는 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. 또는 다른 태그된 릴리스 다운로드 설명서에서 bleeding edge GitLab Runner 릴리스를 다운로드하세요.

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

러너(runner) 등록하기

업데이트

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

예를 들어, 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 오류가 발생할 수 있습니다. 대안으로 gitlab-runner를 /usr/bin/과 같은 다른 위치에 설치할 수 있습니다.

  5. 러너(runner) 등록

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"

    블리딩 에지 - 다른 태그가 지정된 릴리스 다운로드에 설명된대로 모든 가능한 버전의 바이너리를 다운로드할 수 있습니다.

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

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

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

    sudo gitlab-runner start