• 조직 관리
• 프로젝트 관리
• 사용자 관리
  • 사용자 위장
  • 사용자 신원
  • 사용자 권한 내보내기
  • 사용자 통계
  • 사용자에게 이메일 추가
• 사용자 코호트
• 사용자가 최상위 그룹을 만드는 것을 방지
• 그룹 관리
• 주제 관리
  • 모든 주제 보기
  • 주제 검색
  • 주제 생성
  • 주제 편집
  • 주제 제거
  • 주제 병합
• Gitaly 서버 관리
• CI/CD 섹션
  • 러너 관리
    • 러너 검색 및 필터링
    • 대량 삭제 러너
    • Runner 속성
  • 작업 관리
• 모니터링 섹션
  • 시스템 정보
  • 백그라운드 작업
  • 로그
  • 감사 이벤트
  • 통계

GitLab 관리 영역

관리 영역은 GitLab 셀프 매니지드 인스턴스의 기능을 관리하고 구성하기 위한 웹 UI를 제공합니다. 관리자인 경우, 관리 영역에 액세스하려면:

• GitLab 16.7 이상 버전: 왼쪽 사이드바 하단에서 관리 영역을 선택합니다.
• GitLab 16.1 이상 버전: 왼쪽 사이드바에서 검색 또는 이동을 선택한 후 관리 영역을 선택합니다.
• GitLab 16.0 및 이전 버전: 상단 바에서 주 메뉴 > 관리를 선택합니다.

참고: 관리자만 관리 영역에 액세스할 수 있습니다.

조직 관리

• GitLab 16.10에 이슈로 소개되었으며 ui_for_organizations라는 플래그와 함께합니다. 기본 설정으로 비활성화되어 있습니다.

플래그: 셀프 매니지드 GitLab에서는 기본적으로 이 기능을 사용할 수 없습니다. 이 기능을 사용하려면 관리자가 ui_for_organizations라는 플래그를 활성화할 수 있습니다. GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션용으로 준비되지 않았습니다.

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

조직 페이지에 액세스하려면:

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

프로젝트 관리

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

프로젝트 페이지에 액세스하려면:

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

기본적으로 모든 프로젝트가 마지막으로 업데이트된 날짜를 기준으로 역순으로 나열됩니다. 각 프로젝트에는 다음 정보가 표시됩니다:

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

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

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

프로젝트를 삭제하려면:

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

프로젝트 목록을 다음 기준으로 정렬할 수 있습니다:

• 업데이트된 날짜
• 마지막으로 생성된 날짜
• 이름
• 가장 많은 스타 수를 받은 순
• 가장 오래된 생성일
• 가장 오래된 업데이트일
• 가장 큰 저장소

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

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

해당 네임스페이스에 속한 프로젝트만 필터링하려면 네임스페이스 드롭다운 목록에서 선택하세요.

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

1. 퍼블릭 탭을 선택합니다.
2. 이름으로 필터링 텍스트 상자에 score를 입력합니다.

사용자 관리

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

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

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

• 활성
• 관리자
• 2FA 사용함
• 2FA 사용 안 함
• 외부
• 차단됨
• 비활성화됨
• 프로젝트 없음

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

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

사용자를 편집하려면 사용자의 행에서 편집을 선택하세요. 사용자를 삭제하거나 사용자와 그들의 기여를 삭제하려면 해당 사용자의 행에서 톱니바퀴 드롭다운 목록을 선택한 후 원하는 옵션을 선택하세요.

정렬 순서를 변경하려면:

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

기본적으로 정렬 드롭다운 목록에는 이름이 표시됩니다.

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

사용자 위장

관리자는 다른 관리자를 포함한 다른 사용자를 “위장”할 수 있습니다. 이를 통해 관리자는 해당 사용자가 본 것을 “볼 수 있게” 되며 해당 사용자를 대신하여 조치를 취할 수 있습니다. 다음과 같은 방법으로 사용자를 위장할 수 있습니다:

• UI를 통해:
  1. 왼쪽 사이드바 하단에서 관리 영역을 선택합니다.
  2. 왼쪽 사이드바에서 개요 > 사용자를 선택합니다.
  3. 사용자 목록에서 사용자를 선택합니다.
  4. 위장을 선택합니다.
• API를 사용하여 위장 토큰을 사용합니다.

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

사용자 신원

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

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

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

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

사용자 권한 내보내기

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

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

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

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

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

사용자 통계

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

다음 총계도 포함됩니다:

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

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

사용자에게 이메일 추가

사용자에게 수동으로 이메일을 추가하려면 관리자여야 합니다:

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

사용자 코호트

Cohorts 탭에는 월별 신규 사용자 및 그들의 활동을 표시합니다.

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

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

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

또한 어떤 역할이 그룹 내에서 하위 그룹을 만들 수 있는지 제한할 수도 있습니다.

그룹 관리

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

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

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

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

정렬 순서를 변경하려면 정렬 드롭다운 목록에서 원하는 순서를 선택합니다. 기본 정렬 순서는 마지막으로 생성된입니다.

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

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

주제 관리

• GitLab 14.4에서 도입되었습니다.
• 주제 병합은 GitLab 15.5에서 도입되었습니다.

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

모든 주제 보기

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

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

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

주제 검색

주제를 검색하려면:

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

주제 생성

주제를 생성하려면:

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

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

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

주제 편집

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

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

주제 제거

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

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

주제 병합

특정 주제에 할당된 모든 프로젝트를 다른 주제로 이동할 수 있습니다. 그럼으로써 기존 주제는 영구적으로 삭제됩니다. 병합된 주제를 삭제한 후에는 복구할 수 없습니다.

주제를 병합하려면:

1. 왼쪽 사이드바에서 아래쪽에 있는 관리 영역(Admin Area)을 선택합니다.
2. 개요 > 주제를 선택합니다.
3. 주제 병합(Merge topics)을 선택합니다.
4. 원본 주제(Source topic) 드롭다운 목록에서 병합하고 제거하려는 주제를 선택합니다.
5. 대상 주제(Target topic) 드롭다운 목록에서 원본 주제를 병합하려는 대상 주제를 선택합니다.
6. 병합(Merge)을 선택합니다.

Gitaly 서버 관리

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

Gitaly 서버 페이지에 앞서 설명한 Gitaly 서버의 자세한 정보가 나열됩니다.

필드	설명
저장소	저장소 저장소
주소	Gitaly 서버가 수신 대기하는 네트워크 주소
서버 버전	Gitaly 버전
Git 버전	Gitaly 서버에 설치된 Git의 버전
최신 버전	Gitaly 서버 버전이 최신 버전인지 나타냅니다. 녹색 점은 서버가 최신 상태임을 나타냅니다.

CI/CD 섹션

러너 관리

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

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

러너 페이지에 앞서 설명한 러너에 대한 정보가 나열됩니다.

러너 검색 및 필터링

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

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

또한 상태, 유형 및 태그로 러너를 필터링할 수 있습니다. 필터링하려면:

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

대량 삭제 러너

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

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

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

Runner 속성

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

속성	설명
Status	Runner의 상태입니다. GitLab 15.1 및 이후에서는 Ultimate 티어에 대해 업그레이드 상태를 확인할 수 있습니다.
Runner details	Runner에 대한 정보로, 부분 토큰 및 Runner가 등록된 컴퓨터에 대한 세부 정보가 포함됩니다.
Version	GitLab Runner 버전입니다.
Jobs	Runner가 실행한 작업의 총 수입니다.
Tags	Runner와 관련된 태그입니다.
Last contact	Runner가 마지막으로 GitLab 인스턴스에 연락한 시간을 나타내는 타임스탬프입니다.

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

작업 관리

• GitLab 15.8에서 개요 > 작업에서 CI/CD > 작업으로 이동.

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

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

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

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

필드	설명
Status	작업 상태로, passed, skipped, 또는 failed 중 하나입니다.
Job	작업, 브랜치, 작업을 시작한 커밋에 대한 링크가 포함되어 있습니다.
Pipeline	특정 파이프라인에 대한 링크가 포함되어 있습니다.
Project	작업이 속한 프로젝트 및 조직의 이름입니다.
Runner	작업을 실행할 CI Runner의 이름입니다.
Stage	.gitlab-ci.yml 파일에서 작업이 선언된 단계입니다.
Name	.gitlab-ci.yml 파일에서 지정한 작업의 이름입니다.
Timing	작업의 기간 및 작업이 완료된 시간으로 구성되어 있습니다.
Coverage	테스트 커버리지의 백분율입니다.

모니터링 섹션

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

시스템 정보

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

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

필드	설명
CPU	사용 가능한 CPU 코어 수
Memory Usage	사용 중인 메모리 및 총 메모리 사용량
Disk Usage	사용 중인 디스크 공간 및 총 디스크 공간 사용량
System started	GitLab을 호스팅하는 시스템이 시작된 시간입니다. GitLab 15.1 이전에는 부팅 시간 통계였습니다.

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

백그라운드 작업

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

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

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

로그

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

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

로그 파일	내용
application_json.log	GitLab 사용자 활동
git_json.log	Git 저장소와의 실패한 GitLab 상호 작용
production.log	Puma로부터 수신된 요청 및 해당 요청을 처리하는 작업
sidekiq.log	백그라운드 작업
repocheck.log	저장소 활동
integrations_json.log	GitLab 및 통합된 시스템 간 활동
kubernetes.log	Kubernetes 활동

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

이 로그 파일의 세부 정보와 내용은 로그 시스템을 참조하십시오.

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

감사 이벤트

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

통계

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

참고: 이 통계는 10,000 미만의 값에 대해 정확한 카운트를 보여줍니다. 10,000 이상의 값에 대해서는 TablesampleCountStrategy 및 ReltuplesCountStrategy 전략이 계산에 사용될 때 대략적인 데이터가 표시됩니다.