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

러너 관리

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

GitLab Runner에는 액세스 권한에 따라 사용 가능한 다음 유형의 러너가 있습니다.

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

인스턴스 러너

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

여러 작업이 유사한 요구 사항을 가지고 있는 경우 인스턴스 러너를 사용하십시오. 여러 프로젝트에서 여러 러너가 대기하는 대신 여러 프로젝트를 처리할 수 있는 몇 개의 러너를 가질 수 있습니다.

Self-Managed형 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과 인증하는 데 해당 토큰을 사용합니다.

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

왼쪽 사이드바에서 하단에 관리 영역을 선택합니다.
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에 저장됩니다.

등록 토큰을 사용하여 인스턴스 러너 생성 (불추천)

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

전제 조건:

러너 등록 토큰을 활성화해야 합니다. (관리 영역)
관리자여야 합니다.

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

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

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

전제 조건:

관리자여야 합니다.

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

왼쪽 사이드바에서 하단에 관리 영역을 선택합니다.
CI/CD > 러너를 선택합니다.
검색란에 러너 설명을 입력하거나 러너 디렉터리을 필터링합니다.
러너 디렉터리에서 러너 우측에:
- 러너를 일시 중지하려면 일시 중지를 선택합니다 ().
- 러너를 재개하려면 재개를 선택합니다 ().

인스턴스 러너 삭제

전제 조건:

관리자여야 합니다.

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

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

왼쪽 사이드바에서 하단에 관리 영역을 선택합니다.
CI/CD > 러너를 선택합니다.
검색란에 러너 설명을 입력하거나 러너 디렉터리을 필터링합니다.
인스턴스 러너를 삭제합니다:
- 단일 러너를 삭제하려면 러너 옆에 러너 삭제를 선택합니다 ().
- 여러 인스턴스 러너를 삭제하려면 각 러너의 확인란을 선택한 후 선택된 항목 삭제를 선택합니다.
- 모든 러너를 삭제하려면 러너 디렉터리 상단의 확인란을 선택한 후 선택된 항목 삭제를 선택합니다.
인스턴스 러너 영구 삭제를 선택합니다.

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

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

Self-Managed형 GitLab 인스턴스에서는 관리자가 새 프로젝트용으로 활성화할 수 있습니다.

기존 프로젝트의 경우 관리자는 인스턴스 러너를 설치하고 등록해야 합니다.

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

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

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

그룹용 인스턴스 러너를 활성화하려면:

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

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

개별 프로젝트 또는 그룹에 대해 인스턴스 러너를 비활성화할 수 있습니다. 프로젝트 또는 그룹에 대한 소유자 역할이 있어야 합니다.

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

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

프로젝트용 인스턴스 러너가 자동으로 비활성화됩니다:

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

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

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

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

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

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

공정한 사용 큐 알고리즘은 이미 실행 중인 작업이 가장 적은 프로젝트를 기준으로 작업을 할당합니다.

예를 들어, 큐에 다음과 같은 작업이 있으면:

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

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

모든 프로젝트에 이미 실행 중인 작업이 없으므로 작업 1이 먼저입니다(즉, 모든 프로젝트).
프로젝트 1이 작업 실행 중이므로 4가 작업 실행 중인 프로젝트가 없어졌기 때문에 작업 4가 다음입니다.
프로젝트 1(2개의 작업 실행 중)와 프로젝트 2(작업 4가 실행 중) 중에서 남은 가장 낮은 작업 번호인 6이 다음입니다.
실행 중인 작업이 가장 적은 프로젝트를 기준으로 가장 낮은 작업 번호인 2가 다음입니다.
실행 중인 작업이 가장 적은 프로젝트를 기준으로 남아 있는 작업 번호 중에서 5가 다음입니다.
마지막으로 남은 작업이 작업 3입니다.

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

모든 프로젝트에 이미 실행 중인 작업이 없으므로 작업 1이 먼저입니다(즉, 모든 프로젝트).
작업 1을 끝냅니다.
작업 1을 끝내고 모든 프로젝트에 다시 실행 중인 작업이 없기 때문에 2가 가장 낮은 가능한 작업 번호입니다.
프로젝트 1(작업 실행 중)이 있기 때문에 작업 4가 다음입니다.
작업 4를 끝냅니다.
프로젝트 2에 다시 작업이 실행 중이 없기 때문에 작업 5가 다음입니다.
프로젝트 3이 실행 중인 작업이 없기 때문에 마지막으로 작업 6이 선택됩니다.

그룹 러너

모든 프로젝트가 러너 집합에 액세스해야 하는 경우 그룹 러너를 사용하세요.

그룹 러너는 먼저 들어온 순서대로 큐에서 작업을 처리합니다.

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

소개: GitLab 15.10에 도입됨. create_runner_workflow_for_namespace 플래그로 배포됨. 기본적으로 비활성화됨.
기본적으로 활성화됨: GitLab 16.0에 도입됨.
일반적으로 사용 가능: GitLab 16.2에 도입됨. create_runner_workflow_for_admin 플래그가 제거됨.

전제 조건:

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

그룹용 러너를 생성할 수 있으며, 생성시 러너가 사용할 러너 인증 토큰이 할당됩니다. 이 토큰을 사용하여 러너가 작업 대기열에서 작업을 가져올 때 GitLab에서 인증합니다.

그룹용 러너를 생성하려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
새 그룹 러너를 선택합니다.
GitLab 러너가 설치된 운영 체제를 선택합니다.
태그 섹션에서 태그 필드에 러너가 실행할 작업을 지정하는 작업 태그를 입력합니다. 이 러너를 위한 작업 태그가 없는 경우 태그 없이 실행을 선택합니다.
선택 사항. 러너 설명 필드에 GitLab에 표시되는 러너 설명을 추가합니다.
선택 사항. 구성 섹션에 추가 구성을 추가합니다.
러너 생성을 선택합니다.
명령줄에서 러너를 등록하라는 화면 지침에 따릅니다. 명령줄에서 프롬프트가 표시되면:
- GitLab 인스턴스 URL에는 GitLab 인스턴스의 URL을 사용합니다. 예를 들어, 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되는 경우 GitLab 인스턴스 URL은 https://gitlab.example.com입니다.
- executor에는 executor 유형을 입력합니다. Executor는 러너가 작업을 실행하는 환경입니다.

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

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

등록 토큰으로 그룹 러너 생성(폐기됨)

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

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

전제 조건:

러너 등록 토큰은 상위 그룹에서 사용해야 합니다.
그룹에 대한 소유자 역할이 있어야 합니다.

그룹용 러너를 생성하려면:

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

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

그룹 러너 보기

Maintainer 역할을 가진 사용자가 그룹 러너를 볼 수 있는 기능은 GitLab 16.4에서 도입되었습니다.

전제 조건:

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

그룹 및 해당 하위 그룹 및 프로젝트의 모든 러너를 볼 수 있습니다. 자체 호스팅 GitLab 인스턴스 또는 GitLab.com에서 이 작업을 수행할 수 있습니다.

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

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

GitLab 15.5에서 도입.
GitLab 15.5에서 일반적으로 사용 가능합니다. 러너 찾기 모든 가능성 플래그 runners_finder_all_available이 제거되었습니다.

디렉터리에 모든 러너를 표시하거나 인스턴스나 다른 그룹에서 상속된 것만 표시할 수 있습니다.

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

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

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

그룹 러너 일시 정지 또는 다시 시작

전제 조건:

그룹의 관리자이거나 Owner 역할을 가져야 합니다.

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

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

그룹 러너 삭제

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

전제 조건:

그룹의 관리자이거나 Owner 역할을 가져야 합니다.

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

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

왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
빌드 > 러너를 선택합니다.
검색란에 러너 설명을 입력하거나 러너 디렉터리을 필터링합니다.
그룹 러너 삭제:
- 개별 러너를 삭제하려면 러너 옆에 러너 삭제()를 선택합니다.
- 여러 인스턴스 러너를 삭제하려면 각 러너의 확인란을 선택하고 선택 삭제를 선택합니다.
- 모든 러너를 삭제하려면 디렉터리 상단의 확인란을 선택하고 선택 삭제를 선택합니다.
러너 영구적으로 삭제를 선택합니다.

오래된 그룹 러너 정리

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

GitLab 15.1에서 도입되었습니다(https://gitlab.com/gitlab-org/gitlab/-/issues/363012).

전제 조건:

그룹의 Owner 역할을 가져야 합니다.

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

그룹 러너는 그룹 수준에서 생성된 러너입니다.

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

오래된 그룹 러너 정리 로그 보기

정리 결과를 보려면 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 활동이 많은 프로젝트와 같은 특수한 요구 사항이 있는 작업에 프로젝트 러너를 사용할 수 있습니다.

프로젝트 러너는 여러 프로젝트에서 사용되도록 설정할 수 있습니다. 프로젝트 러너는 수행 작업을 사용하여 작업을 처리합니다.

포크된 프로젝트에서 프로젝트 러너가 자동으로 가져오지 않습니다. 포크는 복제된 리포지터리의 CI/CD 설정을 복사합니다.

러너 인증 토큰을 사용하여 프로젝트 러너 생성

GitLab 15.10에서 도입.
create_runner_workflow_for_namespace 플래그로 배포되었습니다. 기본적으로 비활성화됨.
GitLab 16.0에서 기본적으로 활성화됨.
GitLab 16.2에서 일반적으로 사용 가능합니다. 피처 플래그 create_runner_workflow_for_admin이 제거되었습니다.

전제 조건:

프로젝트의 Maintainer 역할을 가져야 합니다.

자체 호스팅 GitLab 인스턴스 또는 GitLab.com에서 프로젝트 러너를 만들 수 있습니다. 러너를 만들면 러너 인증 토큰이 할당되며, 이 토큰을 사용하여 러너를 등록할 수 있습니다. 러너는 작업 대기열에서 작업을 가져올 때 GitLab과 인증하는 데 이 토큰을 사용합니다.

프로젝트 러너를 만들려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
설정 > CI/CD를 선택합니다.
러너(runner) 섹션을 확장하세요.
새 프로젝트 러너를 선택합니다.
GitLab Runner가 설치된 운영 체제를 선택합니다.
태그 섹션에서 태그 필드에 러너가 실행할 작업 태그를 입력합니다. 이 러너를 위해 작업 태그가 없다면 태그 없는 작업 실행을 선택합니다.
선택 사항. 러너 설명 필드에 GitLab에서 표시되는 러너에 대한 설명을 추가합니다.
선택 사항. 구성 섹션에서 추가 구성을 추가합니다.
러너 만들기를 선택합니다.
명령줄에서 러너를 등록하는 화면에 따라 진행합니다. 명령행에서 프롬프트가 표시되면:
- GitLab 인스턴스 URL에는 GitLab 인스턴스의 URL을 사용합니다. 예: 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되는 경우, GitLab 인스턴스 URL은 https://gitlab.example.com입니다.
- executor에는 executor의 유형을 입력합니다. Executor는 러너가 작업을 수행하는 환경입니다.

러너를 만드는 데 API를 사용할 수도 있습니다.

러너(runner) 인증 토큰은 등록 동안에만 UI에 표시됩니다.

프로젝트 러너 생성 및 등록 토큰 (레거시)

러너(runner) 등록 토큰 전달 능력 및 특정 구성 인수 지원은 GitLab 15.6에서 레거시 처리되었으며 GitLab 18.0에서 제거될 예정입니다. 러너 인증 토큰을 대신 사용해야 합니다. 자세한 내용은 새로운 러너 등록 작업 흐름으로 이관을 참조하십시오.

필수 조건:

러너 등록 토큰은 상위 그룹에서 활성화되어야 합니다.
프로젝트의 유지보수자 역할이 있어야 합니다.

프로젝트 러너 생성 방법:

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

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

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

필수 조건:

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

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

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

프로젝트 러너 삭제

필수 조건:

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

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

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

다른 프로젝트에 프로젝트 러너 활성화

프로젝트 러너를 생성한 후 다른 프로젝트에서 사용할 수 있습니다.

필수 조건: 이미 해당 러너가 활성화된 프로젝트의 유지보수자 역할이 있어야 합니다. - 해당 러너를 활성화하려는 프로젝트의 유지보수자 역할이 있어야 합니다. - 프로젝트 러너가 잠겨 있어서는 안 됩니다.

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

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

해당 프로젝트에서 러너를 편집할 수 있습니다. 수정 사항은 러너를 사용하는 모든 프로젝트에 영향을 미칩니다.

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

다른 프로젝트에 프로젝트 러너 활성화 방지

프로젝트 러너를 “잠그고” 다른 프로젝트에서 활성화할 수 없도록 구성할 수 있습니다. 이 설정은 러너를 등록하는 경우에 활성화할 수 있지만, 나중에 변경할 수도 있습니다.

러너를 잠금 또는 잠금 해제하려면:

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

러너 상태

러너는 다음과 같은 상태를 가질 수 있습니다.

상태	설명
`온라인`	러너가 지난 2시간 이내에 GitLab과 연락하여 작업을 실행할 수 있습니다.
`오프라인`	러너가 2시간 이상 GitLab과 연락하지 않았으며 작업을 실행할 수 없습니다. 러너를 온라인으로 변경할 수 있는지 확인합니다.
`만료`	러너가 3개월 이상 GitLab과 연락하지 않았습니다. 러너가 3개월 이상 전에 만들어졌지만 인스턴스로 연락하지 않았으면 만료로 간주됩니다.
`절대 연락 없음`	러너가 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 버전 낮기 때문에 일부 기능을 사용할 수 없거나 제대로 작동하지 않을 수 있습니다.
- 이전 버전 - 가능: 새로운 버전이 있지만 업그레이드가 필수적이지 않습니다.
상태로 디렉터리을 필터링하여 개별 러너 중 어떤 것을 업그레이드해야 하는지 보기.

Runner의 IP 주소 결정

중요도: 낮음

Runner의 IP 주소를 알면 해당 Runner에 대한 문제 해결에 도움이 될 수 있습니다. GitLab은 작업을 폴링할 때 GitLab에 대한 HTTP 요청의 소스를 확인하여 IP 주소를 저장하고 표시합니다. IP 주소는 항상 최신 상태로 유지되므로 Runner IP가 변경되면 GitLab에서 자동으로 업데이트됩니다.

인스턴스 Runner 및 프로젝트 Runner의 IP 주소를 다른 위치에서 찾을 수 있습니다.

인스턴스 Runner의 IP 주소 결정

전제 조건:

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

인스턴스 Runner의 IP 주소를 결정하려면:

왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
CI/CD > Runners를 선택합니다.
테이블에서 Runner를 찾아 IP 주소 열을 확인합니다.

프로젝트 Runner의 IP 주소 결정

프로젝트의 Runner IP 주소를 찾으려면 해당 프로젝트의 소유자 역할이어야 합니다.

프로젝트의 설정 > CI/CD로 이동하고 Runners 섹션을 확장합니다.
Runner 이름을 선택하고 IP 주소 행을 찾습니다.

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

GitLab 16.11에 도입됨

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

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

전제 조건:

관리 영역에서 Runner 등록 토큰을 활성화해야 합니다.

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

러너 관리

인스턴스 러너

인스턴스 러너를 러너 인증 토큰과 함께 생성

등록 토큰을 사용하여 인스턴스 러너 생성 (불추천)

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

인스턴스 러너 삭제

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

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

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

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

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

그룹 러너

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

등록 토큰으로 그룹 러너 생성(폐기됨)

그룹 러너 보기

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

그룹 러너 일시 정지 또는 다시 시작

그룹 러너 삭제

오래된 그룹 러너 정리

오래된 그룹 러너 정리 로그 보기

프로젝트 러너

러너 인증 토큰을 사용하여 프로젝트 러너 생성

프로젝트 러너 생성 및 등록 토큰 (레거시)

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

프로젝트 러너 삭제

다른 프로젝트에 프로젝트 러너 활성화

다른 프로젝트에 프로젝트 러너 활성화 방지

러너 상태

러너 성능에 대한 통계 보기

업그레이드해야 할 러너 확인

Runner의 IP 주소 결정

인스턴스 Runner의 IP 주소 결정

프로젝트 Runner의 IP 주소 결정

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

도움말

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

도움받기