인스턴스 러너
그룹 러너
프로젝트 러너
러너 상태
러너 성능 통계 보기
업그레이드가 필요한 러너 확인하기
러너의 IP 주소 확인하기
- 인스턴스 러너의 IP 주소 확인하기
- 프로젝트 러너의 IP 주소 확인하기
프로젝트 및 그룹에서 러너 등록 토큰 사용 활성화하기

러너 관리

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

GitLab Runner에는 접근 권한에 따라 제공되는 다음과 같은 유형의 러너가 있습니다:

인스턴스 러너는 GitLab 인스턴스의 모든 그룹과 프로젝트에서 사용할 수 있습니다.
그룹 러너는 그룹 내의 모든 프로젝트와 하위 그룹에서 사용할 수 있습니다.
프로젝트 러너는 특정 프로젝트와 연결되어 있습니다.
일반적으로 프로젝트 러너는 한 번에 하나의 프로젝트에서 사용됩니다.

인스턴스 러너

인스턴스 러너는 GitLab 인스턴스의 모든 프로젝트에서 사용할 수 있습니다.

비슷한 요구 사항을 가진 여러 작업이 있을 때 인스턴스 러너를 사용하세요. 여러 프로젝트를 위해 여러 러너가 대기하는 대신, 여러 프로젝트를 처리하는 몇 개의 러너를 가질 수 있습니다.

셀프 관리형 GitLab 인스턴스를 사용 중인 경우, 관리자는 다음을 수행할 수 있습니다:

GitLab Runner 설치하고 인스턴스 러너를 등록합니다.
각 그룹에 대해 인스턴스 러너의 최대 컴퓨트 분을 구성합니다.

GitLab.com을 사용하는 경우:

GitLab이 유지 관리하는 인스턴스 러너 목록에서 선택할 수 있습니다.
인스턴스 러너는 귀하의 계정에 포함된 컴퓨트 분을 소비합니다.

러너 인증 토큰을 사용하여 인스턴스 러너 생성하기

GitLab 15.10에서 도입되었습니다. create_runner_workflow_for_admin 플래그 뒤에 배포됨

GitLab 16.0에서 기본적으로 활성화되었습니다.

GitLab 16.2에서 일반적으로 사용할 수 있게 되었습니다. 기능 플래그 create_runner_workflow_for_admin가 제거되었습니다.

전제 조건:

관리자는 되어야 합니다.

러너를 생성하면 등록하는 데 사용하는 러너 인증 토큰이 할당됩니다. 러너는 작업 큐에서 작업을 가져올 때 GitLab과 인증하기 위해 토큰을 사용합니다.

인스턴스 러너를 생성하려면:

왼쪽 사이드바에서 하단의 Admin을 선택합니다.
CI/CD > Runners를 선택합니다.
새 인스턴스 러너를 선택합니다.
GitLab Runner가 설치된 운영 체제를 선택합니다.
Tags 섹션에서 Tags 필드에 러너가 실행할 수 있는 작업 태그를 입력합니다.
이 러너에 대한 작업 태그가 없다면 Untagged 실행을 선택합니다.
선택 사항: 러너 설명 필드에 GitLab에 표시될 러너 설명을 추가합니다.
선택 사항: 구성 섹션에 추가 구성을 추가합니다.
러너 생성을 선택합니다.
화면의 지시에 따라 명령줄에서 러너를 등록합니다. 명령줄에서 요청할 때:
- GitLab 인스턴스 URL에는 귀하의 GitLab 인스턴스 URL을 사용합니다. 예를 들어, 귀하의 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되고 있다면, 귀하의 GitLab 인스턴스 URL은 https://gitlab.example.com입니다.
- executor에는 executor의 유형을 입력합니다. executor는 러너가 작업을 실행하는 환경입니다.

또한 API를 사용하여 러너를 생성할 수 있습니다.

러너 인증 토큰은 등록하는 동안 UI에서 제한된 시간 동안 표시됩니다. 러너를 등록한 후, 인증 토큰은 config.toml에 저장됩니다.

인스턴스 러너를 등록 토큰으로 생성하기 (사용 중단)

경고:

러너 등록 토큰을 전달하는 기능과 특정 구성 인수에 대한 지원이 사용 중단 되었으며 GitLab 15.6에서 제거되고 GitLab 18.0에서 완전히 사라질 예정입니다. 러너 인증 토큰을 대신 사용해야 합니다. 더 많은 정보는 새 러너 등록 워크플로우로 마이그레이션하기를 참조하세요.

선행 조건:

러너 등록 토큰은 관리자 영역에서 사용 가능해야 합니다.
당신은 관리자여야 합니다.

인스턴스 러너를 생성하려면:

왼쪽 사이드바에서 하단의 관리자를 선택합니다.
CI/CD > 러너를 선택합니다.
인스턴스 러너 등록을 선택합니다.
등록 토큰을 복사합니다.
러너 등록하기를 선택합니다.

인스턴스 러너 일시 정지 또는 재개

선행 조건:

당신은 관리자여야 합니다.

러너를 일시 정지하여 GitLab 인스턴스의 그룹 및 프로젝트에서 작업을 수락하지 않도록 할 수 있습니다.

왼쪽 사이드바에서 하단의 관리자를 선택합니다.
CI/CD > 러너를 선택합니다.
검색 상자에 러너 설명을 입력하거나 러너 목록을 필터링합니다.
러너 목록에서, 러너의 오른쪽에:
- 러너를 일시 정지하려면 일시 정지( )를 선택합니다.
- 러너를 재개하려면 재개()를 선택합니다.

인스턴스 러너 삭제

선행 조건:

당신은 관리자여야 합니다.

인스턴스 러너를 삭제하면 GitLab 인스턴스에서 영구히 삭제되며, 그룹 및 프로젝트에서 더 이상 사용할 수 없습니다. 만약 러너가 작업을 수락하지 않도록 일시적으로 중지하고 싶다면 러너를 일시 정지 할 수 있습니다.

단일 또는 여러 인스턴스 러너를 삭제하려면:

왼쪽 사이드바에서 하단의 관리자를 선택합니다.
CI/CD > 러너를 선택합니다.
검색 상자에 러너 설명을 입력하거나 러너 목록을 필터링합니다.
인스턴스 러너 삭제:
- 단일 러너를 삭제하려면, 러너 옆에서 러너 삭제()를 선택합니다.
- 여러 인스턴스 러너를 삭제하려면, 각 러너의 체크박스를 선택하고 선택한 삭제를 선택합니다.
- 모든 러너를 삭제하려면, 러너 목록 상단의 체크박스를 선택하고 선택한 삭제를 선택합니다.
러너를 영구적으로 삭제를 선택합니다.

프로젝트에 대한 인스턴스 러너 활성화

GitLab.com에서는 인스턴스 러너가 모든 프로젝트에서 기본적으로 활성화되어 있습니다.

GitLab의 자체 관리 인스턴스의 경우, 관리자가 모든 새 프로젝트에 대해 활성화할 수 있습니다.

기존 프로젝트의 경우, 관리자가 설치하고 등록해야 합니다.

프로젝트에 대한 인스턴스 러너를 활성화하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
이 프로젝트에 대한 인스턴스 러너 활성화 토글을 켭니다.

그룹에 대한 인스턴스 러너 활성화

그룹에 대한 인스턴스 러너를 활성화하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
이 그룹에 대한 인스턴스 러너 활성화 토글을 켭니다.

프로젝트에 대한 인스턴스 러너 비활성화

개별 프로젝트 또는 그룹에 대한 인스턴스 러너를 비활성화할 수 있습니다.

프로젝트 또는 그룹에 대해 소유자 역할이 있어야 합니다.

프로젝트에 대한 인스턴스 러너를 비활성화하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
인스턴스 러너 영역에서 이 프로젝트에 대한 인스턴스 러너 활성화 토글을 끕니다.

인스턴스 러너는 프로젝트에 대해 자동으로 비활성화됩니다:

상위 그룹의 인스턴스 러너 설정이 비활성화된 경우, 그리고
이 설정을 프로젝트 수준에서 재정의할 수 없는 경우.

그룹에 대한 인스턴스 러너 비활성화

그룹에 대한 인스턴스 러너를 비활성화하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
이 그룹에 대한 인스턴스 러너 활성화 토글을 끕니다.
선택 사항. 개별 프로젝트나 하위 그룹에 대해 인스턴스 러너를 활성화할 수 있도록 하려면, 프로젝트와 하위 그룹이 그룹 설정을 재정의하도록 허용을 선택합니다.

인스턴스 러너가 작업을 선택하는 방법

인스턴스 러너는 공정 사용 대기열을 사용하여 작업을 처리합니다. 이 대기열은 프로젝트가 수백 개의 작업을 생성하고 사용 가능한 모든 인스턴스 러너 리소스를 사용하는 것을 방지합니다.

공정 사용 대기열 알고리즘은 인스턴스 러너에서 이미 실행 중인 작업 수가 가장 적은 프로젝트를 기준으로 작업을 할당합니다.

예를 들어, 다음 작업이 대기열에 있다면:

프로젝트 1의 작업 1
프로젝트 1의 작업 2
프로젝트 1의 작업 3
프로젝트 2의 작업 4
프로젝트 2의 작업 5
프로젝트 3의 작업 6

여러 CI/CD 작업이 동시에 실행될 때, 공정 사용 알고리즘은 다음과 같은 순서로 작업을 할당합니다:

작업 1이 먼저 선택됩니다. 이는 실행 중인 작업이 없는 프로젝트에서 가장 낮은 작업 번호를 가지기 때문입니다(즉, 모든 프로젝트).
작업 4가 다음입니다. 이제 실행 중인 작업이 없는 프로젝트에서 가장 낮은 작업 번호는 4입니다(프로젝트 1에는 작업이 실행 중입니다).
작업 6이 다음입니다. 이제 실행 중인 작업이 없는 프로젝트에서 가장 낮은 작업 번호는 6입니다(프로젝트 1과 2에는 작업이 실행 중입니다).
작업 2가 다음입니다. 실행 중인 작업 수가 가장 적은 프로젝트 중에서(각각 1개의 작업을 가지고 있음) 가장 낮은 작업 번호를 가집니다.
작업 5가 다음입니다. 프로젝트 1에는 이제 2개의 작업이 실행 중이며, 작업 5는 프로젝트 2와 3 사이에서 남아있는 가장 낮은 작업 번호입니다.
마지막으로 작업 3입니다… 왜냐하면 그것이 남아있는 유일한 작업이기 때문입니다.

하나의 작업만 실행될 때 공정 사용 알고리즘은 다음과 같은 순서로 작업을 할당합니다:

작업 1이 먼저 선택됩니다. 이는 실행 중인 작업이 없는 프로젝트에서 가장 낮은 작업 번호를 가지기 때문입니다(즉, 모든 프로젝트).
작업 1이 완료됩니다.
작업 2가 다음입니다. 작업 1이 완료되면 모든 프로젝트에서 실행 중인 작업이 0이 되며, 2가 가장 낮은 사용 가능한 작업 번호입니다.
작업 4가 다음입니다. 프로젝트 1에서 작업이 실행 중인 경우, 프로젝트 2와 3에서 실행 중인 작업이 없는 프로젝트에서 가장 낮은 번호는 4입니다.
작업 4가 완료됩니다.
작업 5가 다음입니다. 작업 4가 완료되면 프로젝트 2는 실행 중인 작업이 없습니다.
작업 6이 다음입니다. 프로젝트 3은 실행 중인 작업이 없는 유일한 프로젝트입니다.
마지막으로 작업 3이 선택됩니다… 다시 말해, 그것이 남아있는 유일한 작업이기 때문입니다.

그룹 러너

모든 프로젝트가 그룹 내에서 특정 러너 집합에 액세스할 수 있도록 하려면 _그룹 러너_를 사용하세요.

그룹 러너는 선입선출 큐를 사용하여 작업을 처리합니다.

러너 인증 토큰으로 그룹 러너 생성

도입됨 GitLab 15.10에서. create_runner_workflow_for_namespace 플래그 뒤에 배포됨. 기본적으로 비활성화되어 있습니다.

기본적으로 활성화됨 GitLab 16.0에서.

일반적으로 사용 가능 GitLab 16.2에서. 기능 플래그 create_runner_workflow_for_admin 제거됨.

필수 조건:

그룹에 대한 소유자 역할이 있어야 합니다.

자체 관리 GitLab 인스턴스 또는 GitLab.com에 대한 그룹 러너를 생성할 수 있습니다.

러너를 생성하면, 러너 인증 토큰이 할당되며, 이 토큰을 사용하여 러너를 등록합니다.

러너는 작업 큐에서 작업을 가져올 때 이 토큰을 사용하여 GitLab에 인증합니다.

그룹 러너를 생성하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
새 그룹 러너를 선택합니다.
태그 섹션의 태그 필드에 러너가 실행할 작업을 지정하는 작업 태그를 입력합니다.
이 러너에 대한 작업 태그가 없으면 태그 없는 실행을 선택합니다.
선택 사항. 러너 설명 필드에 GitLab에 표시될 러너 설명을 추가합니다.
선택 사항. 구성 섹션에 추가 구성을 추가합니다.
러너 생성을 선택합니다.
GitLab 러너가 설치된 플랫폼을 선택합니다.
화면에 표시되는 지침을 완료합니다:
- Linux, macOS 및 Windows의 경우, 명령줄에서 요청받으면:
  - GitLab 인스턴스 URL에 여러분의 GitLab 인스턴스의 URL을 사용합니다. 예를 들어, 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되는 경우, GitLab 인스턴스 URL은 https://gitlab.example.com입니다.
  - executor에는 executor의 타입을 입력합니다. 실행자는 러너가 작업을 수행하는 환경입니다.
- Google Cloud의 경우, Google Cloud에서 러너 프로비저닝을 참조하세요.

또한 API를 사용하여 러너를 생성할 수 있습니다.

참고: 러너 인증 토큰은 등록 중 UI에서 짧은 시간 동안만 표시됩니다.

등록 토큰으로 그룹 러너 생성 (사용 중단)

경로가 설정 > CI/CD > 러너에서 변경되었습니다.

경고: 러너 등록 토큰을 전달하는 기능과 특정 구성 인수에 대한 지원은
사용 중단되었으며, GitLab 15.6에서 제거될 예정입니다. 인증 토큰을 대신 사용해야 합니다. 자세한 내용은 새 러너 등록 작업 흐름으로 마이그레이션을 참조하세요.

필수 조건:

러너 등록 토큰은 최상위 그룹에서 활성화되어야 합니다.
그룹에 대한 소유자 역할이 있어야 합니다.

그룹 러너를 생성하려면:

GitLab 러너 설치합니다.
왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
오른쪽 상단 모서리에서 그룹 러너 등록을 선택합니다.
러너 설치 및 등록 지침 표시를 선택합니다.
이 지침에는 토큰, URL 및 러너를 등록하는 명령이 포함됩니다.

또는 등록 토큰을 복사하고 러너를 등록하는 방법에 대한 문서를 따라갈 수 있습니다.

그룹 러너 보기

사용자가 그룹 러너를 볼 수 있는 기능이 Maintainer 역할에 대해 도입됨 GitLab 16.4에서.

전제 조건:

그룹에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.

그룹 및 해당 하위 그룹과 프로젝트의 모든 러너를 볼 수 있습니다.

자체 관리형 GitLab 인스턴스 또는 GitLab.com을 사용하여 이 작업을 수행할 수 있습니다.

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.

그룹 러너 필터링하여 상속된 것만 표시

GitLab 15.5에서 도입됨.

GitLab 15.5에서 일반 제공. 기능 플래그 runners_finder_all_available가 제거되었습니다.

목록에 모든 러너를 표시할지, 또는 인스턴스 또는 다른 그룹에서 상속된 러너만 표시할지 선택할 수 있습니다.

기본적으로 상속된 러너만 표시됩니다.

인스턴스에서 사용 가능한 모든 러너를 표시하려면, 인스턴스 러너와 다른 그룹에 있는 러너를 포함하여:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
목록 위에서 상속된 것만 표시 토글을 끕니다.

그룹 러너 일시 정지 또는 재개

전제 조건:

그룹에 대한 관리자이거나 Owner 역할이 있어야 합니다.

러너를 일시 정지하여 GitLab 인스턴스의 하위 그룹 및 프로젝트에서 작업을 수락하지 않도록 할 수 있습니다. 여러 프로젝트에서 사용하는 그룹 러너를 일시 정지하면 모든 프로젝트에 대해 러너가 일시 정지됩니다.

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
검색 상자에 러너 설명을 입력하거나 러너 목록을 필터링합니다.
러너 목록에서, 러너의 오른쪽에서:
- 러너를 일시 정지하려면 일시 정지()를 선택합니다.
- 러너를 재개하려면 재개()를 선택합니다.

그룹 러너 삭제

다중 러너 삭제 기능이 도입됨 GitLab 15.6에서.

전제 조건:

그룹에 대한 관리자이거나 Owner 역할이 있어야 합니다.

그룹 러너를 삭제하면 GitLab 인스턴스에서 영구적으로 삭제되며 하위 그룹 및 프로젝트에서 더 이상 사용할 수 없습니다. 러너가 작업을 수락하는 것을 일시적으로 중지하려면 대신 일시 정지할 수 있습니다.

단일 또는 여러 그룹 러너를 삭제하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
검색 상자에 러너 설명을 입력하거나 러너 목록을 필터링합니다.
그룹 러너 삭제:
- 단일 러너를 삭제하려면, 러너 옆에 있는 러너 삭제()를 선택합니다.
- 여러 인스턴스 러너를 삭제하려면 각 러너의 체크박스를 선택하고 선택한 항목 삭제를 선택합니다.
- 모든 러너를 삭제하려면 러너 목록의 상단에 있는 체크박스를 선택하고 선택한 항목 삭제를 선택합니다.
러너 영구 삭제를 선택합니다.

오래된 그룹 러너 정리하기

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

도입됨 GitLab 15.1에서.

Prerequisites:

그룹의 소유자 역할이 필요합니다.

3개월 이상 비활성 상태인 그룹 러너를 정리할 수 있습니다.

그룹 러너는 특정 그룹에서 생성된 러너입니다.

왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
Settings > CI/CD를 선택합니다.
Runners를 확장합니다.
Enable stale runner cleanup 토글을 켭니다.

오래된 러너 정리 로그 보기

Sidekiq 로그를 확인하여 정리 결과를 볼 수 있습니다. Kibana에서 다음 쿼리를 사용할 수 있습니다:

{  
  "query": {  
    "match_phrase": {  
      "json.class.keyword": "Ci::Runners::StaleGroupRunnersPruneCronWorker"  
    }  
  }  
}  

오래된 러너가 제거된 항목 필터:

{  
  "query": {  
    "range": {  
      "json.extra.ci_runners_stale_group_runners_prune_cron_worker.total_pruned": {  
        "gte": 1,  
        "lt": null  
      }  
    }  
  }  
}  

프로젝트 러너

특정 프로젝트에 러너를 사용해야 할 때 _프로젝트 러너_를 사용하세요. 예를 들어,
특정 자격 증명이 필요한 배포 작업과 같은 특정 요구 사항이 있는 작업이 있을 때.

다른 러너에서 분리된 CI 활동이 많은 프로젝트가 있을 때 사용하세요.

여러 프로젝트에서 사용할 수 있도록 프로젝트 러너를 설정할 수 있습니다. 프로젝트 러너는
각 프로젝트에 대해 명시적으로 활성화되어야 합니다.

프로젝트 러너는 선입선출(FIFO) 큐를 사용하여 작업을 처리합니다.

프로젝트 러너는 포크된 프로젝트에서 자동으로 인스턴스를 가져오지 않습니다.
포크는 클론된 리포지토리의 CI/CD 설정을 복사합니다.

러너 인증 토큰으로 프로젝트 러너 생성하기

도입됨 GitLab 15.10. create_runner_workflow_for_namespace 플래그 뒤에 배포됨. 기본적으로 비활성화되어 있습니다.

기본적으로 활성화됨 GitLab 16.0에서.

일반적으로 사용 가능 GitLab 16.2에서. 기능 플래그 create_runner_workflow_for_admin가 제거되었습니다.

Prerequisites:

프로젝트에 대한 유지관리자 역할이 필요합니다.

자체 관리 GitLab 인스턴스 또는 GitLab.com에 대한 프로젝트 러너를 생성할 수 있습니다. 러너를 생성하면
러너에 등록하는 데 사용하는 러너 인증 토큰이 할당됩니다. 러너는 작업 큐에서 작업을 가져올 때 이 토큰을 사용하여
GitLab과 인증합니다.

프로젝트 러너를 생성하려면:

왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
Settings > CI/CD를 선택합니다.
Runners 섹션을 확장합니다.
New project runner를 선택합니다.
GitLab Runner가 설치된 운영 체제를 선택합니다.
Tags 섹션에서, Tags 필드에 러너가 실행할 작업을 지정하는 작업 태그를 입력합니다.
이 러너에 대한 작업 태그가 없으면 Run untagged를 선택합니다.
선택 사항. Runner description 필드에 GitLab에 표시될 러너 설명을 추가합니다.
선택 사항. Configuration 섹션에서 추가 구성을 추가합니다.
Create runner를 선택합니다.
GitLab Runner가 설치된 플랫폼을 선택합니다.
화면 지침을 완료합니다:
- Linux, macOS 및 Windows의 경우, 명령줄에서 요청할 때:
  - GitLab instance URL에 귀하의 GitLab 인스턴스 URL을 사용합니다. 예를 들어, 귀하의 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되면, GitLab 인스턴스 URL은 https://gitlab.example.com입니다.
  - executor에 executor 유형을 입력합니다. executor는 러너가 작업을 실행하는 환경입니다.
- Google Cloud의 경우, Google Cloud에서 러너 프로비저닝하기를 참조하세요.

러너를 생성하기 위해 API를 사용할 수도 있습니다.

러너 인증 토큰은 등록 중에 UI에 짧은 시간 동안만 표시됩니다.

프로젝트 러너를 등록 토큰으로 생성하기 (사용 중단됨)

경고:

러너 등록 토큰을 전달하는 기능과 특정 구성 인수에 대한 지원은
사용 중단되었습니다
GitLab 15.6에서 사용 중단되었으며 GitLab 18.0에서 제거될 예정입니다.
대신 러너 인증 토큰을 사용해야 합니다. 자세한 내용은
새 러너 등록 워크플로우로 마이그레이션하기를 참조하십시오.

사전 요구 사항:

러너 등록 토큰은 최상위 그룹에서 활성화되어야 합니다.
프로젝트에 대해 최소 유지 관리자인 역할이 필요합니다.

프로젝트 러너를 생성하려면:

GitLab Runner 설치하기
왼쪽 사이드바에서 검색 또는 이동하기를 선택하고
러너를 사용하려는 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
프로젝트 러너 섹션에서 URL과 토큰을 기록합니다.
러너 등록하기

이제 이 프로젝트에 대해 러너가 활성화되었습니다.

프로젝트 러너 일시 중지 또는 재개

사전 요구 사항:

관리자여야 하거나 프로젝트에 대해 유지 관리자인 역할이 필요합니다.

프로젝트 러너를 일시 중지하여 GitLab 인스턴스에서 배정된 프로젝트의 작업을 수락하지 않도록 할 수 있습니다.

왼쪽 사이드바에서 검색 또는 이동하기를 선택하고
러너를 활성화하려는 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
배정된 프로젝트 러너 섹션에서 러너를 찾습니다.
러너의 오른쪽에서:
- 러너를 일시 중지하려면 일시 중지( )를 선택한 다음 일시 중지를 선택합니다.
- 러너를 재개하려면 재개( )를 선택합니다.

프로젝트 러너 삭제하기

사전 요구 사항:

관리자여야 하거나 프로젝트에 대해 유지 관리자인 역할이 필요합니다.
둘 이상의 프로젝트에 배정된 프로젝트 러너는 삭제할 수 없습니다.
러너를 삭제하기 전에 모든 프로젝트에서 사용 중지해야 합니다.

프로젝트 러너를 삭제하면 GitLab 인스턴스에서 영구적으로 삭제되며
다른 프로젝트에서 사용할 수 없습니다.
러너가 작업을 수락하지 못하도록 일시적으로 중지하려면
러너를 일시 중지할 수 있습니다.

왼쪽 사이드바에서 검색 또는 이동하기를 선택하고
러너를 활성화하려는 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
배정된 프로젝트 러너 섹션에서 러너를 찾습니다.
러너의 오른쪽에서 러너 제거를 선택합니다.
러너를 삭제하려면 제거를 선택합니다.

다른 프로젝트에 대한 프로젝트 러너 활성화하기

프로젝트 러너가 생성된 후 다른 프로젝트에 대해 활성화할 수 있습니다.

사전 요구 사항:

러너가 이미 활성화된 프로젝트에 대해
러너를 활성화하려는 프로젝트에 대해
프로젝트 러너는 잠금 해제되어 있어야 합니다.

프로젝트에 대한 러너를 활성화하려면:

왼쪽 사이드바에서 검색 또는 이동하기를 선택하고
러너를 활성화하려는 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
프로젝트 러너 영역에서 원하는 러너 옆에 있는 이 프로젝트에 대해 활성화를 선택합니다.

프로젝트 러너는 활성화된 모든 프로젝트에서 편집할 수 있습니다.

편집 사항에는 잠금 해제 및 태그 및 설명 편집이 포함되며,
러너를 사용하는 모든 프로젝트에 영향을 미칩니다.

관리자는 여러 프로젝트에 대한 러너 활성화하기를 할 수 있습니다.

프로젝트 러너가 다른 프로젝트에 대해 활성화되는 것을 방지하기

프로젝트 러너를 “잠금” 상태로 구성하면 다른 프로젝트에 대해 활성화할 수 없습니다.

이 설정은 처음 러너를 등록할 때 활성화할 수 있지만, 나중에 변경할 수도 있습니다.

프로젝트 러너를 잠그거나 잠금 해제하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 러너를 활성화할 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
잠그거나 잠금 해제하려는 프로젝트 러너를 찾습니다. 활성화되어 있는지 확인합니다. 인스턴스 또는 그룹 러너는 잠글 수 없습니다.
편집({연필})을 선택합니다.
현재 프로젝트에 잠금 체크박스를 선택합니다.
변경 사항 저장을 선택합니다.

러너 상태

러너는 다음 상태 중 하나를 가질 수 있습니다.

상태	설명
`online`	러너가 최근 2시간 이내에 GitLab에 접촉했으며 작업을 실행할 수 있습니다.
`offline`	러너가 2시간 이상 GitLab에 접촉하지 않았으며 작업을 실행할 수 없습니다. 러너를 확인하여 온라인으로 만들 수 있는지 확인하세요.
`stale`	러너가 7일 이상 GitLab에 접촉하지 않았습니다. 러너가 7일 이상 전에 생성되었지만 인스턴스에 접촉하지 않았다면 stale로 간주됩니다.
`never_contacted`	러너가 GitLab에 한 번도 접촉한 적이 없습니다. 러너가 GitLab에 접촉하게 하려면 `gitlab-runner run`을 실행하세요.

러너 성능 통계 보기

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

도입됨 GitLab 15.8.

관리자는 러너 통계를 통해 러너 집단의 성능에 대해 알아볼 수 있습니다.

중간 작업 대기 시간 값은 인스턴스 러너에 의해 실행된 가장 최근 100개의 작업의 대기 시간을 샘플링하여 계산됩니다. 최신 5000개의 러너만 고려됩니다.

중간값은 50번째 백분위수에 해당하는 값으로, 중간값보다 긴 시간 대기한 작업의 수와 중간값보다 짧은 시간 대기한 작업의 수가 같습니다.

러너 통계를 보려면:

왼쪽 사이드바 하단에서 관리자를 선택합니다.
CI/CD > 러너를 선택합니다.
메트릭 보기를 선택합니다.

업그레이드가 필요한 러너 확인하기

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

도입됨 GitLab 15.3.

러너가 사용하는 GitLab Runner의 버전은 최신 상태로 유지해야 합니다.

어떤 러너를 업그레이드해야 하는지 확인하려면:

러너 목록을 봅니다:
- 그룹의 경우:
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 빌드 > 러너를 선택합니다.
- 인스턴스의 경우:
  1. 왼쪽 사이드바 하단에서 관리자를 선택합니다.
  2. CI/CD > 러너를 선택합니다.
러너 목록 위에서 상태를 봅니다:
- 구형 - 추천: 러너가 최신 PATCH 버전을 가지고 있지 않으며, 이는 보안 또는 심각한 버그에 취약할 수 있습니다. 또는 러너가 GitLab 인스턴스보다 하나 이상의 MAJOR 버전 뒤처져 있어 일부 기능이 사용할 수 없거나 제대로 작동하지 않을 수 있습니다.
- 구형 - 사용 가능: 새로운 버전이 있지만 업그레이드가 중요하지 않습니다.
상태에 따라 목록을 필터링하여 업그레이드가 필요한 개별 러너를 확인합니다.

러너의 IP 주소 확인하기

러너의 IP 주소를 아는 것은 해당 러너와 관련된 문제를 해결하는 데 유용할 수 있습니다. GitLab은 작업을 폴링할 때 GitLab에 보내는 HTTP 요청의 소스를 통해 IP 주소를 저장하고 표시합니다. IP 주소는 항상 최신 상태로 유지되며, 러너의 IP가 변경되면 GitLab에서 자동으로 업데이트됩니다.

인스턴스 러너와 프로젝트 러너의 IP 주소는 서로 다른 위치에서 찾을 수 있습니다.

인스턴스 러너의 IP 주소 확인하기

필수 조건:

인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.

인스턴스 러너의 IP 주소를 확인하려면:

왼쪽 사이드바에서 하단의 Admin을 선택합니다.
CI/CD > Runners를 선택합니다.
테이블에서 러너를 찾아 IP Address 열을 확인합니다.

프로젝트 러너의 IP 주소 확인하기

프로젝트의 러너 IP 주소를 찾으려면,

프로젝트에 대한 소유자 역할이 있어야 합니다.

프로젝트의 Settings > CI/CD로 이동하여 Runners 섹션을 확장합니다.
러너 이름을 선택하고 IP Address 행을 찾습니다.

프로젝트 및 그룹에서 러너 등록 토큰 사용 활성화하기

GitLab 16.11에 도입됨

경고:

러너 등록 토큰을 전달하는 기능과 특정 구성 인수에 대한 지원은 GitLab 15.6에서 사용 중단되었으며, GitLab 18.0에서 제거될 예정입니다. 대신 러너 인증 토큰을 사용해야 합니다. 자세한 내용은 새로운 러너 등록 워크플로로 마이그레이션하기를 참조하세요.

GitLab 17.0에서 러너를 생성하기 위해 러너 등록 토큰의 사용이 모든 GitLab 인스턴스에서 비활성화됩니다. 사용자는 대신 러너 인증 토큰을 사용해야 합니다.

아직 러너 인증 토큰 사용으로 마이그레이션하지 않았다면, 프로젝트 및 그룹에 대한 러너 등록 토큰을 활성화할 수 있습니다. 이 설정 및 러너 등록 토큰에 대한 지원은 GitLab 18.0에서 제거될 예정입니다.

필수 조건:

러너 등록 토큰이 Admin 영역에서 활성화되어야 합니다.

왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
Settings > CI/CD를 선택합니다.
Runners를 확장합니다.
Allow members of projects and groups to create runners with runner registration tokens 토글을 켭니다.

러너 관리

인스턴스 러너

러너 인증 토큰을 사용하여 인스턴스 러너 생성하기

인스턴스 러너를 등록 토큰으로 생성하기 (사용 중단)

인스턴스 러너 일시 정지 또는 재개

인스턴스 러너 삭제

프로젝트에 대한 인스턴스 러너 활성화

그룹에 대한 인스턴스 러너 활성화

프로젝트에 대한 인스턴스 러너 비활성화

그룹에 대한 인스턴스 러너 비활성화

인스턴스 러너가 작업을 선택하는 방법

그룹 러너

러너 인증 토큰으로 그룹 러너 생성

등록 토큰으로 그룹 러너 생성 (사용 중단)

그룹 러너 보기

그룹 러너 필터링하여 상속된 것만 표시

그룹 러너 일시 정지 또는 재개

그룹 러너 삭제

오래된 그룹 러너 정리하기

오래된 러너 정리 로그 보기

프로젝트 러너

러너 인증 토큰으로 프로젝트 러너 생성하기

프로젝트 러너를 등록 토큰으로 생성하기 (사용 중단됨)

프로젝트 러너 일시 중지 또는 재개

프로젝트 러너 삭제하기

다른 프로젝트에 대한 프로젝트 러너 활성화하기

프로젝트 러너가 다른 프로젝트에 대해 활성화되는 것을 방지하기

러너 상태

러너 성능 통계 보기

업그레이드가 필요한 러너 확인하기

러너의 IP 주소 확인하기

인스턴스 러너의 IP 주소 확인하기

프로젝트 러너의 IP 주소 확인하기

프로젝트 및 그룹에서 러너 등록 토큰 사용 활성화하기

도움말

기능 사용 가능성과 제품 평가판

도움받기