GNU/Linux에서 GitLab Runner 수동으로 설치
만약 deb/rpm repository를 사용하여 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.
- 다른 태그된 릴리스의 다운로드 방법에 설명된 대로 이진 파일을 선택하고 다운로드하세요: 기타 태그된 릴리스 다운로드.
예를 들어 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
이진 파일 사용
필요한 경우 이진 파일로 다운로드하고 설치할 수 있습니다.
설치
경고:
GitLab Runner 10에서 실행 파일이 gitlab-runner
로 이름이 변경되었습니다.
-
시스템에 맞는 이진 파일을 다운로드하세요:
# 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 - 기타 태그된 릴리스 다운로드에 설명된 대로 가능한 모든 버전에 대한 이진 파일을 다운로드할 수 있습니다.
-
실행 권한을 부여하세요:
sudo chmod +x /usr/local/bin/gitlab-runner
-
GitLab CI 사용자를 생성하세요:
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
-
서비스로 설치하고 실행하세요:
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
를 설치할 수도 있습니다.
참고:
만약 gitlab-runner
가 설치되고 서비스로 실행될 경우(이 페이지에서 설명된 내용), root로 실행되지만 install
명령으로 지정한 사용자로 작업을 실행합니다. 이는 일부 작업 기능인 캐시와 artefacts과 같은 작업이 /usr/local/bin/gitlab-runner
명령을 실행해야 하기 때문에 작업이 실행되는 사용자는 실행 파일에 액세스해야 합니다.
업데이트
-
서비스를 중지합니다(이전과 같이 상위 명령 프롬프트가 필요합니다):
sudo gitlab-runner stop
-
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 - 다른 태그로 릴리스된 것을 다운로드에 설명된대로 모든 가능한 버전에 대한 바이너리를 다운로드할 수 있습니다.
-
실행 권한을 부여합니다:
sudo chmod +x /usr/local/bin/gitlab-runner
-
서비스를 시작합니다:
sudo gitlab-runner start