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

• GitLab 18.5 이상:
  • 오른쪽 상단에서 Admin을 선택합니다.
  • 상단 막대에서 검색 또는 이동을 선택한 후 관리자 영역을 선택합니다.
• GitLab 17.3 이상: 왼쪽 사이드바 하단에서 Admin을 선택합니다.
• GitLab 16.7 이상: 왼쪽 사이드바 하단에서 관리자 영역을 선택합니다.
• GitLab 16.1 이상: 왼쪽 사이드바에서 검색 또는 이동을 선택한 후 Admin을 선택합니다.
• GitLab 16.0 이전: 상단 막대에서 메인 메뉴 > Admin을 선택합니다.

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

프로젝트 관리#

히스토리

• 새로운 디자인이 GitLab 18.2에서 admin_projects_vue라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.
• GitLab 18.3에서 일반적으로 사용 가능합니다. 기능 플래그 admin_projects_vue가 제거되었습니다.

GitLab 인스턴스의 모든 프로젝트를 관리하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.

2. 개요 > 프로젝트를 선택합니다. 페이지에는 각 프로젝트의 다음 항목이 표시됩니다:

   • 이름
   • 설명
   • 공개 범위 수준
   • 역할
   • 주제
   • 상태
   • 저장소 크기
   • 별 수
   • 포크 수
   • 병합 요청 수
   • 이슈 수

3. 선택 사항. 탭을 선택합니다:

   • 활성은 모든 활성 프로젝트를 표시합니다.
   • 비활성은 보관되었거나 삭제 대기 중인 프로젝트를 표시합니다.

4. 선택 사항. 필터를 조합하여 원하는 프로젝트를 찾습니다. 다음으로 필터링합니다:

   • 이름. 최소 세 글자를 입력해야 합니다.
   • 공개, 내부 또는 비공개 공개 범위.
   • 프로그래밍 언어.
   • 그룹 또는 사용자 네임스페이스.
   • 소유자 역할이 있는 프로젝트.

5. 선택 사항. 정렬 순서를 변경하려면 정렬 드롭다운 목록을 선택하고 원하는 순서를 선택합니다. 사용 가능한 정렬 옵션은 다음과 같습니다:

   • 이름
   • 생성 날짜
   • 업데이트 날짜
   • 별
   • 저장소 크기

프로젝트 편집#

관리자 영역의 프로젝트 페이지에서 프로젝트의 이름 또는 설명을 편집하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 프로젝트를 선택합니다.
3. 편집할 프로젝트를 찾아 작업 (⋮) > 편집을 선택합니다.
4. 프로젝트 이름 또는 프로젝트 설명을 편집합니다.
5. 변경 사항 저장을 선택합니다.

프로젝트 삭제#

프로젝트를 삭제하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 프로젝트를 선택합니다.
3. 편집할 프로젝트를 찾아 작업 (⋮) > 삭제를 선택합니다.
4. 확인 대화 상자에서 예, 프로젝트 삭제를 선택합니다.

사용자 관리#

히스토리

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

관리자 영역의 사용자 페이지는 각 사용자에 대해 다음 정보를 표시합니다:

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

관리자 영역의 사용자 페이지에서 모든 사용자를 관리하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.

2. 개요 > 사용자를 선택합니다.

3. 선택 사항. 기본값인 사용자 이름 순서로 된 정렬 순서를 변경하려면:

   1. 정렬 드롭다운 목록을 선택합니다.
   2. 원하는 순서를 선택합니다.

4. 선택 사항. 사용자 검색 상자를 사용하여 다음으로 사용자를 검색하고 필터링합니다:

   • 사용자 액세스 수준.
   • 이중 인증이 활성화 또는 비활성화되었는지 여부.
   • 사용자 상태.
   • 사용자 유형이 자리 표시자인지 여부.

5. 선택 사항. 사용자 검색 필드에 텍스트를 입력한 후 Enter를 누릅니다. 이 대소문자를 구분하지 않는 텍스트 검색은 이름, 사용자 이름 및 이메일에 부분 일치를 적용합니다.

사용자를 편집하려면 사용자의 행을 찾아 편집을 선택합니다.

사용자 삭제#

관리자 영역의 사용자 페이지에서 사용자를 삭제하거나 사용자와 해당 기여 항목을 삭제하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 삭제할 사용자를 찾습니다. 행에서 사용자 관리 (⋮)를 선택한 후 원하는 옵션을 선택합니다.

사용자 가장#

관리자는 다른 관리자를 포함한 모든 사용자를 가장할 수 있습니다. 이를 통해 GitLab에서 사용자가 보는 내용을 확인하고 사용자를 대신하여 작업을 수행할 수 있습니다.

사용자를 가장하려면:

• UI를 통해:
  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 개요 > 사용자를 선택합니다.
  3. 사용자 목록에서 사용자를 선택합니다.
  4. 오른쪽 상단에서 가장을 선택합니다.
  5. 가장을 중단하려면 오른쪽 상단에서 가장 중단 ([incognito])을 선택합니다.
• 가장 토큰을 사용하여 API를 통해.

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

사용자 ID#

히스토리

• 사용자의 SCIM ID 보기가 GitLab 15.3에서 도입되었습니다.

인증 공급자를 사용할 때 관리자는 사용자의 ID를 볼 수 있습니다. 이 페이지는 SCIM ID를 포함한 사용자의 ID를 표시합니다. 이 정보를 사용하여 SCIM 관련 문제를 해결하고 계정에 사용되는 ID를 확인합니다.

이를 위해:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 사용자 목록에서 사용자를 선택합니다.
4. ID를 선택합니다.

사용자 권한 내보내기#

사용자 권한을 내보내면 내보낸 정보에는 사용자가 그룹 및 프로젝트에서 가지고 있는 직접 멤버십이 표시됩니다. 처음 100,000명의 사용자로 제한되며 다음 데이터를 포함합니다:

• 사용자 이름
• 이메일
• 유형
• 경로
• 액세스 수준(프로젝트 및 그룹)
• 마지막 활동 날짜. 이 열을 채우는 활동 목록은 사용자 API 문서를 참조하세요.

GitLab 인스턴스의 모든 활성 사용자에 대한 사용자 권한을 내보내려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 오른쪽 상단에서 CSV로 권한 내보내기 ([export])를 선택합니다.

사용자 통계#

사용자 통계 페이지는 역할별 사용자 계정 개요를 제공합니다. 이 통계는 매일 계산됩니다. 마지막 업데이트 후 변경된 사용자는 반영되지 않습니다. 다음 합계도 포함됩니다:

• 청구 가능 사용자
• 차단된 사용자
• 전체 사용자

GitLab 청구는 청구 가능 사용자 수를 기반으로 합니다.

사용자에게 이메일 추가#

사용자 계정에 수동으로 이메일 주소를 추가하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 사용자를 찾아 선택합니다.
4. 편집을 선택합니다.
5. 이메일에 새 이메일 주소를 입력합니다. 이렇게 하면 새 이메일 주소가 사용자에게 추가되고 이전 이메일 주소가 보조 이메일로 설정됩니다.
6. 변경 사항 저장을 선택합니다.

사용자 코호트#

코호트 탭은 신규 사용자의 월별 코호트와 시간에 따른 활동을 표시합니다.

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

관리자는 특정 사용자가 최상위 그룹을 생성하지 못하도록 방지할 수 있습니다. 이러한 사용자는 여전히 하위 그룹을 생성하고 기존 조직 구조에서 협업할 수 있습니다.

사용자가 최상위 그룹을 생성하지 못하도록 방지하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 사용자를 선택합니다.
3. 사용자를 찾아 선택합니다.
4. 편집을 선택합니다.
5. 최상위 그룹 생성 가능 체크박스를 해제합니다.
6. 변경 사항 저장을 선택합니다.

이 설정을 비활성화하면:

• 사용자는 최상위 그룹을 생성할 수 없습니다.
• 사용자는 그룹의 하위 그룹 생성 권한에 따라 관리자 또는 소유자 역할이 있는 그룹에서 하위 그룹을 생성할 수 있습니다.

그룹 관리#

히스토리

• 새로운 디자인이 GitLab 18.2에서 admin_groups_vue라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.
• GitLab 18.5에서 GitLab.com, GitLab Self-Managed 및 GitLab Dedicated에서 활성화되었습니다.
• GitLab 18.6에서 일반적으로 사용 가능합니다. 기능 플래그 admin_groups_vue가 제거되었습니다.

GitLab 인스턴스의 모든 그룹을 관리하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.

2. 개요 > 그룹을 선택합니다. 페이지에는 각 그룹의 다음 항목이 표시됩니다:

   • 이름
   • 설명
   • 공개 범위 수준
   • 역할
   • 상태
   • 저장소 크기
   • 하위 그룹 수
   • 프로젝트 수
   • 멤버 수

3. 선택 사항. 탭을 선택합니다:

   • 활성은 모든 활성 그룹을 표시합니다.
   • 비활성은 삭제 대기 중인 그룹을 표시합니다.

4. 선택 사항. 정렬 순서를 변경하려면 정렬 드롭다운 목록을 선택하고 원하는 순서를 선택합니다. 사용 가능한 정렬 옵션은 다음과 같습니다:

   • 이름
   • 생성 날짜
   • 업데이트 날짜
   • 저장소 크기

5. 선택 사항. 이름으로 그룹을 필터링하려면 검색 막대에 최소 세 글자를 입력합니다.

6. 선택 사항. 새 그룹 생성을 선택합니다.

그룹 편집#

관리자 영역의 그룹 페이지에서 그룹의 이름 또는 설명을 편집하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 그룹을 선택합니다.
3. 편집할 그룹을 찾아 작업 (⋮) > 편집을 선택합니다.
4. 그룹 이름 또는 그룹 설명을 편집합니다.
5. 변경 사항 저장을 선택합니다.

그룹 삭제#

그룹을 삭제하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 그룹을 선택합니다.
3. 편집할 그룹을 찾아 작업 (⋮) > 삭제를 선택합니다.
4. 확인 대화 상자에서 확인을 선택합니다.

주제 관리#

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

모든 주제 보기#

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

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 주제를 선택합니다.

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

주제 검색#

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 검색 상자에 검색 기준을 입력합니다. 주제 검색은 대소문자를 구분하지 않으며 부분 일치를 적용합니다.

주제 만들기#

주제를 만들려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 새 주제를 선택합니다.
4. 주제 슬러그(이름) 및 주제 제목을 입력합니다.
5. 선택 사항. 설명을 입력하고 주제 아바타를 추가합니다.
6. 변경 사항 저장을 선택합니다.

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

할당된 주제는 프로젝트에 액세스할 수 있는 모든 사람에게만 표시되지만 GitLab 인스턴스에 어떤 주제가 있는지는 모든 사람이 볼 수 있습니다. 주제 이름에 민감한 정보를 포함하지 마세요.

주제 편집#

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

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 해당 주제의 행에서 편집을 선택합니다.
4. 주제 슬러그(이름), 제목, 설명 또는 아바타를 편집합니다.
5. 변경 사항 저장을 선택합니다.

주제 제거#

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

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 해당 주제의 행에서 제거를 선택합니다.

주제 병합#

모든 프로젝트를 한 주제에서 다른 주제로 이동할 수 있습니다. 그러면 원본 주제는 영구적으로 삭제됩니다. 병합된 주제가 삭제된 후에는 복원할 수 없습니다.

주제를 병합하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 주제 병합을 선택합니다.
4. 소스 주제 드롭다운 목록에서 병합하고 제거할 주제를 선택합니다.
5. 대상 주제 드롭다운 목록에서 소스 주제를 병합할 주제를 선택합니다.
6. 병합을 선택합니다.

Gitaly 서버 관리#

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

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

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > Gitaly 서버를 선택합니다.

페이지에는 각 Gitaly 서버에 대한 다음 정보가 포함됩니다:

조직 관리#

히스토리

• GitLab 16.10에서 ui_for_organizations라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.

관리자 영역의 조직 페이지는 기본적으로 마지막으로 업데이트된 역순으로 모든 프로젝트를 나열합니다. 각 프로젝트에는 다음이 표시됩니다:

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

이 페이지에서 GitLab 인스턴스의 모든 조직을 관리하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 조직을 선택합니다.

CI/CD 섹션#

러너 관리#

히스토리

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

GitLab 인스턴스의 모든 러너를 관리하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. CI/CD > 러너를 선택합니다.

각 러너에 대해 다음 정보가 표시됩니다:

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

자세한 내용은 GitLab Runner를 참조하세요.

러너 검색 및 필터링#

러너의 설명을 검색하려면:

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

상태, 유형 및 태그로 러너를 필터링하려면:

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

러너 일괄 삭제#

히스토리

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

여러 러너를 동시에 삭제하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 개요 > 러너를 선택합니다.
3. 삭제할 러너 왼쪽에서 체크박스를 선택합니다. 페이지의 모든 러너를 선택하려면 목록 위의 체크박스를 선택합니다.
4. 선택 항목 삭제를 선택합니다.

작업 관리#

히스토리

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

GitLab 인스턴스의 모든 작업을 관리하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. CI/CD > 작업을 선택합니다. 모든 작업이 작업 ID의 내림차순으로 나열됩니다.
3. 모든 작업을 나열하려면 전체 탭을 선택합니다. 해당 상태의 작업만 나열하려면 대기 중, 실행 중 또는 완료 탭을 선택합니다.

각 작업에 대해 다음 세부 정보가 나열됩니다:

모니터링 섹션#

다음 주제에서는 관리자 영역의 모니터링 섹션을 설명합니다.

시스템 정보#

히스토리

• GitLab 15.2에서 상대적 시간 지원이 도입되었습니다. "업타임" 통계가 "시스템 시작"으로 이름이 변경되었습니다.

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

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

백그라운드 작업#

백그라운드 작업 페이지는 Sidekiq 대시보드를 표시합니다. Sidekiq는 GitLab에서 백그라운드 프로세스를 수행하는 데 사용됩니다.

Sidekiq 대시보드에는 다음이 포함됩니다:

• 각 작업의 라이프사이클 상태에 대한 탭.
• 백그라운드 작업 통계 분석.
• 선택 가능한 폴링 간격이 있는 처리됨 및 실패 작업의 실시간 그래프.
• 선택 가능한 시간 범위가 있는 처리됨 및 실패 작업의 히스토리 그래프.
• 다음을 포함한 Redis 통계:
  • 버전 번호
  • 일 단위로 측정된 업타임
  • 연결 수
  • MB 단위로 측정된 현재 메모리 사용량
  • MB 단위로 측정된 최대 메모리 사용량

데이터 관리#

히스토리

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

데이터 관리 페이지는 Geo 기본 사이트의 모든 구성 요소에 걸쳐 검증 상태를 보고 관리하는 포괄적인 인터페이스를 제공합니다. 구성 요소에는 Geo에서 지원하는 모든 데이터 유형이 포함됩니다.

이 페이지를 사용하여:

• Rails 콘솔 액세스 없이 검증 실패를 유발하는 고아 파일이나 데이터베이스 레코드를 식별합니다.
• UI에서 직접 자세한 오류 정보를 보고 수정 작업을 수행합니다.
• 모든 구성 요소의 검증 상태를 추적하고 실패 패턴을 식별합니다.
• 한 번에 모든 객체에 대한 체크섬 계산을 트리거합니다.

목록 보기는 선택한 구성 요소의 검증 상태를 표시합니다.

1. 드롭다운 목록에서 구성 요소를 선택하여 다른 검증 모델(프로젝트, 업로드 등) 간에 전환합니다. 목록 보기에서 다음을 수행할 수 있습니다:

   • 체크섬 상태(실패, 대기 중, 성공)로 객체를 필터링합니다.
   • 대용량 결과 세트를 탐색합니다.
   • 각 객체의 마지막 체크섬 시간, 마지막 실패 시간 및 실패 원인을 봅니다.
   • 개별 객체에 대한 체크섬 계산을 트리거합니다.

2. 목록 보기에서 개별 모델을 선택하여 특정 객체의 검증 상태에 대한 포괄적인 정보를 확인합니다:

   • 검증된 객체에 대한 세부 정보.
   • 현재 체크섬 상태 및 기록.
   • 검증이 실패한 경우 자세한 실패 원인.
   • 객체의 체크섬을 다시 계산하는 옵션.

데이터베이스 진단#

히스토리

• 대조 상태 검사가 GitLab 18.3에서 도입되었습니다.
• 스키마 상태 검사가 GitLab 18.3에서 누락된 인덱스, 테이블, 외래 키 및 시퀀스 검사와 함께 도입되었습니다.
• 잘못된 시퀀스 소유자 검사가 GitLab 18.4에서 스키마 상태 검사에 추가되었습니다.

데이터베이스 진단 페이지는 데이터베이스의 일반적인 문제를 표시하는 여러 검사로 구성됩니다:

• PostgreSQL 대조 변경으로 인한 인덱스 손상
• 스키마 불일치

각 검사를 실행하려면 검사의 실행 버튼을 선택합니다. 실행 버튼을 선택하면 검사 정보를 페이지에 보고하는 백그라운드 작업이 예약됩니다.

대조 상태 검사#

대조 상태 검사는 손상된 인덱스를 유발하는 PostgreSQL 문제를 감지하려고 합니다. 이는 일반적으로 PostgreSQL을 실행한 이전 운영 체제가 버전 2.28 이전의 glibc 버전을 사용한 경우에 발생합니다. 자세한 내용은 PostgreSQL의 운영 체제 업그레이드에 대한 문서를 참조하세요.

모든 문제는 손상된 인덱스 섹션에 나열됩니다. 문제가 있는 경우 손상된 인덱스를 복구할 수 있습니다.

대조 상태 검사는 일반적으로 영향을 받는 테이블의 중복도 표시하려고 합니다:

• ci_refs
• ci_resource_groups
• environments
• merge_request_diff_commit_users
• sbom_components
• tags
• topics

자세한 내용은 이슈 505982를 참조하세요.

대시보드는 gitlab:db:collation_checker Rake 작업에 표시된 동일한 정보를 나열합니다.

스키마 상태 검사#

스키마 상태 검사는 데이터베이스 상태를 대상 스키마와 비교하고 감지된 불일치를 나열합니다. 자동화된 스키마 복구 도구는 사용할 수 없습니다.

검사 결과에 오탐이 있거나 결과에 대한 질문이 있는 경우 피드백 이슈를 참조하세요.

로그#

이 로그 파일의 내용은 문제를 해결하는 데 도움이 될 수 있습니다. 각 로그 파일의 내용은 시간순으로 나열됩니다. 성능 문제를 최소화하기 위해 각 로그 파일의 최대 2000줄이 표시됩니다.

이러한 로그 파일 및 해당 내용에 대한 자세한 내용은 로그 시스템을 참조하세요.

로그 보기는 다중 노드 시스템의 관리자에게 혼란을 방지하기 위해 관리자 영역 대시보드에서 제거되었습니다. 이 보기는 다중 노드 설정에 대한 부분적인 정보만 표시합니다. 다중 노드 시스템의 경우 Elasticsearch 및 Splunk와 같은 서비스로 로그를 수집합니다.

감사 이벤트#

감사 이벤트 페이지는 GitLab 서버에 대한 변경 사항을 나열합니다. 이 정보를 사용하여 모든 변경 사항을 제어, 분석 및 추적합니다.

통계#

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

이 통계는 10,000 미만의 값에 대해 정확한 수를 표시합니다. 10,000 이상의 값에 대해 계산에 TablesampleCountStrategy 및 ReltuplesCountStrategy 전략이 사용될 때 이 통계는 대략적인 데이터를 표시합니다.