조직
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed
요약
이 기능의 가용성은 기능 플래그로 제어합니다. 조직은 GitLab 계층 구조의 최상위 엔터티입니다. 조직은 이러한 그룹 위의 관리 계층으로 동작하며, 조직 설정을 관리하고 사용자를 관리할 수 있는 전용 Organization Admin 영역이 있습니다.
이 기능의 가용성은 기능 플래그로 제어합니다. 이 기능은 프로덕션 사용 준비가 되지 않았습니다.
조직은 GitLab 계층 구조의 최상위 엔터티입니다. 각 조직에는 하나 이상의 최상위 그룹과 그 모든 하위 그룹 및 프로젝트가 포함됩니다.
조직은 이러한 그룹 위의 관리 계층으로 동작하며, 조직 설정을 관리하고 사용자를 관리할 수 있는 전용 Organization Admin 영역이 있습니다.
조직 개발 상태에 대한 자세한 내용은 에픽 9265를 참고합니다.
조직은 비공개 베타 상태이며, 제한된 베타 참여자에게만 초대를 통해 제공됩니다.
조직 생성#
기존 최상위 그룹에서 조직을 생성합니다.
사전 요구 사항:
- 시작할 최상위 그룹과 포함하려는 다른 모든 최상위 그룹의 Owner 권한이 있어야 합니다.
기존 최상위 그룹에서 조직을 생성하려면 다음과 같이 합니다:
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다. 이 그룹은 최상위 그룹이어야 합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- Advanced를 확장합니다.
- Create an organization 섹션에서 Create organization을 선택합니다.
- Create your Organizations 확인 대화 상자에서 조직을 만들 그룹을 선택한 다음 Continue를 선택합니다.
- 선택 사항. 여러 최상위 그룹의 Owner 권한이 있다면 Assign top-level groups 확인 대화 상자에서 해당 그룹을 조직 컨테이너로 끌어다 놓습니다. 할당하지 않은 그룹은 포함되지 않습니다. Continue를 선택합니다.
- Confirm your organization 확인 대화 상자에서 제안된 구조를 검토합니다.
- Confirm을 선택합니다.
조직 구조를 확인한 후에는 다음과 같이 진행됩니다:
- 그룹과 프로젝트가 비동기적으로 조직으로 이전됩니다.
- 이전된 그룹이나 프로젝트의 멤버인 사용자는 조직 멤버가 됩니다.
- 이전이 완료되면 이메일을 받습니다. 규모가 큰 그룹은 이전에 더 오래 걸립니다.
- 이전된 모든 최상위 그룹에서 Owner 권한이 있는 사용자는 조직 관리자가 됩니다.
조직 이름, URL, 설명, 공개 범위, 아바타는 나중에 Organization Admin 영역에서 변경할 수 있습니다.
조직 구조를 확인한 후에는 최상위 그룹을 직접 추가하거나 제거할 수 없습니다. 확인 후 조직에 최상위 그룹을 추가하려면 지원팀에 문의합니다. 또한 그룹이나 프로젝트가 있는 동안에는 조직을 삭제할 수 없습니다. 변경이 필요하면 지원팀에 문의합니다.
조직으로 이동#
하나 이상의 조직 멤버라면 Organizations 페이지에서 원하는 조직으로 이동할 수 있습니다. 조직에 접근하려면 다음과 같이 합니다:
- 왼쪽 사이드바에서 Organizations를 선택합니다.
- 목록에서 이동할 조직을 선택합니다.
조직 URL#
조직과 조직에 포함된 모든 항목은 /o/<organization-path>/ 아래에 있습니다.
예를 들어 https://gitlab.example.com/o/my-org/-/overview입니다.
기존 그룹과 프로젝트 URL은 계속 작동합니다.
o는 예약된 경로이므로 어떤 최상위 그룹도 경로로 o를 사용할 수 없습니다.
기본 조직은 이 URL 체계의 예외입니다. 기본 조직의 콘텐츠는 범위가 지정되지 않은 URL에 그대로 있습니다.
기본 조직#
모든 GitLab 인스턴스에는 기본 조직이 하나 있습니다. 모든 계정은 기본 조직에서 시작합니다. 기본 조직은 삭제할 수 없습니다.
최상위 그룹이 사용자의 조직으로 이동하면 기본 조직에서 나가게 됩니다.
사용자 유형과 권한#
조직에는 조직 관리자와 조직 일반 사용자라는 두 가지 사용자 유형이 있습니다.
사용자 유형은 사람과 조직의 관계를 나타냅니다. 조직 일반 사용자는 그룹과 프로젝트 역할에 따라 그룹과 프로젝트에 대한 액세스가 결정됩니다. 조직 관리자는 조직 내 모든 그룹과 프로젝트에 대한 전체 액세스 권한을 가집니다.
다음 표는 각 사용자 유형이 수행할 수 있는 작업을 나열합니다:
| 작업 | 조직 관리자 | 조직 일반 사용자 |
|---|---|---|
| 조직 보기 | ✅ | ✅ |
| 그룹 생성 | ✅ | ✅ |
| 조직 업데이트 | ✅ | ❌ |
| Organization Admin 영역 접근 | ✅ | ❌ |
| 조직 사용자 보기 | ✅ | ❌ |
| 조직 멤버십 관리 | ✅ | ❌ |
| 최상위 그룹을 조직으로 이전 | ✅ | ❌ |
| 조직 나가기 | ✅ | ✅ |
| 조직 범위 제품 구매 | ✅ | ❌ |
| 조직 제품 역할 할당 | ✅ | ❌ |
| 모든 그룹과 프로젝트 관리1 | ✅ | ❌ |
그룹 및 프로젝트 역할#
조직 안에서도 그룹과 프로젝트에 대한 액세스는 기본 역할 및 권한이 계속 제어합니다.
최상위 그룹이 조직으로 이전되면 해당 그룹과 프로젝트의 멤버는 조직 사용자가 됩니다. 기존 역할과 권한은 그대로 유지됩니다.
인스턴스 관리자와 조직 관리자#
인스턴스 관리자는 인스턴스의 모든 조직을 관리할 수 있습니다. 인스턴스 관리자와 조직 관리자의 작업이 충돌하면 인스턴스 관리자의 작업이 우선합니다.
조직 관리자는 인스턴스 관리자 없이 자신의 조직을 관리합니다. 각 조직에는 조직 관리자가 최소 한 명 있어야 합니다. 마지막 조직 관리자는 제거하거나 사용자 유형을 변경할 수 없습니다.
| 관리자 | 범위 | GitLab.com에서 | GitLab Self-Managed에서 |
|---|---|---|---|
| 인스턴스 관리자 | GitLab 인스턴스 전체 | 내부 GitLab 팀 구성원 | 조직 관리자와 같은 사람인 경우가 많습니다 |
| 조직 관리자 | 조직 하나 | 사용자 조직의 사용자 | 인스턴스 관리자와 같은 사람인 경우가 많습니다 |
조직 보기#
GitLab 인스턴스의 조직을 봅니다.
사전 요구 사항:
- 인스턴스 관리자 액세스 권한이 있어야 합니다.
모든 조직을 보려면 다음과 같이 합니다:
- 오른쪽 상단에서 Admin을 선택합니다.
- Organizations를 선택합니다.
조직 멤버십 관리#
Organization Admin 영역에서 조직 사용자를 추가하고, 사용자 유형을 변경하고, 제거합니다.
사전 요구 사항:
- 조직 관리자 액세스 권한이 있어야 합니다.
조직 사용자 보기#
조직의 사용자를 보려면 다음과 같이 합니다:
- 왼쪽 사이드바에서 Organizations를 선택합니다.
- 드롭다운 목록에서 이동할 조직을 선택합니다.
- 왼쪽 사이드바에서 Manage organization을 선택합니다. Organization Admin 영역이 열립니다.
- Organization overview > Users를 선택합니다.
조직에 사용자 추가#
조직에 사용자를 추가하려면 다음과 같이 합니다:
- 왼쪽 사이드바에서 Organizations를 선택합니다.
- 드롭다운 목록에서 이동할 조직을 선택합니다.
- 왼쪽 사이드바에서 Manage organization을 선택합니다. Organization Admin 영역이 열립니다.
- Organization overview > Users를 선택합니다.
- Invite organization user를 선택합니다.
- GitLab usernames에서 사용자 이름으로 사용자를 한 명 이상 검색해 선택합니다.
- Organization user type에서 다음 중 하나를 선택합니다:
- Organization regular user: 사용자가 멤버로 속한 그룹과 프로젝트에 대한 액세스를 부여합니다.
- Organization administrator: 모든 그룹, 프로젝트, 사용자, 기능, Organization Admin 영역에 대한 액세스를 부여합니다.
- Invite를 선택합니다.
조직의 그룹이나 프로젝트에 사용자를 추가하는 방법으로도 조직에 사용자를 추가할 수 있습니다.
조직 관리자 액세스 관리#
사용자를 조직 일반 사용자로 할지 조직 관리자로 할지 변경하려면 다음과 같이 합니다:
- 왼쪽 사이드바에서 Organizations를 선택합니다.
- 드롭다운 목록에서 이동할 조직을 선택합니다.
- 왼쪽 사이드바에서 Manage organization을 선택합니다. Organization Admin 영역이 열립니다.
- Organization overview > Users를 선택합니다.
- 사용자 옆에서 Edit를 선택합니다.
- Organization user type에서 다음 중 하나를 선택합니다:
- Organization regular user: 사용자가 멤버로 속한 그룹과 프로젝트에 대한 액세스를 부여합니다.
- Organization administrator: 모든 그룹, 프로젝트, 사용자, 기능, Organization Admin 영역에 대한 액세스를 부여합니다.
- Save changes를 선택합니다.
조직에서 사용자 제거#
조직에서 사용자를 제거하면 해당 사용자는 조직의 모든 그룹과 프로젝트에서도 제거됩니다.
조직에서 사용자를 제거하려면 다음과 같이 합니다:
- 왼쪽 사이드바에서 Organizations를 선택합니다.
- 드롭다운 목록에서 이동할 조직을 선택합니다.
- 왼쪽 사이드바에서 Manage organization을 선택합니다. Organization Admin 영역이 열립니다.
- Organization overview > Users를 선택합니다.
- 사용자 옆에서 세로 줄임표(⋮) > Remove from organization을 선택합니다.
- 확인 대화 상자에서 Remove를 선택합니다.
조직 공개 범위#
조직은 공개 또는 비공개입니다. 조직에는 내부 공개 범위를 사용할 수 없습니다.
| 공개 범위 | 조직을 볼 수 있는 사용자 | 허용되는 그룹 및 프로젝트 공개 범위 |
|---|---|---|
| 공개 | 모든 사용자 | 공개 및 비공개 |
| 비공개 | 조직 사용자만 | 비공개 |
조직은 포함하는 그룹보다 더 제한적일 수 없습니다. 예를 들어 공개 그룹이 있는 동안에는 조직을 비공개로 설정할 수 없습니다.
조직 설명에 지원되는 Markdown#
조직 설명 필드는 GitLab Flavored Markdown의 제한된 하위 집합을 지원하며, 다음이 포함됩니다:
Footnotes
-
조직 관리자는 조직 내 모든 그룹과 프로젝트에서 암묵적으로 Owner 권한을 가집니다. 그룹이나 프로젝트 멤버 목록에는 표시되지 않습니다. ↩