• 조직 관리
• 프로젝트 관리
• 사용자 관리
  • 사용자 위임
  • 사용자 ID
  • 사용자 권한 내보내기
  • 사용자 통계
  • 사용자에게 이메일 추가
• 사용자 코호트
• 사용자가 최상위 그룹을 만드는 것 금지
• 그룹 관리
• 주제 관리
  • 모든 주제 보기
  • 주제 검색
  • 주제 만들기
  • 주제 편집
  • 주제 제거
  • 주제 Merge
• Gitaly 서버 관리
• CI/CD 섹션
  • Runner 관리
    • Runner 검색 및 필터
    • Runner 일괄 삭제
    • Runner 속성
  • 작업 관리
• 모니터링 섹션
  • 시스템 정보
  • 백그라운드 작업
  • 로그
  • 통계

GitLab 관리자 영역

관리자 영역은 GitLab Self-managed 인스턴스의 기능을 관리하고 구성할 수 있는 웹 UI를 제공합니다. 관리자인 경우 관리자 영역에 액세스하려면:

• GitLab 16.7 이상의 경우: 왼쪽 사이드바에서 아래쪽에서 관리자 영역을 선택합니다.
• GitLab 16.1 이상의 경우: 왼쪽 사이드바에서 검색 또는 이동을 선택한 후 관리자 영역을 선택합니다.
• GitLab 16.0 이하의 경우: 상단 바에서 메인 메뉴 > 관리를 선택합니다.

조직 관리

• GitLab 16.10에 도입되었습니다. ui_for_organizations라는 플래그로 비활성화됩니다.

플래그: Self-managed GitLab의 경우, 기본적으로 이 기능을 사용할 수 없습니다. 이 기능을 사용하려면 관리자가 ui_for_organizations이라는 피처 플래그를 활성화할 수 있습니다. GitLab.com 및 GitLab Dedicated의 경우, 이 기능을 사용할 수 없습니다. 이 기능은 운영 환경에 사용할 준비가 되지 않았습니다.

GitLab 인스턴스의 모든 조직을 관리자 영역의 조직 페이지에서 관리할 수 있습니다.

조직 페이지에 액세스하려면 다음 단계를 따르세요:

1. 왼쪽 사이드바에서 아래쪽에서 관리자 영역을 선택합니다.
2. 개요 > 조직을 선택합니다.

프로젝트 관리

GitLab 인스턴스의 모든 프로젝트를 관리자 영역의 프로젝트 페이지에서 관리할 수 있습니다.

프로젝트 페이지에 액세스하려면 다음 단계를 따르세요:

1. 왼쪽 사이드바에서 아래쪽에서 관리자 영역을 선택합니다.
2. 개요 > 프로젝트를 선택합니다.
3. 모두, 비공개, 내부, 또는 공개 탭을 선택하여 해당 기준의 프로젝트만 나열할 수 있습니다.

기본적으로 모든 프로젝트는 최근 업데이트된 시간의 역순으로 나열됩니다. 각 프로젝트에는 다음 정보가 나열됩니다:

• 이름
• 네임스페이스
• 설명
• 크기(최대 15분마다 업데이트됨)

프로젝트를 편집하거나 삭제할 수 있습니다.

프로젝트의 이름 또는 설명을 편집하려면:

1. 프로젝트 개요에서 편집하려는 프로젝트 옆에 편집을 선택합니다.
2. 프로젝트 이름 또는 프로젝트 설명을 편집합니다.
3. 변경 내용 저장을 선택합니다.

프로젝트를 삭제하려면:

1. 프로젝트 개요에서 삭제하려는 프로젝트 옆에 삭제를 선택합니다.

프로젝트 디렉터리을 다음 기준으로 정렬할 수 있습니다:

• 업데이트 날짜
• 마지막으로 생성된
• 이름
• 가장 많은 스타
• 가장 오래된 생성
• 가장 오래된 업데이트
• 가장 큰 리포지터리

사용자는 디렉터리에서 보관된 프로젝트를 숨기거나 표시할 수 있습니다.

이름별로 필터링 필드에 프로젝트 이름을 입력하고 GitLab은 입력하는 대로 필터링합니다.

해당 네임스페이스의 프로젝트만 필터링하려면 네임스페이스 드롭다운 디렉터리에서 선택하세요.

필터 옵션을 결합할 수 있습니다. 예를 들어 이름에 score가 포함된 공개 프로젝트만 나열하려면:

1. 공개 탭을 선택합니다.
2. 이름별로 필터링 텍스트 상자에 score를 입력합니다.

사용자 관리

GitLab 인스턴스의 모든 사용자를 관리자 영역의 사용자 페이지에서 관리할 수 있습니다:

1. 왼쪽 사이드바에서 아래쪽에서 관리자 영역을 선택합니다.
2. 개요 > 사용자를 선택합니다.

특정 기준과 일치하는 사용자를 나열하려면 사용자 페이지의 다음 탭 중 하나를 선택하세요:

• 활성
• 관리자
• 2단계 인증 활성화
• 2단계 인증 비활성화
• 외부
• 차단됨
• 비활성화됨
• 프로젝트 없음

각 사용자에 대해 다음이 디렉터리됩니다:

1. 사용자 이름
2. 이메일 주소
3. 프로젝트 멤버십 카운트
4. 그룹 멤버십 카운트 (GitLab 13.12에 도입)
5. 계정 생성 날짜
6. 마지막 활동 날짜

사용자를 편집하려면 사용자의 행에서 편집을 선택하세요. 사용자를 삭제하거나 사용자 및 해당 기여를 삭제하려면 해당 사용자의 행에서 톱니 바퀴 드롭다운 디렉터리을 선택하고 원하는 옵션을 선택하세요.

정렬 순서를 변경하려면:

1. 정렬 드롭다운 디렉터리을 선택하세요.
2. 원하는 순서를 선택하세요.

기본적으로 정렬 드롭다운 디렉터리에는 이름이 표시됩니다.

사용자를 검색하려면 검색 필드에 기준을 입력하세요. 사용자 검색은 대소문자를 구분하지 않으며 이름 및 사용자 이름에 대한 부분 일치를 적용합니다. 이메일 주소를 검색하려면 완전한 이메일 주소를 제공해야 합니다.

사용자 위임

관리자는 다른 관리자 포함 모든 다른 사용자를 “위임”할 수 있습니다. 이를 통해 관리자는 사용자가 본인이 보는 것을 “볼 수 있게”될 뿐만 아니라 사용자를 대신하여 조치를 취할 수 있습니다.

다음과 같은 방법으로 사용자를 위임할 수 있습니다:

• UI를 통해:
  1. 왼쪽 사이드바에서 아래쪽에서 관리자 영역을 선택합니다.
  2. 왼쪽 사이드바에서 개요 > 사용자를 선택합니다.
  3. 사용자 디렉터리에서 사용자를 선택합니다.
  4. 위임을 선택합니다.
• API 및 위임 토큰을 사용하여.

모든 사용자 위임 활동은 감사 이벤트로 기록됩니다. 기본적으로 사용자 위임이 활성화되어 있습니다. GitLab은 사용자 위임 비활성화하도록 구성할 수 있습니다.

사용자 ID

• 사용자의 SCIM ID를 볼 수 있는 기능이 GitLab 15.3에 도입되었습니다.

인증 제공자를 사용할 때, 관리자는 사용자의 ID를 볼 수 있습니다:

1. 왼쪽 사이드바에서 아래쪽에서 관리자 영역을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 사용자 디렉터리에서 사용자를 선택합니다.
4. ID를 선택합니다.

이 디렉터리은 사용자의 ID를 보여주며 SCIM ID를 포함합니다. 관리자는 문제 해결을 위해 이 정보를 사용하고 계정에 사용되는 ID를 확인할 수 있습니다.

사용자 권한 내보내기

• 소개됨 GitLab 13.8에서.
• 피처 플래그 제거됨 GitLab 13.9에서.

관리자는 관리 영역의 사용자 페이지에서 GitLab 인스턴스의 모든 사용자의 사용자 권한을 내보낼 수 있습니다. 내보내기에는 사용자가 그룹 및 프로젝트에서 바로 소속된 멤버십이 나열됩니다.

내보내기에는 다음 데이터가 포함됩니다:

• 사용자 이름
• 이메일
• 유형
• 경로
• 액세스 레벨(프로젝트 및 그룹)
• 마지막 활동 날짜(소개됨 GitLab 14.6에서). 이 열을 채우는 활동 디렉터리에 대해서는 Users API documentation을 참조하세요.

첫 100,000개의 사용자 계정만 내보냅니다.

사용자 통계

사용자 통계 페이지는 역할별 사용자 계정의 개요를 제공합니다. 이 통계는 매일 계산되므로 마지막 업데이트 이후에 이루어진 사용자 변경 사항은 반영되지 않습니다.

다음의 총계도 포함됩니다:

• 과금 가능한 사용자
• 차단된 사용자
• 전체 사용자

GitLab 청구는 과금 가능한 사용자 수에 기반합니다.

사용자에게 이메일 추가

사용자의 이메일을 매뉴얼으로 추가하려면 관리자 권한이 있어야 합니다:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 사용자를 찾아 선택합니다.
4. 편집을 선택합니다.
5. 이메일에 새 이메일 주소를 입력합니다. 이렇게 하면 새 이메일 주소가 사용자에게 추가되고 이전 이메일 주소는 보조 이메일로 설정됩니다.
6. 변경 사항 저장을 선택합니다.

사용자 코호트

Cohorts 탭은 새로운 사용자들의 월별 코호트와 시간에 따른 활동을 보여줍니다.

사용자가 최상위 그룹을 만드는 것 금지

기본적으로 사용자는 최상위 그룹을 만들 수 있습니다. 사용자가 최상위 그룹을 만드는 것을 방지하려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 사용자를 찾아 선택합니다.
4. 편집을 선택합니다.
5. 최상위 그룹 생성 허용 확인란을 선택 해제합니다.
6. 변경 사항 저장을 선택합니다.

그룹 내에서 하위 그룹을 만들 수 있는 권한을 제한하는 것도 가능합니다.

그룹 관리

관리자는 관리 영역의 그룹 페이지에서 GitLab 인스턴스의 모든 그룹을 관리할 수 있습니다.

그룹 페이지에 액세스하려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 그룹을 선택합니다.

각 그룹에 대해 해당 페이지에서 그룹의 이름, 설명, 크기, 그룹 내 프로젝트 수, 멤버 수, 그룹이 비공개, 내부 또는 공개인지 표시됩니다. 그룹을 편집하려면 그룹의 행에서 편집을 선택합니다. 그룹을 삭제하려면 그룹의 행에서 삭제를 선택합니다.

정렬 순서를 변경하려면 정렬 드롭다운 디렉터리을 선택하여 원하는 순서를 선택합니다. 기본 정렬 순서는 마지막으로 생성된 순서입니다.

그룹을 이름으로 검색하려면 검색 필드에 기준을 입력하세요. 그룹 검색은 대소문자를 구분하지 않으며 일부 일치합니다.

새 그룹을 만들려면 새 그룹을 선택하세요.

주제 관리

• 소개됨 GitLab 14.4에서.
• 주제 Merge은 GitLab 15.5에서 소개됨.

주제로 프로젝트를 분류하고 유사한 프로젝트를 찾을 수 있습니다.

모든 주제 보기

GitLab 인스턴스에서 모든 주제를 보려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 주제를 선택합니다.

각 주제에 대해 해당 페이지에서 주제의 이름과 해당 주제로 레이블이 지정된 프로젝트 수가 표시됩니다.

주제 검색

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 검색 상자에 검색 기준을 입력하세요. 주제 검색은 대소문자를 구분하지 않으며 일부 일치합니다.

주제 만들기

주제를 만들려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 새 주제를 선택합니다.
4. 주제 슬러그(이름) 및 주제 제목을 입력하세요.
5. 선택사항. 설명을 입력하고 주제 아바타를 추가하세요.
6. 변경 사항 저장을 선택하세요.

만든 주제는 주제 찾아보기 페이지에 표시됩니다.

주제 편집

언제든지 주제의 이름, 제목, 설명 및 아바타를 편집할 수 있습니다. 주제를 편집하려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 해당 주제 행에서 편집을 선택합니다.
4. 주제 슬러그(이름), 제목, 설명 또는 아바타를 편집합니다.
5. 변경 사항 저장을 선택합니다.

주제 제거

주제가 더 이상 필요하지 않은 경우 이를 영구적으로 제거할 수 있습니다. 주제를 제거하려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 해당 주제 행에서 제거를 선택합니다.

주제 Merge

특정 주제에 할당된 모든 프로젝트를 다른 주제로 이동할 수 있습니다. 소스 주제는 그 후 영구적으로 삭제됩니다. Merge된 주제를 삭제한 후에는 복원할 수 없습니다.

주제를 Merge하려면:

1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 주제 Merge을 선택합니다.
4. 소스 주제 드롭다운 디렉터리에서 Merge 및 제거하려는 주제를 선택합니다.
5. 대상 주제 드롭다운 디렉터리에서 소스 주제를 Merge할 대상 주제를 선택합니다.
6. Merge을 선택합니다.

Gitaly 서버 관리

관리 영역의 Gitaly 서버 페이지에서 GitLab 인스턴스의 모든 Gitaly 서버를 확인할 수 있습니다. 자세한 내용은 Gitaly를 참조하십시오.

Gitaly 서버 페이지에 액세스하려면:

1. 왼쪽 사이드바에서 아래쪽에 있는 관리 영역을 선택합니다.
2. 개요 > Gitaly 서버를 선택하십시오.

각 Gitaly 서버에는 다음과 같은 세부 정보가 표시됩니다:

CI/CD 섹션

Runner 관리

• GitLab 15.8에서 개요 > Runner에서 CI/CD > Runner로 이동되었습니다.

관리 영역의 Runner 페이지에서 GitLab 인스턴스의 모든 Runner를 관리할 수 있습니다. 자세한 내용은 GitLab Runner를 참조하십시오.

Runner 페이지에 액세스하려면:

1. 왼쪽 사이드바에서 아래쪽에 있는 관리 영역을 선택합니다.
2. 개요 > Runner를 선택하십시오.

Runner 검색 및 필터

Runner 설명을 검색하려면:

1. 검색 또는 결과 필터링 텍스트 상자에 찾으려는 Runner의 설명을 입력하십시오.
2. Enter 키를 눌러주십시오.

상태, 유형 및 태그로 Runner를 필터링할 수도 있습니다. 필터링하려면:

1. 탭을 선택하거나 검색 또는 결과 필터링 텍스트 상자를 선택하십시오.
2. 유형을 선택하거나 상태 또는 태그로 필터링하십시오.
3. 검색 기준을 선택하거나 입력하십시오.

Runner 일괄 삭제

• GitLab 15.5에서 도입되었습니다.
• GitLab 15.5에서 피처 플래그가 제거되었습니다.

한 번에 여러 Runner를 삭제할 수 있습니다.

1. 왼쪽 사이드바에서 아래쪽에 있는 관리 영역을 선택합니다.
2. 개요 > Runner를 선택하십시오.
3. 삭제하려는 Runner 왼쪽에 있는 확인란을 선택하십시오. 페이지의 모든 Runner를 선택하려면 디렉터리 위에 있는 확인란을 선택하십시오.
4. 선택한 항목 삭제를 선택하십시오.

Runner 속성

각 Runner에는 다음과 같은 속성이 표시됩니다:

또한 각 Runner를 편집, 일시 중지 또는 제거할 수도 있습니다.

작업 관리

• GitLab 15.8에서 개요 > Jobs에서 CI/CD > Jobs로 이동되었습니다.

관리 영역의 Jobs 페이지에서 GitLab 인스턴스의 모든 작업을 관리할 수 있습니다.

Jobs 페이지에 액세스하려면:

1. 왼쪽 사이드바에서 아래쪽에 있는 관리 영역을 선택합니다.
2. CI/CD > Jobs를 선택하십시오. 모든 작업이 작업 ID의 내림차순으로 나열됩니다.
3. 모두 탭을 선택하여 모든 작업을 나열하십시오. 대기중인, 실행 중인 또는 완료된 탭을 선택하여 해당 상태의 작업만 나열할 수 있습니다.

각 작업에는 다음과 같은 세부 정보가 표시됩니다:

모니터링 섹션

다음 주제에서는 관리 영역의 모니터링 섹션에 대해 다룹니다.

시스템 정보

• 상대 시간 지원이 GitLab 15.2에서 도입되었습니다. “Uptime” 통계가 “시스템 시작됨”으로 이름이 변경되었습니다.

시스템 정보 페이지에서 다음 통계를 제공합니다:

이러한 통계는 시스템 정보 페이지로 이동하거나 브라우저에서 페이지를 새로 고침할 때에만 업데이트됩니다.

백그라운드 작업

백그라운드 작업 페이지에는 Sidekiq 대시보드가 표시됩니다. GitLab은 백그라운드에서 처리를 수행하기 위해 Sidekiq를 사용합니다.

Sidekiq 대시보드에는 다음 요소가 포함되어 있습니다:

• 작업 상태별 탭.
• 백그라운드 작업 통계의 상세 분석.
• 선택 가능한 폴링 간격으로 처리된 및 실패한 작업의 실시간 그래프.
• 선택 가능한 시간 범위로 처리된 및 실패한 작업의 과거 그래프.
• 다음과 같은 Redis 통계:
  • 버전 번호
  • 일 누적 가동 시간
  • 연결 수
  • 현재 메모리 사용량(메가바이트 단위)
  • 최대 메모리 사용량(메가바이트 단위)

로그

GitLab 13.0부터 로그 보기가 관리자 영역 대시 보드에서 제거되었습니다. 로깅이 다중 노드 환경에서 작동하지 않으며 부분적인 정보를 표시하여 관리자들에게 혼란을 야기할 수 있기 때문입니다.

다중 노드 시스템의 경우 Elasticsearch 및 Splunk와 같은 서비스에 로그를 수집하는 것을 권장합니다.

이러한 로그 파일의 내용은 문제를 해결할 때 유용할 수 있습니다.

이벤트 관리

이벤트 감사 페이지는 GitLab 서버 내에서 수행된 변경 사항을 나열합니다. 이 정보를 통해 모든 변경을 제어, 분석 및 추적할 수 있습니다.

통계

대시보드의 인스턴스 개요 섹션은 GitLab 인스턴스의 현재 통계를 나열합니다. 이 정보는 애플리케이션 통계 API를 사용하여 검색됩니다.

.