InfoGrab Docs

공식 GitLab 리포지터리를 사용하여 GitLab Runner 설치

요약

GitLab Runner를 설치하려면 GitLab 리포지터리의 패키지를 사용할 수 있습니다. GitLab은 지원되는 다음 Linux 배포판 버전에 대한 패키지를 제공합니다. 설정에 따라 다른 Debian 또는 RPM 기반 배포판도 지원될 수 있습니다.

GitLab Runner를 설치하려면 GitLab 리포지터리의 패키지를 사용할 수 있습니다.

지원되는 배포판#

GitLab은 지원되는 다음 Linux 배포판 버전에 대한 패키지를 제공합니다. 새로운 OS 배포판 릴리스에 대한 새로운 러너 deb 또는 rpm 패키지는 패키지 호스팅 시스템에서 지원될 때 자동으로 추가됩니다.

Deb 기반 배포판#

배포판 지원 버전
Debian Duke, Forky, Trixie, Bookworm, Bullseye
LinuxMint Xia, Wilma, Virginia, Victoria, Vera, Vanessa
Raspbian Duke, Forky, Trixie, Bookworm, Bullseye
Ubuntu Questing, Noble, Jammy, Focal, Bionic

RPM 기반 배포판#

배포판 지원 버전
Amazon Linux 2025, 2023, 2
Red Hat Enterprise Linux 10, 9, 8, 7
Fedora 43, 42
Oracle Linux 10, 9, 8, 7
openSUSE 16.0, 15.6
SUSE Linux Enterprise Server 15.7, 15.6, 15.5, 15.4, 12.5

설정에 따라 다른 Debian 또는 RPM 기반 배포판도 지원될 수 있습니다. 이는 지원되는 GitLab Runner 배포판의 파생 배포판으로 호환되는 패키지 리포지터리를 가진 경우를 말합니다. 예를 들어 Deepin은 Debian 파생 배포판입니다. 따라서 러너 deb 패키지를 Deepin에 설치하고 실행할 수 있습니다. 다른 Linux 배포판에서는 바이너리로 GitLab Runner를 설치할 수도 있습니다.

Note

목록에 없는 배포판의 패키지는 패키지 리포지터리에서 제공되지 않습니다. S3 버킷에서 RPM 또는 DEB 패키지를 다운로드하여 수동으로 설치할 수 있습니다.

GitLab Runner 설치#

GitLab Runner를 설치하려면:

  1. 공식 GitLab 리포지터리를 추가하세요:

  2. 리포지터리 설정 스크립트를 다운로드하세요:

    curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" -o script.deb.sh
    
    1. 스크립트를 실행하기 전에 내용을 확인하세요:

      less script.deb.sh
      
    2. 스크립트를 실행하세요:

      sudo bash script.deb.sh
      
  1. 리포지터리 설정 스크립트를 다운로드하세요:

    curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" -o script.rpm.sh
    
    1. 스크립트를 실행하기 전에 내용을 확인하세요:

      less script.rpm.sh
      
    2. 스크립트를 실행하세요:

      sudo bash script.rpm.sh
      
  1. 최신 버전의 GitLab Runner를 설치하거나, 특정 버전을 설치하려면 다음 단계로 건너뛰세요:

    [!note] skel 디렉토리 사용은 기본적으로 비활성화되어 있어 No such file or directory 잡 실패를 방지합니다.

   sudo apt install gitlab-runner
   sudo yum install gitlab-runner

   or

   sudo dnf install gitlab-runner

[!note] RHEL 배포판에서는 FIPS 140-2 준수 버전의 GitLab Runner를 사용할 수 있습니다. gitlab-runner 대신 gitlab-runner-fips를 패키지 이름으로 사용하여 이 버전을 설치할 수 있습니다.

  1. 특정 버전의 GitLab Runner를 설치하려면:

Note
> `gitlab-runner` 버전 `v17.7.1`부터, 최신 버전이 아닌 특정 버전의 `gitlab-runner`를 설치할 때는 > 해당 버전에 맞는 `gitlab-runner-helper-packages`를 명시적으로 설치해야 합니다. 이 요구 사항은 > `apt`/`apt-get` 제한으로 인해 발생합니다.
apt-cache madison gitlab-runner
sudo apt install gitlab-runner=17.7.1-1 gitlab-runner-helper-images=17.7.1-1

동일한 버전의 gitlab-runner-helper-images를 설치하지 않고 특정 버전의 gitlab-runner를 설치하려 하면 다음과 같은 오류가 발생할 수 있습니다:

sudo apt install gitlab-runner=17.7.1-1
...
The following packages have unmet dependencies:
 gitlab-runner : Depends: gitlab-runner-helper-images (= 17.7.1-1) but 17.8.3-1 is to be installed
E: Unable to correct problems, you have held broken packages.
   yum list gitlab-runner --showduplicates | sort -r
   sudo yum install gitlab-runner-17.2.0-1
  1. 러너를 등록하세요.

위 단계를 완료한 후 러너를 시작하고 프로젝트에서 사용할 수 있습니다!

GitLab Runner에서 가장 일반적인 문제들을 설명하는 FAQ 섹션을 반드시 읽어보세요.

헬퍼 이미지 패키지#

gitlab-runner-helper-images 패키지에는 GitLab Runner가 잡 실행 중에 사용하는 미리 빌드된 헬퍼 컨테이너 이미지가 포함되어 있습니다. 이 이미지는 리포지터리 클론, 아티팩트 업로드 및 캐시 관리에 필요한 도구와 유틸리티를 제공합니다.

gitlab-runner-helper-images 패키지에는 다음 운영 체제 및 아키텍처에 대한 헬퍼 이미지가 포함되어 있습니다:

Alpine 기반 이미지 (최신):

Ubuntu 기반 이미지 (24.04):

자동 헬퍼 이미지 다운로드#

특정 운영 체제 및 아키텍처 조합에 대한 헬퍼 이미지가 호스트 시스템에 없는 경우, GitLab Runner는 필요할 때 자동으로 필요한 이미지를 다운로드합니다. gitlab-runner-helper-images 패키지에 포함되지 않은 아키텍처에 대해서는 수동 설치가 필요하지 않습니다. 이 자동 다운로드 기능으로 러너가 수동 개입이나 별도의 패키지 설치 없이 추가 아키텍처(loong64 등)를 지원할 수 있습니다.

GitLab Runner 업그레이드#

최신 버전의 GitLab Runner를 설치하려면:

sudo apt update
sudo apt install gitlab-runner
sudo yum update
sudo yum install gitlab-runner

패키지 설치를 위한 GPG 서명#

GitLab Runner 프로젝트는 패키지 설치 방법을 위해 두 가지 유형의 GPG 서명을 제공합니다:

리포지터리 메타데이터 서명#

원격 리포지터리에서 다운로드된 패키지 정보를 신뢰할 수 있는지 확인하기 위해 패키지 관리자가 리포지터리 메타데이터 서명을 사용합니다.

apt-get update와 같은 명령을 사용할 때 서명이 확인되므로, 사용 가능한 패키지에 대한 정보가 패키지가 다운로드 및 설치되기 전에 업데이트됩니다. 서명 확인 실패 시 패키지 관리자가 메타데이터를 거부해야 합니다. 이는 서명 불일치를 유발하는 문제가 발견되고 해결될 때까지 리포지터리에서 어떠한 패키지도 다운로드하고 설치할 수 없음을 의미합니다.

패키지 메타데이터 서명 확인에 사용되는 GPG 공개 키는 위의 지침으로 처음 설치할 때 자동으로 설치됩니다. 앞으로의 키 업데이트를 위해 기존 사용자는 새 키를 수동으로 다운로드하고 설치해야 합니다.

https://packages.gitlab.com에 호스팅된 모든 프로젝트에 하나의 키를 사용합니다. 사용된 키에 대한 세부 정보는 Linux 패키지 문서에서 찾을 수 있습니다. 이 문서 페이지에는 과거에 사용된 모든 키도 나열되어 있습니다.

패키지 서명#

리포지터리 메타데이터 서명은 다운로드된 버전 정보가 https://packages.gitlab.com에서 발생했음을 증명합니다. 패키지 자체의 무결성을 증명하지는 않습니다. https://packages.gitlab.com에 업로드된 모든 것(승인 여부와 관계없이)은 리포지터리에서 사용자로의 메타데이터 전송이 영향을 받지 않는 한 올바르게 확인됩니다.

패키지 서명을 사용하면 각 패키지가 빌드될 때 서명됩니다. 빌드 환경과 사용된 GPG 키의 기밀성을 신뢰할 수 있을 때까지 패키지 인증을 확인할 수 없습니다. 패키지의 유효한 서명은 출처가 인증되었고 무결성이 침해되지 않았음을 증명합니다.

패키지 서명 확인은 일부 Debian/RPM 기반 배포판에서만 기본으로 활성화되어 있습니다. 이 유형의 확인을 사용하려면 설정을 조정해야 할 수도 있습니다.

패키지 서명 확인에 사용되는 GPG 키는 https://packages.gitlab.com에 호스팅된 각 리포지터리마다 다를 수 있습니다. GitLab Runner 프로젝트는 이 유형의 서명을 위해 자체 키 쌍을 사용합니다.

RPM 기반 배포판#

RPM 형식에는 GPG 서명 기능의 완전한 구현이 포함되어 있으며, 따라서 해당 형식을 기반으로 하는 패키지 관리 시스템과 완전히 통합됩니다.

RPM 기반 배포판에 대한 패키지 서명 확인을 설정하는 방법에 대한 기술적인 설명은 Linux 패키지 문서에서 확인할 수 있습니다. GitLab Runner의 차이점은 다음과 같습니다:

Debian 기반 배포판#

deb 형식은 패키지 서명을 위한 기본 및 포함된 방법을 공식적으로 포함하지 않습니다. GitLab Runner 프로젝트는 패키지의 서명 및 서명 확인을 위해 dpkg-sig 도구를 사용합니다. 이 방법은 패키지의 수동 확인만 지원합니다.

deb 패키지를 확인하려면:

  1. dpkg-sig를 설치하세요:

    apt update && apt install dpkg-sig
    
  2. 패키지 서명 공개 키를 다운로드하고 가져오세요:

    curl -JLO "https://packages.gitlab.com/gpgkey/runner/49F16C5CC3A0F81F.pub.gpg"
    gpg --import 49F16C5CC3A0F81F.pub.gpg
    
  3. dpkg-sig로 다운로드된 패키지를 확인하세요:

    dpkg-sig --verify gitlab-runner_amd64.deb
    Processing gitlab-runner_amd64.deb...
    GOODSIG _gpgbuilder 931DA69CFA3AFEBBC97DAA8C6C57C29C6BA75A4E 1623755049
    

    패키지의 서명이 유효하지 않거나 유효하지 않은 키(예: 폐기된 키)로 서명된 경우, 출력은 다음과 유사합니다:

    dpkg-sig --verify gitlab-runner_amd64.deb
    Processing gitlab-runner_amd64.deb...
    BADSIG _gpgbuilder
    

    키가 사용자의 키링에 없는 경우, 출력은 다음과 유사합니다:

    dpkg-sig --verify gitlab-runner_amd64.v13.1.0.deb
    Processing gitlab-runner_amd64.v13.1.0.deb...
    UNKNOWNSIG _gpgbuilder 880721D4
    

현재 GPG 공개 키#

패키지 서명에 사용되는 현재 공개 GPG 키를 https://packages.gitlab.com/gpgkey/runner/49F16C5CC3A0F81F.pub.gpg에서 다운로드하세요.

키 속성
Name GitLab, Inc.
EMail support@gitlab.com
Fingerprint 931D A69C FA3A FEBB C97D AA8C 6C57 C29C 6BA7 5A4E
Expiry 2026-04-28
Note

동일한 키가 GitLab Runner 프로젝트에서 <https://gitlab-runner-downloads.s3.dualstack.us-east-1.amazonaws.com> 버킷의 S3 릴리스에 대한 release.sha256 파일 서명에도 사용됩니다.

이전 GPG 공개 키#

과거에 사용된 키는 아래 표에서 확인할 수 있습니다.

폐기된 키의 경우, 패키지 서명 확인 설정에서 해당 키를 제거하는 것을 강력히 권장합니다.

다음 키로 만들어진 서명은 더 이상 신뢰해서는 안 됩니다.

Sl. No. 키 지문 상태 만료 날짜 다운로드 (폐기된 키만)
1 3018 3AC2 C4E2 3A40 9EFB E705 9CE4 5ABC 8807 21D4 revoked 2021-06-08 revoked key
2 09E5 7083 F34C CA94 D541 BC58 A674 BF81 35DF A027 revoked 2023-04-26 revoked key

문제 해결#

다음은 GitLab Runner를 설치할 때 발생하는 문제를 해결하기 위한 몇 가지 팁입니다.

오류: No such file or directory 잡 실패#

기본 스켈레톤(skel) 디렉토리가 GitLab Runner에 문제를 일으켜 잡 실행에 실패하는 경우가 있습니다. 이슈 4449이슈 1379를 참조하세요.

이를 방지하기 위해 GitLab Runner를 설치할 때 gitlab-runner 사용자가 생성되며, 기본적으로 홈 디렉토리는 스켈레톤 없이 생성됩니다. skel을 사용하여 홈 디렉토리에 추가된 셸 설정은 잡 실행을 방해할 수 있습니다. 이 설정은 위에서 언급한 것과 같은 예상치 못한 문제를 일으킬 수 있습니다.

skel 회피가 기본 동작으로 적용되기 이전에 러너를 생성했다면 다음 dotfile을 제거해 보세요:

sudo rm /home/gitlab-runner/.profile
sudo rm /home/gitlab-runner/.bashrc
sudo rm /home/gitlab-runner/.bash_logout

새로 생성된 $HOME 디렉토리에 skel 디렉토리를 사용해야 하는 경우, 러너를 설치하기 전에 GITLAB_RUNNER_DISABLE_SKEL 변수를 명시적으로 false로 설정해야 합니다:

export GITLAB_RUNNER_DISABLE_SKEL=false; sudo -E apt-get install gitlab-runner
export GITLAB_RUNNER_DISABLE_SKEL=false; sudo -E yum install gitlab-runner

공식 GitLab 리포지터리를 사용하여 GitLab Runner 설치

Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

GitLab Runner를 설치하려면 GitLab 리포지터리의 패키지를 사용할 수 있습니다. GitLab은 지원되는 다음 Linux 배포판 버전에 대한 패키지를 제공합니다. 설정에 따라 다른 Debian 또는 RPM 기반 배포판도 지원될 수 있습니다.

GitLab Runner를 설치하려면 GitLab 리포지터리의 패키지를 사용할 수 있습니다.

지원되는 배포판#

GitLab은 지원되는 다음 Linux 배포판 버전에 대한 패키지를 제공합니다. 새로운 OS 배포판 릴리스에 대한 새로운 러너 deb 또는 rpm 패키지는 패키지 호스팅 시스템에서 지원될 때 자동으로 추가됩니다.

Deb 기반 배포판#

배포판 지원 버전
Debian Duke, Forky, Trixie, Bookworm, Bullseye
LinuxMint Xia, Wilma, Virginia, Victoria, Vera, Vanessa
Raspbian Duke, Forky, Trixie, Bookworm, Bullseye
Ubuntu Questing, Noble, Jammy, Focal, Bionic

RPM 기반 배포판#

배포판 지원 버전
Amazon Linux 2025, 2023, 2
Red Hat Enterprise Linux 10, 9, 8, 7
Fedora 43, 42
Oracle Linux 10, 9, 8, 7
openSUSE 16.0, 15.6
SUSE Linux Enterprise Server 15.7, 15.6, 15.5, 15.4, 12.5

설정에 따라 다른 Debian 또는 RPM 기반 배포판도 지원될 수 있습니다. 이는 지원되는 GitLab Runner 배포판의 파생 배포판으로 호환되는 패키지 리포지터리를 가진 경우를 말합니다. 예를 들어 Deepin은 Debian 파생 배포판입니다. 따라서 러너 deb 패키지를 Deepin에 설치하고 실행할 수 있습니다. 다른 Linux 배포판에서는 바이너리로 GitLab Runner를 설치할 수도 있습니다.

Note

목록에 없는 배포판의 패키지는 패키지 리포지터리에서 제공되지 않습니다. S3 버킷에서 RPM 또는 DEB 패키지를 다운로드하여 수동으로 설치할 수 있습니다.

GitLab Runner 설치#

GitLab Runner를 설치하려면:

  1. 공식 GitLab 리포지터리를 추가하세요:

  2. 리포지터리 설정 스크립트를 다운로드하세요:

    curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" -o script.deb.sh
    
    1. 스크립트를 실행하기 전에 내용을 확인하세요:

      less script.deb.sh
      
    2. 스크립트를 실행하세요:

      sudo bash script.deb.sh
      
  1. 리포지터리 설정 스크립트를 다운로드하세요:

    curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" -o script.rpm.sh
    
    1. 스크립트를 실행하기 전에 내용을 확인하세요:

      less script.rpm.sh
      
    2. 스크립트를 실행하세요:

      sudo bash script.rpm.sh
      
  1. 최신 버전의 GitLab Runner를 설치하거나, 특정 버전을 설치하려면 다음 단계로 건너뛰세요:

    [!note] skel 디렉토리 사용은 기본적으로 비활성화되어 있어 No such file or directory 잡 실패를 방지합니다.

   sudo apt install gitlab-runner
   sudo yum install gitlab-runner

   or

   sudo dnf install gitlab-runner

[!note] RHEL 배포판에서는 FIPS 140-2 준수 버전의 GitLab Runner를 사용할 수 있습니다. gitlab-runner 대신 gitlab-runner-fips를 패키지 이름으로 사용하여 이 버전을 설치할 수 있습니다.

  1. 특정 버전의 GitLab Runner를 설치하려면:

Note
> `gitlab-runner` 버전 `v17.7.1`부터, 최신 버전이 아닌 특정 버전의 `gitlab-runner`를 설치할 때는 > 해당 버전에 맞는 `gitlab-runner-helper-packages`를 명시적으로 설치해야 합니다. 이 요구 사항은 > `apt`/`apt-get` 제한으로 인해 발생합니다.
apt-cache madison gitlab-runner
sudo apt install gitlab-runner=17.7.1-1 gitlab-runner-helper-images=17.7.1-1

동일한 버전의 gitlab-runner-helper-images를 설치하지 않고 특정 버전의 gitlab-runner를 설치하려 하면 다음과 같은 오류가 발생할 수 있습니다:

sudo apt install gitlab-runner=17.7.1-1
...
The following packages have unmet dependencies:
 gitlab-runner : Depends: gitlab-runner-helper-images (= 17.7.1-1) but 17.8.3-1 is to be installed
E: Unable to correct problems, you have held broken packages.
   yum list gitlab-runner --showduplicates | sort -r
   sudo yum install gitlab-runner-17.2.0-1
  1. 러너를 등록하세요.

위 단계를 완료한 후 러너를 시작하고 프로젝트에서 사용할 수 있습니다!

GitLab Runner에서 가장 일반적인 문제들을 설명하는 FAQ 섹션을 반드시 읽어보세요.

헬퍼 이미지 패키지#

gitlab-runner-helper-images 패키지에는 GitLab Runner가 잡 실행 중에 사용하는 미리 빌드된 헬퍼 컨테이너 이미지가 포함되어 있습니다. 이 이미지는 리포지터리 클론, 아티팩트 업로드 및 캐시 관리에 필요한 도구와 유틸리티를 제공합니다.

gitlab-runner-helper-images 패키지에는 다음 운영 체제 및 아키텍처에 대한 헬퍼 이미지가 포함되어 있습니다:

Alpine 기반 이미지 (최신):

Ubuntu 기반 이미지 (24.04):

자동 헬퍼 이미지 다운로드#

특정 운영 체제 및 아키텍처 조합에 대한 헬퍼 이미지가 호스트 시스템에 없는 경우, GitLab Runner는 필요할 때 자동으로 필요한 이미지를 다운로드합니다. gitlab-runner-helper-images 패키지에 포함되지 않은 아키텍처에 대해서는 수동 설치가 필요하지 않습니다. 이 자동 다운로드 기능으로 러너가 수동 개입이나 별도의 패키지 설치 없이 추가 아키텍처(loong64 등)를 지원할 수 있습니다.

GitLab Runner 업그레이드#

최신 버전의 GitLab Runner를 설치하려면:

sudo apt update
sudo apt install gitlab-runner
sudo yum update
sudo yum install gitlab-runner

패키지 설치를 위한 GPG 서명#

GitLab Runner 프로젝트는 패키지 설치 방법을 위해 두 가지 유형의 GPG 서명을 제공합니다:

리포지터리 메타데이터 서명#

원격 리포지터리에서 다운로드된 패키지 정보를 신뢰할 수 있는지 확인하기 위해 패키지 관리자가 리포지터리 메타데이터 서명을 사용합니다.

apt-get update와 같은 명령을 사용할 때 서명이 확인되므로, 사용 가능한 패키지에 대한 정보가 패키지가 다운로드 및 설치되기 전에 업데이트됩니다. 서명 확인 실패 시 패키지 관리자가 메타데이터를 거부해야 합니다. 이는 서명 불일치를 유발하는 문제가 발견되고 해결될 때까지 리포지터리에서 어떠한 패키지도 다운로드하고 설치할 수 없음을 의미합니다.

패키지 메타데이터 서명 확인에 사용되는 GPG 공개 키는 위의 지침으로 처음 설치할 때 자동으로 설치됩니다. 앞으로의 키 업데이트를 위해 기존 사용자는 새 키를 수동으로 다운로드하고 설치해야 합니다.

https://packages.gitlab.com에 호스팅된 모든 프로젝트에 하나의 키를 사용합니다. 사용된 키에 대한 세부 정보는 Linux 패키지 문서에서 찾을 수 있습니다. 이 문서 페이지에는 과거에 사용된 모든 키도 나열되어 있습니다.

패키지 서명#

리포지터리 메타데이터 서명은 다운로드된 버전 정보가 https://packages.gitlab.com에서 발생했음을 증명합니다. 패키지 자체의 무결성을 증명하지는 않습니다. https://packages.gitlab.com에 업로드된 모든 것(승인 여부와 관계없이)은 리포지터리에서 사용자로의 메타데이터 전송이 영향을 받지 않는 한 올바르게 확인됩니다.

패키지 서명을 사용하면 각 패키지가 빌드될 때 서명됩니다. 빌드 환경과 사용된 GPG 키의 기밀성을 신뢰할 수 있을 때까지 패키지 인증을 확인할 수 없습니다. 패키지의 유효한 서명은 출처가 인증되었고 무결성이 침해되지 않았음을 증명합니다.

패키지 서명 확인은 일부 Debian/RPM 기반 배포판에서만 기본으로 활성화되어 있습니다. 이 유형의 확인을 사용하려면 설정을 조정해야 할 수도 있습니다.

패키지 서명 확인에 사용되는 GPG 키는 https://packages.gitlab.com에 호스팅된 각 리포지터리마다 다를 수 있습니다. GitLab Runner 프로젝트는 이 유형의 서명을 위해 자체 키 쌍을 사용합니다.

RPM 기반 배포판#

RPM 형식에는 GPG 서명 기능의 완전한 구현이 포함되어 있으며, 따라서 해당 형식을 기반으로 하는 패키지 관리 시스템과 완전히 통합됩니다.

RPM 기반 배포판에 대한 패키지 서명 확인을 설정하는 방법에 대한 기술적인 설명은 Linux 패키지 문서에서 확인할 수 있습니다. GitLab Runner의 차이점은 다음과 같습니다:

Debian 기반 배포판#

deb 형식은 패키지 서명을 위한 기본 및 포함된 방법을 공식적으로 포함하지 않습니다. GitLab Runner 프로젝트는 패키지의 서명 및 서명 확인을 위해 dpkg-sig 도구를 사용합니다. 이 방법은 패키지의 수동 확인만 지원합니다.

deb 패키지를 확인하려면:

  1. dpkg-sig를 설치하세요:

    apt update && apt install dpkg-sig
    
  2. 패키지 서명 공개 키를 다운로드하고 가져오세요:

    curl -JLO "https://packages.gitlab.com/gpgkey/runner/49F16C5CC3A0F81F.pub.gpg"
    gpg --import 49F16C5CC3A0F81F.pub.gpg
    
  3. dpkg-sig로 다운로드된 패키지를 확인하세요:

    dpkg-sig --verify gitlab-runner_amd64.deb
    Processing gitlab-runner_amd64.deb...
    GOODSIG _gpgbuilder 931DA69CFA3AFEBBC97DAA8C6C57C29C6BA75A4E 1623755049
    

    패키지의 서명이 유효하지 않거나 유효하지 않은 키(예: 폐기된 키)로 서명된 경우, 출력은 다음과 유사합니다:

    dpkg-sig --verify gitlab-runner_amd64.deb
    Processing gitlab-runner_amd64.deb...
    BADSIG _gpgbuilder
    

    키가 사용자의 키링에 없는 경우, 출력은 다음과 유사합니다:

    dpkg-sig --verify gitlab-runner_amd64.v13.1.0.deb
    Processing gitlab-runner_amd64.v13.1.0.deb...
    UNKNOWNSIG _gpgbuilder 880721D4
    

현재 GPG 공개 키#

패키지 서명에 사용되는 현재 공개 GPG 키를 https://packages.gitlab.com/gpgkey/runner/49F16C5CC3A0F81F.pub.gpg에서 다운로드하세요.

키 속성
Name GitLab, Inc.
EMail support@gitlab.com
Fingerprint 931D A69C FA3A FEBB C97D AA8C 6C57 C29C 6BA7 5A4E
Expiry 2026-04-28
Note

동일한 키가 GitLab Runner 프로젝트에서 <https://gitlab-runner-downloads.s3.dualstack.us-east-1.amazonaws.com> 버킷의 S3 릴리스에 대한 release.sha256 파일 서명에도 사용됩니다.

이전 GPG 공개 키#

과거에 사용된 키는 아래 표에서 확인할 수 있습니다.

폐기된 키의 경우, 패키지 서명 확인 설정에서 해당 키를 제거하는 것을 강력히 권장합니다.

다음 키로 만들어진 서명은 더 이상 신뢰해서는 안 됩니다.

Sl. No. 키 지문 상태 만료 날짜 다운로드 (폐기된 키만)
1 3018 3AC2 C4E2 3A40 9EFB E705 9CE4 5ABC 8807 21D4 revoked 2021-06-08 revoked key
2 09E5 7083 F34C CA94 D541 BC58 A674 BF81 35DF A027 revoked 2023-04-26 revoked key

문제 해결#

다음은 GitLab Runner를 설치할 때 발생하는 문제를 해결하기 위한 몇 가지 팁입니다.

오류: No such file or directory 잡 실패#

기본 스켈레톤(skel) 디렉토리가 GitLab Runner에 문제를 일으켜 잡 실행에 실패하는 경우가 있습니다. 이슈 4449이슈 1379를 참조하세요.

이를 방지하기 위해 GitLab Runner를 설치할 때 gitlab-runner 사용자가 생성되며, 기본적으로 홈 디렉토리는 스켈레톤 없이 생성됩니다. skel을 사용하여 홈 디렉토리에 추가된 셸 설정은 잡 실행을 방해할 수 있습니다. 이 설정은 위에서 언급한 것과 같은 예상치 못한 문제를 일으킬 수 있습니다.

skel 회피가 기본 동작으로 적용되기 이전에 러너를 생성했다면 다음 dotfile을 제거해 보세요:

sudo rm /home/gitlab-runner/.profile
sudo rm /home/gitlab-runner/.bashrc
sudo rm /home/gitlab-runner/.bash_logout

새로 생성된 $HOME 디렉토리에 skel 디렉토리를 사용해야 하는 경우, 러너를 설치하기 전에 GITLAB_RUNNER_DISABLE_SKEL 변수를 명시적으로 false로 설정해야 합니다:

export GITLAB_RUNNER_DISABLE_SKEL=false; sudo -E apt-get install gitlab-runner
export GITLAB_RUNNER_DISABLE_SKEL=false; sudo -E yum install gitlab-runner