GitLab Runner 설치

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

GitLab Runner은 GitLab에서 정의된 CI/CD 작업을 실행합니다.

GitLab Runner는 오픈 소스이며 Go로 작성되었습니다. 단일 이진 파일로 실행되며 특정 언어 요구 사항이 없습니다.

GitLab Runner를 설치한 후에는 GitLab 인스턴스에 러너(runner)를 생성하고 등록해야 합니다. 이 인스턴스는 Self-managed되거나 GitLab.com을 사용할 수 있습니다. 또한 프로젝트 러너를 생성, 등록 및 실행할 수 있습니다.

GitLab Runner는 GNU/Linux, macOS, FreeBSD 및 Windows에 설치하여 사용할 수 있습니다.

  • 컨테이너 내에
  • 이진 파일을 매뉴얼으로 다운로드하여
  • rpm/deb 패키지를 사용하여

GitLab Runner는 공식 지원하는 바이너리를 다음 아키텍처용으로 제공합니다:

  • x86, AMD64, ARM64, ARM, s390x, ppc64le

공식 패키지는 다음 Linux 배포판을 위해 제공됩니다:

  • CentOS, Debian, Ubuntu, RHEL, Fedora, Mint, Oracle, Amazon

GitLab Runner는 공식으로 지원하는 다음 운영 체제를 지원합니다. 공식으로 지원되지 않는 다른 운영 체제를 사용하려면 Go 이진 파일을 컴파일할 수 있어야 합니다.

  • Linux, Windows, macOS, FreeBSD
note
보안 및 성능 이유로 GitLab Runner를 GitLab 인스턴스를 호스팅하는 기기와 별도로 설치하는 것이 좋습니다.

시스템 요구 사항

GitLab Runner의 시스템 요구 사항은 각각의 사용 사례에 고유한 변수에 따라 크게 달라집니다. 이러한 변수에 따라 GitLab Runner 인스턴스를 필요에 따라 더 높거나 낮게 확장하고 크기를 조정할 수 있습니다. 이러한 변수에는 다음이 포함됩니다:

  • 예상:
    • CI 작업의 CPU 부하
    • CI 작업의 메모리 사용
  • 다음 수:
    • 동시 CI 작업 수
    • 활발한 개발 프로젝트 수
    • 병행하여 작업할 개발자 수

자세한 내용은 SaaS에서 사용 가능한 Linux(x86-64)용 머신 유형을 참조하십시오.

FIPS 호환 GitLab Runner

GitLab Runner 14.7 이상 버전에서는 FIPS 140-12 호환 GitLab Runner 이진 파일이 제공됩니다. 이 이진 파일은 Red Hat Go 컴파일러로 빌드되었으며 표준 라이브러리 암호화 루틴을 우회하고 FIPS 140-2 인증 암호화 라이브러리로 호출합니다.

GitLab Runner 15.1 이상 버전에서는 UBI-8 minimal을 GitLab Runner FIPS 이미지를 만들기 위한 기본으로 사용합니다.

note
Red Hat Enterprise Linux (RHEL) 배포판만 지원됩니다.

FIPS 호환 GitLab Runner 이진 파일은 다음 아키텍처를 위해 제공됩니다:

  • AMD64

동일한 아키텍처용 Docker 이미지 및 RPM 패키지도 제공됩니다.

RHEL에서 FIPS 호환 GitLab Runner

RHEL에서 FIPS 버전의 GitLab Runner를 사용할 때 FIPS 모드를 활성화해야 합니다.

다른 시스템 및 아키텍처의 FIPS 호환 GitLab Runner

기타 아키텍처 및 배포판의 추가에 대한 진행 상황을 확인하려면 issue를 참조하십시오.

리포지터리

  • Debian/Ubuntu/CentOS/Red Hat용 GitLab 리포지터리를 사용하여 설치하기(linux-repository.md)

이진 파일

  • GNU/Linux에 설치하기(linux-manually.md)
  • macOS에 설치하기(osx.md)
  • Windows에 설치하기(windows.md)
  • FreeBSD에 설치하기(freebsd.md)
  • 최신 빌드 설치하기(bleeding-edge.md)

컨테이너

  • Docker 서비스로 설치하기(docker.md)
  • Kubernetes에 설치하기(kubernetes.md)
  • Kubernetes 에이전트를 사용하여 설치하기(kubernetes-agent.md)
  • GitLab Runner Operator로 설치하기(operator.md)

자동 스케일

  • Docker machine을 사용하여 자동 스케일 모드로 설치하기(../executors/docker_machine.md)
  • 레지스트리 및 캐시 서버 설치하기(../configuration/speed_up_job_execution.md)