• deb/rpm 패키지 사용
  • 다운로드
  • 설치
  • 업그레이드
• 이진 파일 사용
  • 설치
  • 업그레이드

GNU/Linux에 수동으로 GitLab 러너 설치하기

deb/rpm 리포지토리를 사용할 수 없거나 GNU/Linux OS가 지원되지 않는 경우, 아래 방법 중 하나를 사용하여 마지막 수단으로 수동으로 GitLab 러너를 설치할 수 있습니다.

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

GitLab 러너의 가장 일반적인 문제들을 설명하는 FAQ 섹션을 꼭 읽어보세요.

deb/rpm 패키지 사용

시스템에 적합한 패키지를 다운로드하고 설치하는 것이 가능합니다.

다운로드

1. 시스템에 맞는 최신 파일 이름 및 옵션을 다음에서 찾을 수 있습니다. https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html.
2. 지금까지 bleeding edge GitLab 러너 릴리스를 다른 태그된 릴리스 다운로드하는 설명대로 이진 파일을 선택하고 다운로드하세요.

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

설치

1. 시스템에 적합한 패키지를 다음과 같이 설치합니다.

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

   dpkg -i gitlab-runner_<arch>.deb
   

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

   rpm -i gitlab-runner_<arch>.rpm
   

2. 러너 등록

업그레이드

시스템의 최신 패키지를 다운로드하고 다음과 같이 업그레이드합니다.

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

dpkg -i gitlab-runner_<arch>.deb

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

rpm -Uvh gitlab-runner_<arch>.rpm

이진 파일 사용

필요한 경우 이진 파일을 다운로드하고 설치하는 것이 가능합니다.

설치

경고: 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 Compliant
   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를 설치할 수 있습니다.

5. 러너 등록

참고: 만약 gitlab-runner가 이 페이지에서 설명한 대로 설치되고 서비스로 실행된다면, root로 실행되지만 install 명령어로 지정된 사용자로 작업을 실행합니다. 따라서 작업이 실행되는 사용자는 /usr/local/bin/gitlab-runner 명령어를 실행해야 하는 cache 및 artifacts와 같은 일부 작업 기능을 실행해야 하므로 실행 파일에 액세스할 수 있어야 합니다.

업그레이드

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 - download any other tagged release에서 설명된대로 모든 사용 가능한 버전의 이진 파일을 다운로드할 수 있습니다.

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

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

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

   sudo gitlab-runner start