인스턴스 러너
그룹 러너
프로젝트 러너
실행기 상태
실행기 성능에 대한 통계 보기
업그레이드해야 할 실행기 확인하기
실행기의 IP 주소 확인하기
- 인스턴스 실행기의 IP 주소 확인하기
- 프로젝트 실행기의 IP 주소 확인하기
프로젝트 및 그룹에서 러너 등록 토큰 사용 가능하게 하기

러너 관리

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

GitLab 러너에는 다음과 같은 종류의 러너가 있으며, 액세스를 희망하는 대상에 따라 사용할 수 있습니다:

인스턴스 러너는 GitLab 인스턴스의 모든 그룹 및 프로젝트에서 사용할 수 있습니다.
그룹 러너는 그룹의 모든 프로젝트 및 하위 그룹에서 사용할 수 있습니다.
프로젝트 러너는 특정 프로젝트와 관련이 있습니다. 일반적으로 프로젝트 러너는 한 번에 한 프로젝트에서 사용됩니다.

인스턴스 러너

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

다양한 작업에 유사한 요구 사항이 있는 경우 인스턴스 러너를 사용합니다. 여러 프로젝트에서 대기 중인 여러 러너를 갖는 대신 몇 개의 러너가 여러 프로젝트를 처리하도록 할 수 있습니다.

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

GitLab 러너 설치 및 인스턴스 러너 등록.
각 그룹에 대한 최대 인스턴스 러너 컴퓨팅 분를 구성합니다.

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 > 러너를 선택합니다.
새 인스턴스 러너를 선택합니다.
GitLab 러너가 설치된 운영 체제를 선택합니다.
태그 섹션에서 태그 필드에 러너가 실행할 수 있는 작업 태그를 입력합니다. 이 러너에 대한 작업 태그가 없는 경우 태그 없이 실행을 선택합니다.
(옵션) 러너 설명 필드에 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에서 제거될 예정입니다. 러너 인증 토큰을 대신 사용해야 합니다. 자세한 내용은 새 러너 등록 흐름으로 마이그레이션을 참조하세요.

전제 조건:

러너 등록 토큰은 Admin 영역에서 활성화되어 있어야 합니다.
관리자 여야 합니다.

인스턴스 러너를 만들려면 다음을 수행합니다:

왼쪽 사이드바에서 아래쪽에 Admin을 선택합니다.
CI/CD > 러너를 선택합니다.
인스턴스 러너 등록을 선택합니다.
등록 토큰을 복사합니다.
러너를 등록합니다.

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

전제 조건:

관리자 여야 합니다.

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

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

인스턴스 러너 삭제

전제 조건:

관리자 여야 합니다.

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

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

왼쪽 사이드바에서 아래쪽에 Admin을 선택합니다.
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를 완료합니다.
작업 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입니다.
  - 실행자에는 실행자의 유형을 입력합니다. 실행자는 러너가 작업을 실행하는 환경입니다.
- Google Cloud의 경우 Google Cloud에서 러너 프로비저닝을 참조합니다.

러너를 생성하는 데에는 API를 사용할 수도 있습니다.

참고: 러너의 인증 토큰은 등록 중에 UI에만 일시적으로 표시됩니다.

그룹 러너 등록 토큰 생성하기 (deprecated)

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

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

필수 조건:

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

그룹 러너를 생성하려면:

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

대신, 등록 토큰을 복사하고 러너 등록 문서를 따를 수 있습니다.

그룹 러너 보기

Maintainer 역할을 가진 사용자의 그룹 러너 보기 기능이 GitLab 16.4에서 introduced되었습니다.

필수 조건:

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

그룹 및 하위 그룹 및 프로젝트에 대한 모든 러너를 볼 수 있습니다. 사용자는 자체 관리형 GitLab 인스턴스 또는 GitLab.com에 대해 이 작업을 수행할 수 있습니다.

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

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

GitLab 15.5에서 introduced됨.
GitLab 15.5에서 일반적으로 사용 가능해짐. 기능 플래그 runners_finder_all_available이 제거되었습니다.

리스트에서 모든 러너를 표시하거나 인스턴스 또는 다른 그룹에서 상속된 러너만 표시하도록 선택할 수 있습니다.

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

인스턴스 러너 및 다른 그룹에 있는 러너를 포함하여 인스턴스에서 사용 가능한 모든 러너를 표시하려면 다음을 수행하십시오.

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

그룹 러너 일시 중지 또는 다시 시작하기

필수 조건:

그룹에 대해 관리자 또는 소유자 역할이 있어야 합니다.

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

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

그룹 러너 삭제

여러 러너 삭제가 GitLab 15.6에서 introduced되었습니다.

필수 조건:

그룹에 대해 관리자 또는 소유자 역할이 있어야 합니다.

그룹 러너를 삭제하면 GitLab 인스턴스에서 영구적으로 삭제되어 하위 그룹 및 프로젝트에서 더 이상 사용할 수 없습니다. 러너가 작업을 수락하지 않도록 일시 중지하려면 러너를 일시 중지하십시오.

단일 또는 여러 그룹 러너를 삭제하려면 다음을 수행하십시오:

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

사용하지 않은 그룹 러너 정리

상세 정보: Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

GitLab 15.1에서 introduced되었습니다.

필수 조건:

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

3개월 이상 활동하지 않은 그룹 러너를 정리할 수 있습니다.

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

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
설정 > CI/CD를 선택하십시오.
러너를 확장하십시오.
사용되지 않는 러너 정리 활성화 토글을 켜십시오.

사용되지 않는 그룹 러너 정리 로그 보기

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이 제거됨.

전제 조건:

프로젝트의 관리자 역할이 있어야 합니다.

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

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

왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
Runners 섹션을 확장합니다.
New project runner를 선택합니다.
GitLab Runner가 설치된 운영 체제를 선택합니다.
태그 섹션에서 태그 필드에 러너가 실행할 수 있는 작업 태그를 입력합니다. 이 러너에 대한 작업 태그가 없는 경우 태그 없음 실행을 선택합니다.
선택 사항. 러너 설명 필드에 GitLab에 표시될 러너 설명을 추가합니다.
선택 사항. 구성 섹션에 추가 구성을 추가합니다.
러너 생성를 선택합니다.
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에서 짧은 기간 동안만 표시됩니다.

러너 등록 토큰을 사용하여 프로젝트 러너 생성 (Deprecated)

경고: 러너 등록 토큰 전달 및 특정 구성 인수 지원 기능이 GitLab 15.6에서 폐기됨 및 GitLab 18.0에서 제거될 예정입니다. 러너 인증 토큰을 대신 사용해야 합니다. 자세한 내용은 새 러너 등록 워크플로로 마이그레이션하기를 참조하십시오.

전제 조건:

러너 등록 토큰을 최상위 그룹에서 활성화해야 합니다.
프로젝트에 대해 적어도 관리자 역할이 있어야 합니다.

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

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

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

프로젝트 러너 일시 정지 또는 다시 시작

전제 조건:

관리자이거나 프로젝트의 관리자 역할이 있어야 합니다.

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

왼쪽 사이드바에서 검색 또는 이동을 선택하고 러너를 활성화하려는 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
Runners를 확장합니다.
할당된 프로젝트 러너 섹션에서 러너를 찾습니다.
러너 우측에:
- 러너를 일시 정지하려면 일시 정지를 선택합니다 (), 그런 다음 일시 정지를 선택합니다.
- 러너를 다시 시작하려면 재개를 선택합니다 ().

프로젝트 러너 삭제

전제 조건:

관리자이거나 프로젝트의 관리자 역할이 있어야 합니다.
한 개 이상의 프로젝트에 할당된 프로젝트 러너를 삭제할 수 없습니다. 러너를 삭제하기 전에 러너가 활성화된 모든 프로젝트에서 비활성화해야 합니다.

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

왼쪽 사이드바에서 검색 또는 이동을 선택하고 러너를 사용할 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
Runners를 확장합니다.
할당된 프로젝트 러너 섹션에서 러너를 찾습니다.
러너 우측에서 러너 제거를 선택합니다.
러너를 삭제하려면 제거를 선택합니다.

다른 프로젝트에 대해 프로젝트 실행기(enable a project runner for a different project)

프로젝트 실행기가 생성된 후에, 다른 프로젝트에 대해 이를 활성화할 수 있습니다.

조건:

다음과 같은 조건을 충족해야 합니다:

이미 실행 중인 프로젝트.
실행기를 활성화하려는 프로젝트.
프로젝트 실행기가 잠겨 있지 않아야 합니다.

프로젝트 실행기를 프로젝트에 활성화하려면:

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

원하는 프로젝트 실행기를 편집할 수 있습니다. 이는 실행기를 사용하는 모든 프로젝트에 영향을 미치며, 실행기를 잠그거나 태그와 설명을 편집하는 것 등을 포함합니다.

관리자는 다중 프로젝트용 실행기를 활성화할 수 있습니다.

다른 프로젝트에 프로젝트 실행기 활성화 방지(prevent a project runner from being enabled for other projects)

프로젝트 실행기가 다른 프로젝트에 활성화되지 못하도록 “잠글” 수 있습니다. 이 설정은 처음에 실행기를 등록할 때 활성화할 수 있지만, 나중에 변경할 수도 있습니다.

프로젝트 실행기를 잠그거나 잠금을 해제하려면:

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

실행기 상태

실행기는 다음 중 하나의 상태를 가질 수 있습니다.

상태	설명
`온라인`	실행기는 지난 2시간 이내에 GitLab에 연락하였으며 작업을 실행할 수 있습니다.
`오프라인`	실행기는 마지막 2시간 이상 동안 GitLab에 연락하지 않았으며 작업을 실행할 수 없습니다. 실행기를 온라인 상태로 변경할 수 있는지 확인하세요.
`오래된`	실행기는 마지막 7일 이상 동안 GitLab에 연락하지 않았습니다. 실행기가 7일 이상 전에 생성되었지만 인스턴스에 연락을 하지 않은 경우도 오래된으로 간주합니다.
`연락한 적 없음`	실행기가 한 번도 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은 작업을 위해 폴링하는 경우에 HTTP 요청의 소스를 볼 수 있어 IP 주소를 저장하고 표시합니다. 실행기 IP 주소는 항상 최신 상태로 유지되므로 실행기 IP가 변경되면 GitLab이 자동으로 업데이트합니다.

인스턴스 실행기 및 프로젝트 실행기의 IP 주소를 찾을 수 있습니다.

인스턴스 실행기의 IP 주소 확인하기

조건:

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

인스턴스 실행기의 IP 주소를 확인하려면:

왼쪽 사이드바에서 맨 아래에서 관리자를 선택합니다.
CI/CD > 실행기를 선택합니다.
표에서 실행기를 찾고 IP 주소 열을 확인합니다.

프로젝트 실행기의 IP 주소 확인하기

프로젝트의 실행기의 IP 주소를 확인하려면 해당 프로젝트의 설정 > CI/CD를 열고 Runners 섹션을 확장합니다. 실행기 이름을 선택하고 IP 주소 행을 찾습니다.

프로젝트 및 그룹에서 러너 등록 토큰 사용 가능하게 하기

GitLab 16.11에서 도입됨

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

GitLab 17.0에서 러너 등록 토큰을 사용하여 러너를 만드는 것이 모든 GitLab 인스턴스에서 비활성화될 것입니다. 사용자는 대신 러너 인증 토큰을 사용해야 합니다. 아직 러너 인증 토큰 사용으로 마이그레이션하지 않았다면, 프로젝트 및 그룹에서 러너 등록 토큰을 활성화할 수 있습니다. 이 설정 및 러너 등록 토큰 지원은 GitLab 18.0에서 제거될 것입니다.

전제 조건:

러너 등록 토큰은 관리자 영역에서 활성화되어 있어야 합니다.

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
설정 > CI/CD를 선택합니다.
러너를 확장합니다.
프로젝트 및 그룹 구성원이 러너 등록 토큰을 사용하여 러너를 만들 수 있도록 허용 토글을 켭니다.

러너 관리

인스턴스 러너

러너 인증 토큰으로 인스턴스 러너 생성

등록 토큰을 사용하여 인스턴스 러너 생성(사용 중단)

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

인스턴스 러너 삭제

프로젝트용 인스턴스 러너 활성화

그룹용 인스턴스 러너 활성화

프로젝트용 인스턴스 러너 비활성화

그룹용 인스턴스 러너 비활성화

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

그룹 러너

러너 인증 토큰을 사용하여 그룹 러너 생성

그룹 러너 등록 토큰 생성하기 (deprecated)

그룹 러너 보기

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

그룹 러너 일시 중지 또는 다시 시작하기

그룹 러너 삭제

사용하지 않은 그룹 러너 정리

사용되지 않는 그룹 러너 정리 로그 보기

프로젝트 러너

러너 토큰으로 프로젝트 러너 생성

러너 등록 토큰을 사용하여 프로젝트 러너 생성 (Deprecated)

프로젝트 러너 일시 정지 또는 다시 시작

프로젝트 러너 삭제

다른 프로젝트에 대해 프로젝트 실행기(enable a project runner for a different project)

조건:

다른 프로젝트에 프로젝트 실행기 활성화 방지(prevent a project runner from being enabled for other projects)

실행기 상태

실행기 성능에 대한 통계 보기

업그레이드해야 할 실행기 확인하기

실행기의 IP 주소 확인하기

인스턴스 실행기의 IP 주소 확인하기

프로젝트 실행기의 IP 주소 확인하기

프로젝트 및 그룹에서 러너 등록 토큰 사용 가능하게 하기

도움말

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

도움받기