• 인스턴스 러너
  • 러너 인증 토큰으로 인스턴스 러너 만들기
  • 러너 등록 토큰을 사용하여 인스턴스 러너 만들기 (사용 중단됨)
  • 인스턴스 러너 일시 중지 또는 재개
  • 인스턴스 러너 삭제
• 프로젝트용 인스턴스 러너 활성화
• 그룹용 인스턴스 러너 활성화
  • 프로젝트용 인스턴스 러너 비활성화
  • 그룹용 인스턴스 러너 비활성화
  • 인스턴스 러너가 작업을 선택하는 방법
• 그룹 러너
  • 러너 인증 토큰을 사용하여 그룹 러너 만들기
  • 그룹 러너 등록 토큰으로 그룹 러너 만들기(폐기됨)
  • 그룹 러너 보기
    • 그룹 러너 필터링하여 상속된 것만 표시
  • 그룹 러너 일시 중지 또는 재개
  • 그룹 러너 삭제
  • 사용되지 않는 그룹 러너 정리
    • 사용되지 않는 그룹 러너 정리 로그 보기
• 프로젝트 러너
  • 러너 인증 토큰을 사용하여 프로젝트 러너 생성
  • 러너 등록 토큰을 사용하여 프로젝트 러너 생성(사용 중지됨)
  • 프로젝트 러너 일시 중지 또는 재개
  • 프로젝트 러너 삭제
  • 다른 프로젝트를 위한 프로젝트 러너 활성화
  • 다른 프로젝트를 위한 프로젝트 러너 활성화 방지
• 러너 상태
• 러너 성능에 대한 통계 보기
• 업그레이드해야 하는 러너 결정
• 러너의 IP 주소 결정
  • 인스턴스 러너의 IP 주소 결정
  • 프로젝트 러너의 IP 주소 결정

러너 관리

GitLab 러너에는 원하는 사용자가 액세스할 수 있는 다음 유형의 러너가 있습니다.

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

인스턴스 러너

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

여러 작업이 유사한 요구 사항을 가질 때 인스턴스 러너를 사용합니다. 여러 프로젝트에 대기 중인 여러 러너 대신 몇 개의 러너가 여러 프로젝트를 처리할 수 있습니다.

만약 GitLab의 Self-managed 인스턴스를 사용 중이라면, 관리자는 다음을 수행할 수 있습니다:

• GitLab 러너 설치 및 인스턴스 러너 등록
• 각 그룹에 대한 인스턴스 러너 [컴퓨트 분] 설정을 설정합니다 (../pipelines/cicd_minutes.md#set-the-compute-quota-for-a-specific-namespace.md)

GitLab.com을 사용 중이라면: - GitLab이 관리하는 인스턴스 러너 디렉터리에서 선택할 수 있습니다. - 인스턴스 러너는 계정에 포함된 컴퓨트 분을 사용합니다.

러너 인증 토큰으로 인스턴스 러너 만들기

• GitLab 15.10에서 도입. create_runner_workflow_for_admin 플래그에 따라 배포됨
• GitLab 16.0에서 기본 설정으로 활성화.
• GitLab 16.2에서 일반 사용 가능. create_runner_workflow_for_admin feature flag 삭제됨.

사전 요구 사항:

• 관리자 여야 합니다.

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

인스턴스 러너를 만들려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리자 영역을 선택합니다.
2. CI/CD > 러너를 선택합니다.
3. 새 인스턴스 러너를 선택합니다.
4. GitLab 러너가 설치된 운영 체제를 선택합니다.
5. 태그 섹션에서 태그 필드에 러너가 실행할 작업을 지정하기 위한 작업 태그를 입력합니다. 이 러너에 대한 작업 태그가 없는 경우 태그 없는 것을 실행를 선택합니다.
6. 원하는 경우 러너 설명 필드에 GitLab에서 표시할 러너 설명을 입력합니다.
7. 원하는 경우 구성 섹션에 추가 구성을 추가합니다.
8. 러너 생성을 선택합니다.
9. 명령 줄에서 러너를 등록하는 지침에 따릅니다. 명령 줄에서 요청되면:
   • GitLab 인스턴스 URL에는 GitLab 인스턴스의 URL을 사용합니다. 예를 들어, 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되는 경우, GitLab 인스턴스 URL은 https://gitlab.example.com입니다.
   • executor에는 러너가 작업을 실행하는 환경인 executor 유형을 입력합니다.

API를 사용하여 러너를 만들 수도 있습니다.

러너 등록 토큰을 사용하여 인스턴스 러너 만들기 (사용 중단됨)

사전 요구 사항:

• 관리자 여야 합니다.

인스턴스 러너를 만들려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리자 영역을 선택합니다.
2. CI/CD > 러너를 선택합니다.
3. 인스턴스 러너 등록을 선택합니다.
4. 등록 토큰을 복사합니다.
5. 러너를 등록합니다.

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

사전 요구 사항:

• 관리자 여야 합니다.

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

1. 왼쪽 사이드바에서 맨 아래에서 관리자 영역을 선택합니다.
2. CI/CD > 러너를 선택합니다.
3. 검색 상자에 러너 설명을 입력하거나 러너 디렉터리을 필터링합니다.
4. 러너 디렉터리에서 러너의 오른쪽에:
   • 러너를 일시 중지하려면 일시 중지를 선택하세요 ().
   • 러너를 다시 시작하려면 재개를 선택하세요 ().

인스턴스 러너 삭제

사전 요구 사항:

• 관리자 여야 합니다.

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

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

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

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

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

GitLab의 Self-managed 인스턴스에서는 관리자가 새 프로젝트를 위해 이들을 활성화할 수 있습니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 설정 > CI/CD를 선택합니다.
3. 러너를 확장합니다.
4. 이 그룹의 인스턴스 러너 활성화 토글을 끕니다.
5. 선택 사항. 프로젝트나 하위 그룹이 설정을 재정의하도록 허용하려면 허용하여 프로젝트 및 하위 그룹이 그룹 설정을 재정의하도록 허용을 선택합니다.

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

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

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

예를 들어, 다음과 같이 작업이 대기 중인 경우:

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

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

1. 먼저 작업 1이 실행됩니다. 모든 프로젝트의 가장 적은 수의 실행 중인 작업(즉, 모든 프로젝트)에서 가장 낮은 작업 번호를 가지고 있기 때문입니다.
2. 다음은 작업 4입니다. 프로젝트 1에는 실행 중인 작업이 있기 때문에 이제 4가 다른 실행 중인 작업이 없는 프로젝트(프로젝트 1)와 비교하여 가장 낮은 작업 번호입니다.
3. 다음은 작업 6입니다. 프로젝트 1과 2에 실행 중인 작업이 있고, 이제 더 이상 실행 중인 작업이 없는 프로젝트(프로젝트 3)에서 가장 낮은 작업 번호입니다.
4. 다음은 작업 2입니다. 실행 중인 작업이 가장 적은 프로젝트(각각 1개)의 가장 낮은 작업 번호이기 때문입니다.
5. 다음은 작업 5입니다. 프로젝트 1에는 이제 2개의 실행 중인 작업이 있고, 작업 5는 프로젝트 2와 3 사이에서 가장 작은 남은 작업 번호입니다.
6. 마지막으로 작업 3이 선택됩니다… 남아 있는 작업이기 때문입니다.

한 번에 한 작업이 실행될 때, 공정한 사용 알고리즘은 다음과 같은 순서로 작업을 배정합니다:

1. 먼저 작업 1을 선택합니다. 모든 프로젝트(즉, 모든 프로젝트)에서 실행 중인 작업이 없는 가장 낮은 작업 번호를 가지고 있기 때문입니다.
2. 작업 1을 완료합니다.
3. 다음은 작업 2입니다. 작업 1이 완료되어 다시 모든 프로젝트에는 0개의 실행 중인 작업이 있으며, 2가 이용 가능한 가장 낮은 작업 번호이기 때문입니다.
4. 작업 4가 선택됩니다. 프로젝트 1에 작업이 실행 중이므로(작업 1을 향한), 실행 중인 작업이 없는 프로젝트(프로젝트 2와 3)에서 가장 낮은 번호입니다.
5. 작업 4를 완료합니다.
6. 다음은 작업 5입니다. 작업 4를 완료하여 프로젝트 2에서 다시 실행 중인 작업이 없습니다.
7. 다음은 작업 6입니다. 프로젝트 3은 실행 중인 작업이 없는 유일한 프로젝트입니다.
8. 마지막으로 작업 3이 선택됩니다… 남아 있는 작업이기 때문입니다.

그룹 러너

모든 프로젝트가 그룹 내에서 러너에 액세스해야 할 때 _그룹 러너_를 사용합니다.

그룹 러너는 먼저 들어온 작업부터 처리합니다.

러너 인증 토큰을 사용하여 그룹 러너 만들기

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

사전 요구 사항:

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

Self-managed GitLab 인스턴스나 GitLab.com에서 그룹 러너를 생성할 수 있습니다. 러너를 생성하면 해당 러너에 등록하는 데 사용되는 러너 인증 토큰이 할당됩니다. 러너는 작업 대기열에서 작업을 가져올 때 GitLab과 인증하기 위해 이 토큰을 사용합니다.

그룹 러너를 만들려면:

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

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

그룹 러너 등록 토큰으로 그룹 러너 만들기(폐기됨)

• GitLab 14.10에 도입, 경로가 설정 > CI/CD > 러너로 변경되었습니다.

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

그룹 러너 만들기:

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

대조적으로, 등록 토큰을 복사하고 러너를 등록하는 방법을 참조할 수 있습니다.

그룹 러너 보기

• 사용자는 Maintainer 역할로 그룹 러너를 볼 수 있습니다. GitLab 16.4에서 도입.

필수 컴포넌트:

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

그룹 및 해당 하위 그룹과 프로젝트에 대해 모든 러너를 볼 수 있습니다. 이를 Self-managed GitLab 인스턴스나 GitLab.com에서 할 수 있습니다.

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

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

• GitLab 15.5에 도입.
• GitLab 15.5에서 일반적으로 사용 가능. 피처 플래그 runners_finder_all_available이 제거되었음.

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

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

인스턴스에 사용 가능한 모든 러너를 표시하려면 인스턴스 러너 및 다른 그룹의 러너를 모두 표시합니다:

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

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

필수 컴포넌트:

• 그룹에 대한 관리자 또는 Owner 역할이 있어야 합니다.

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

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

그룹 러너 삭제

• 여러 개의 러너 삭제가 GitLab 15.6에 도입.

필수 컴포넌트:

• 그룹에 대한 관리자 또는 Owner 역할이 있어야 합니다.

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

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

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

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

• GitLab 15.1에 도입.

필수 컴포넌트:

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

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

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

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

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

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) 큐를 사용하여 작업을 처리합니다.

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

• GitLab 15.10에서 도입됨. 기본적으로 비활성화되며 create_runner_workflow_for_namespace 플래그를 통해 배포됩니다.
• GitLab 16.0에서 기본적으로 활성화됨.
• GitLab 16.2에서 일반적으로 사용 가능. 피처 플래그 create_runner_workflow_for_admin 제거됨.

전제 조건:

• 프로젝트의 Maintainer 역할이 있어야 합니다.

프로젝트 러너를 GitLab.com이나 Self-managed GitLab 인스턴스에 만들 수 있습니다. 러너를 만들면 러너를 등록하는 데 사용되는 러너 인증 토큰이 할당됩니다. 러너는 작업 대기열에서 작업을 가져올 때 GitLab에 대한 인증에 이 토큰을 사용합니다.

프로젝트 러너를 만들려면 다음을 수행합니다.

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
2. 설정 > CI/CD를 선택합니다.
3. Runners 섹션을 확장합니다.
4. 새로운 프로젝트 러너를 선택합니다.
5. GitLab 러너가 설치된 운영 체제를 선택합니다.
6. 태그 섹션에서 태그 필드에 러너가 실행할 작업을 지정하는 작업 태그를 입력합니다. 이 러너를 위해 작업 태그가 없는 경우 태그 없이 실행을 선택합니다.
7. 선택 사항. 러너 설명 필드에 GitLab에 표시되는 러너에 대한 설명을 추가합니다.
8. 선택 사항. 구성 섹션에서 추가 구성을 추가합니다.
9. 러너 만들기를 선택합니다.
10. 명령줄에서 러너를 등록하는 방법에 대한 화면의 지시에 따릅니다. 명령줄에서 프롬프트가 나타나면: - GitLab 인스턴스 URL에는 GitLab 인스턴스의 URL을 사용합니다. 예를 들어, 프로젝트가 gitlab.example.com/yourname/yourproject에 호스팅되는 경우 GitLab 인스턴스 URL은 https://gitlab.example.com입니다. - executor에는 러너가 작업을 실행하는 executor의 유형을 입력합니다.

러너를 만들기 위해 API를 사용할 수도 있습니다.

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

전제 조건:

• 프로젝트의 Maintainer 역할 이상이 있어야 합니다.

프로젝트 러너를 만들려면 다음을 수행합니다.

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

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

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

전제 조건:

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

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 러너를 사용할 프로젝트를 찾습니다.
2. 설정 > CI/CD를 선택합니다.
3. Runners를 확장합니다.
4. 할당된 프로젝트 러너 섹션에서 러너를 찾습니다.
5. 러너 오른쪽에서:
   • 러너를 일시 중지하려면 일시 중지를 선택하고 일시 중지를 선택합니다.
   • 러너를 재개하려면 재개를 선택하고 재개를 선택합니다.

프로젝트 러너 삭제

전제 조건:

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

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

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

다른 프로젝트를 위한 프로젝트 러너 활성화

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

필수 조건: 다음 중 적어도 Maintainer 역할이 있어야 합니다:

• 러너가 이미 활성화된 프로젝트.
• 러너를 활성화하려는 프로젝트.
• 프로젝트 러너는 잠금 상태여서는 안 됩니다.

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

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

가능한 모든 프로젝트 러너를 편집할 수 있습니다. 이로써 러너를 사용하는 모든 프로젝트에 영향을 미치는 수정 사항과 함께 태그 및 설명을 편집할 수 있습니다.

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

다른 프로젝트를 위한 프로젝트 러너 활성화 방지

프로젝트 러너를 다른 프로젝트에 활성화할 수 없도록 “잠금” 상태로 구성할 수 있습니다. 이 설정은 처음 러너를 등록할 때 활성화할 수 있지만, 나중에도 변경할 수 있습니다.

러너를 잠그거나 잠금을 해제하려면:

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

러너 상태

러너는 다음 상태 중 하나일 수 있습니다.

러너 성능에 대한 통계 보기

• GitLab 15.8에서 도입되었습니다.

관리자로서 러너 통계를 볼 수 있어 러너 플리트의 성능에 대해 알아볼 수 있습니다.

중위 작업 대기 시간(median job queued time) 값은 인스턴스 러너에서 실행된 최근 100개의 작업에 대한 대기 시간을 샘플링하여 계산됩니다. 최신 5000개의 러너에서 작업합니다.

중위는 50번째 백분위수에 해당하는 값으로, 대기 시간이 중위값보다 오래 대기하는 작업과 중위값보다 적게 대기하는 작업이 각각 절반입니다.

러너 통계를 보려면:

1. 왼쪽 사이드바에서 맨 아래쪽에 관리자 영역을 선택합니다.
2. CI/CD > 러너를 선택합니다.
3. 통계 보기를 선택합니다.

업그레이드해야 하는 러너 결정

• GitLab 15.3에서 도입되었습니다.

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

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

1. 러너 디렉터리을 보기:
   • 그룹에 대해:
     1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
     2. 빌드 > 러너를 선택합니다.
   • 인스턴스에 대해:
     1. 왼쪽 사이드바에서 맨 아래쪽에 관리자 영역을 선택합니다.
     2. CI/CD > 러너를 선택합니다.
2. 러너 디렉터리 상단에서 상태를 보기:
   • 최신 상태 아님 - 추천됨: 러너가 최신 패치 버전이 아니어서 보안 또는 고등도 위험한 버그에 취약할 수 있습니다. 또는, 러너가 GitLab 인스턴스보다 하나 이상의 메이저 버전이 뒤처져 있어서 일부 기능을 사용할 수 없거나 제대로 작동하지 않을 수 있습니다.
   • 최신 상태 아님 - 사용 가능: 최신 버전이 있지만 업그레이드가 긴급하지 않습니다.
3. 상태로 디렉터리 필터링하여 업그레이드해야 하는 개별 러너를 확인합니다.

러너의 IP 주소 결정

특정 러너의 문제 해결을 위해 러너의 IP 주소를 알아야 할 수 있습니다. GitLab은 작업을 위해 폴링할 때 GitLab에 대한 HTTP 요청의 소스를 보고 IP 주소를 저장하고 표시합니다. IP 주소는 항상 최신으로 유지되므로 러너 IP 주소가 변경되면 자동으로 GitLab에서 업데이트됩니다.

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

인스턴스 러너의 IP 주소 결정

필수 조건:

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

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

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

프로젝트 러너의 IP 주소 결정

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

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