• 조직 관리
• 프로젝트 관리
• 사용자 관리
  • 사용자 표현권
  • 사용자 신원
  • 사용자 권한 내보내기
  • 사용자 통계
  • 사용자 이메일 추가
• 사용자 그룹
• 사용자의 최상위 그룹 생성 방지
• 그룹 관리
• 주제 관리
  • 모든 주제 보기
  • 주제 검색
  • 주제 생성
  • 주제 편집
  • 주제 삭제
  • 주제 Merge
• Gitaly 서버 관리
• CI/CD 섹션
  • Runner 관리
    • 러너(runner) 검색 및 필터링
    • 러너 일괄 삭제
    • 러너 속성
  • 작업 관리
• 모니터링 섹션
  • 시스템 정보
  • 백그라운드 작업
  • 로그
  • 감사 이벤트
  • 통계

GitLab 관리자 영역

관리자 영역은 GitLab의 Self-Managed형 인스턴스의 기능을 관리하고 구성하는 웹 UI를 제공합니다. 관리자인 경우 다음을 통해 관리자 영역에 액세스할 수 있습니다.

• GitLab 16.7 및 이후: 왼쪽 사이드바에서 하단에 관리자 영역(Admin Area)을 선택합니다.
• GitLab 16.1 및 이후: 왼쪽 사이드바에서 검색 또는 이동(Search or go to)을 선택한 다음 관리자 영역(Admin Area)을 선택합니다.
• GitLab 16.0 및 이전: 상단 바에서 Main menu > 관리(Admin)을 선택합니다.

GitLab 인스턴스가 관리자 모드를 사용하는 경우 관리자 영역 버튼이 표시되기 전에 세션의 관리자 모드를 활성화해야 합니다.

조직 관리

• GitLab 16.10에서 도입됨, ui_for_organizations이라는 플래그로 기본 설정은 비활성화되어 있습니다.

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

조직 페이지에 액세스하려면 다음을 수행합니다.

1. 왼쪽 사이드바에서 하단에 관리자 영역(Admin Area)을 선택합니다.
2. 개요(Overview) > 조직(Organizations)을 선택합니다.

프로젝트 관리

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

프로젝트 페이지에 액세스하려면 다음을 수행합니다.

1. 왼쪽 사이드바에서 하단에 관리자 영역(Admin Area)을 선택합니다.
2. 개요(Overview) > 프로젝트(Projects)를 선택합니다.
3. 모든(All), 비공개(Private), 내부(Internal) 또는 공개(Public) 탭을 선택하여 해당 기준의 프로젝트만 나열합니다.

기본적으로 모든 프로젝트가 마지막으로 업데이트된 순서대로 나열되며 각 프로젝트에는 다음과 같은 정보가 나열됩니다.

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

프로젝트의 이름 또는 설명을 편집하려면 다음을 수행합니다.

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

프로젝트를 삭제하려면 다음을 수행합니다.

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

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

• 업데이트된 날짜
• 최근 생성된
• 이름
• 가장 많이 별을 받은 순
• 가장 오래된 생성된
• 가장 오래된 업데이트된
• 가장 큰 리포지터리

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

이름으로 필터링하기란에 프로젝트 이름을 입력하고 GitLab이 입력하는대로 프로젝트를 필터링할 수 있습니다.

그 네임스페이스에서 만 프로젝트만 필터링하려면 네임스페이스 드롭다운 디렉터리에서 선택합니다.

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

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

사용자 관리

• 사용자 필터링 기능이 GitLab 17.0에서 도입되었습니다.

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

다음과 같은 기준으로 사용자를 검색 및 필터링할 수 있습니다.

• 사용자 액세스 수준
• 이중 인증이 활성화되었는지 여부
• 사용자 상태

텍스트 상자에 직접 텍스트를 입력할 수도 있습니다. 예를 들어, 특정 사용자의 이름을 입력합니다. 이 텍스트 검색은 대소문자를 구분하지 않으며 이름과 사용자 이름에 대해 부분 일치를 적용합니다. 이메일 주소를 검색하려면 완전한 이메일 주소를 제공해야 합니다.

각 사용자에 대해 다음이 나열됩니다.

• 사용자 이름
• 이메일 주소
• 프로젝트 멤버십 수
• 그룹 멤버십 수
• 계정 생성 날짜
• 최근 활동 날짜

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

정렬 순서를 변경하려면 다음을 수행합니다.

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

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

사용자 표현권

관리자는 다른 관리자를 포함한 다른 사용자를 “표현권”할 수 있습니다. 이를 통해 관리자는 사용자가 본 것을 “볼 수 있게” 하고 사용자를 대신하여 조치를 취할 수 있습니다. 사용자를 표현할 수 있는 방법은 다음과 같습니다.

• UI를 통해:
  1. 왼쪽 사이드바에서 하단에 관리자 영역(Admin Area)을 선택합니다.
  2. 왼쪽 사이드바에서 개요(Overview) > 사용자(Users)를 선택합니다.
  3. 사용자 디렉터리에서 사용자를 선택합니다.
  4. 표현권(Impersonate)을 선택합니다.
• API를 사용하여 표현 토큰을 사용합니다.

모든 표현 활동은 감사 이벤트와 함께 기록됩니다. 기본적으로 표현이 활성화되어 있습니다. GitLab은 표현을 사용하지 않도록 설정하도록 구성할 수 있습니다.

사용자 신원

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

인증 공급자를 사용할 때 관리자는 사용자의 신원을 볼 수 있습니다.

1. 왼쪽 사이드바에서 하단에 관리자 영역(Admin Area)을 선택합니다.
2. 개요(Overview) > 사용자(Users)를 선택합니다.
3. 사용자 디렉터리에서 사용자를 선택합니다.
4. 신원(Identities)을 선택합니다.

이 디렉터리에는 사용자의 신원과 SCIM 신원이 표시됩니다. 관리자는 이 정보를 사용하여 SCIM 관련 문제를 해결하고 계정에 사용되는 신원을 확인할 수 있습니다.

사용자 권한 내보내기

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

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

• 사용자 이름
• 이메일
• 유형
• 경로
• 액세스 수준(프로젝트 및 그룹)
• 마지막 활동 날짜. 이 열을 채우는 활동 디렉터리에 대한 자세한 내용은 사용자 API 문서를 참조하십시오.

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

사용자 통계

사용자 통계 페이지는 역할별로 사용자 계정을 개요로 제공합니다. 이러한 통계는 매일 계산되므로 마지막 업데이트 이후에 수행된 사용자 변경 사항은 반영되지 않습니다.

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

• 유료 사용자
• 차단된 사용자
• 총 사용자

GitLab 요금 청구는 유료 사용자 수에 따라 기준을 정합니다.

사용자 이메일 추가

사용자에게 매뉴얼으로 이메일을 추가하려면 관리자어야 합니다.

1. 왼쪽 사이드바에서 하단에 관리자 영역(Admin Area)을 선택합니다.
2. 개요(Overview) > 사용자(Users)를 선택합니다.
3. 사용자를 찾아 선택합니다.
4. 편집(Edit)을 선택합니다.
5. 이메일(Email)에 새 이메일 주소를 입력합니다. 이로써 이전 이메일 주소가 보조 이메일로 설정됩니다.
6. 변경 사항 저장을 선택합니다.

사용자 그룹

Cohorts 탭은 새 사용자들의 월별 그룹 및 그들의 활동을 시간별로 표시합니다.

사용자의 최상위 그룹 생성 방지

기본적으로 사용자는 최상위 그룹을 생성할 수 있습니다. 사용자가 최상위 그룹을 생성하지 못하도록하려면 다음 단계를 수행합니다.

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

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

그룹 관리

GitLab 인스턴스의 모든 그룹을 관리할 수 있습니다. 관리 영역의 그룹 페이지로 이동하여 사용합니다.

그룹 페이지에 액세스하는 방법은 다음과 같습니다.

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

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

정렬 순서를 변경하려면 정렬 드롭다운 디렉터리을 선택하고 원하는 순서를 선택합니다. 기본 정렬 순서는 마지막으로 만들어진 순서입니다.

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

새 그룹을 만들려면 새 그룹을 선택합니다.

주제 관리

• GitLab 15.5에서 도입됨 (주제 Merge).

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

모든 주제 보기

GitLab 인스턴스의 모든 주제를 보려면 다음을 수행합니다.

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

각 주제에 대해 페이지는 주제 이름과 해당 주제로 라벨이 지정된 프로젝트 수를 표시합니다.

주제 검색

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

주제 생성

주제를 생성하려면 다음을 수행합니다.

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

설정된 주제는 주제 탐색 페이지에 표시됩니다.

주제 편집

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

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

주제 삭제

주제가 필요 없어진 경우 영구적으로 제거할 수 있습니다. 주제를 제거하려면 다음을 수행합니다.

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

주제 Merge

주제에 할당된 모든 프로젝트를 다른 주제로 이동할 수 있습니다. 원본 주제는 그 후 영구적으로 삭제됩니다. 주제를 Merge하려면 다음을 수행합니다.

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

Gitaly 서버 관리

GitLab 인스턴스의 모든 Gitaly 서버를 Gitaly 서버 페이지에서 확인할 수 있습니다.

Gitaly 서버 페이지에 액세스하는 방법은 다음과 같습니다.

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

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

CI/CD 섹션

Runner 관리

• GitLab 15.8에서 개요 > Runners에서 CI/CD > Runners로 이동됨.

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

러너(runner) 페이지에 액세스하는 방법은 다음과 같습니다.

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

러너(runner) 검색 및 필터링

러너(runner) 설명을 검색하려면 다음을 수행합니다:

1. 검색 또는 결과 필터링 텍스트 상자에 찾으려는 러너의 설명을 입력합니다.
2. Enter를 누릅니다.

상태, 유형 및 태그로 러너를 필터링할 수도 있습니다. 필터링하려면 다음을 수행합니다:

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

러너 일괄 삭제

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

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

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

러너 속성

각 러너에 대해 다음과 같은 속성이 나열됩니다:

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

작업 관리

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

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

작업 페이지에 액세스하려면:

1. 좌측 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
2. CI/CD > 작업을 선택합니다. 모든 작업이 작업 ID의 내림차순으로 나열됩니다.
3. 모두 탭을 선택하여 모든 작업을 나열합니다. 보류 중, 실행 중, 또는 완료된 탭을 선택하여 해당 상태의 작업만 나열합니다.

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

모니터링 섹션

다음 항목은 관리 영역의 모니터링 섹션을 문서화합니다.

시스템 정보

• 상대적 시간을 지원하며, GitLab 15.2에서 “가동 시간(Uptime)” 통계가 “시스템 시작”으로 이름이 변경되었습니다.

시스템 정보 페이지에는 다음 통계가 제공됩니다:

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

백그라운드 작업

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

Sidekiq 대시보드에는 다음 요소가 포함됩니다:

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

로그

로그 뷰는 로깅이 멀티 노드 설정에서 작동하지 않고 부분 정보를 표시하여 관리자가 혼란스러워할 수 있기 때문에 관리 영역 대시보드에서 제거되었습니다.

멀티 노드 시스템의 경우 로그를 Elasticsearch 및 Splunk와 같은 서비스로 전달하는 것이 좋습니다.

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

이 로그 파일의 자세한 내용은 로그 시스템을 참조하십시오.

각 로그 파일의 내용이 시간 순서대로 나열됩니다. 성능 문제를 최소화하기 위해 각 로그 파일의 최대 2000줄이 표시됩니다.

감사 이벤트

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

통계

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