자습서: 개인 네임스페이스를 그룹으로 변환하기

Tier: Free, Premium, Ultimate Offering: GitLab.com

만약 개인 네임스페이스에서 시작했지만 현재 해당 기능의 한계로 인해 프로젝트 협업이 제한되고 있다면, 그룹 네임스페이스로 전환하고 싶을 수 있습니다. 그룹 네임스페이스를 사용하면 여러 하위 그룹을 생성하고 구성원 및 권한을 관리할 수 있습니다.

여기서 새롭게 시작할 필요는 없습니다. 기존 프로젝트를 그룹으로 이동하여 추가 혜택을 누릴 수 있습니다. 이를 확인하려면 자습서: 개인 프로젝트를 그룹으로 이동을 참조하세요.

또한, 개인 네임스페이스를 그룹 네임스페이스로 변환하여 기존 사용자 이름과 URL을 유지할 수 있습니다. 예를 들어 사용자 이름이 alex인 경우 https://gitlab.example.com/alex URL을 계속 사용할 수 있습니다.

이 자습서에서는 다음 단계를 따라 개인 네임스페이스를 그룹 네임스페이스로 변환하는 방법을 안내합니다:

  1. 그룹 생성.
  2. 개인 네임스페이스에서 프로젝트 이동.
  3. 원래 사용자 이름 바꾸기.
  4. 새 그룹 네임스페이스를 원래 사용자 이름으로 바꾸기.

예를 들어, 개인 네임스페이스의 사용자 이름이 alex인 경우 먼저 alex-group이라는 그룹 네임스페이스를 만듭니다. 그런 다음 alex에서 alex-group으로 모든 프로젝트를 이동합니다. 마지막으로 alex 네임스페이스를 alex-user로, alex-group 네임스페이스를 새롭게 사용 가능한 alex 사용자 이름으로 변경합니다.

그룹 생성

  1. 왼쪽 사이드바에서 상단에 새로 만들기 () 및 새 그룹을 선택합니다.
  2. 그룹 이름에 그룹의 이름을 입력합니다.
  3. 그룹 URL에 네임스페이스로 사용될 경로를 입력합니다. 실제 경로에 대해서는 걱정하지 않아도 됩니다. 이는 임시적인 것뿐입니다. 이 URL은 최종 단계에서 개인 네임스페이스의 사용자 이름으로 변경할 것입니다.
  4. 가시성 수준을 선택합니다.
  5. 선택 사항. 사용자 경험을 개인화하기 위해 정보를 입력합니다.
  6. 그룹 생성을 선택합니다.

개인 네임스페이스에서 프로젝트 이동

이제 개인 네임스페이스에서 프로젝트를 새 그룹으로 이동해야 합니다. 한 번에 하나의 프로젝트만 전송할 수 있으므로 여러 프로젝트를 이전하려면 각 프로젝트에 대해 아래 단계를 수행해야 합니다.

전송 프로세스를 시작하기 전에 다음을 확인하세요:

  • 프로젝트에 소유자 역할이 있어야 합니다.
  • 컨테이너 이미지를 제거하세요. 컨테이너 이미지를 포함한 프로젝트는 전송할 수 없습니다.
  • npm 패키지를 제거하세요. npm 패키지를 포함한 프로젝트의 루트 네임스페이스를 업데이트할 수 없습니다.

그룹으로 프로젝트를 이전하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 고급을 확장합니다.
  4. 프로젝트 전송에서 프로젝트를 전송할 그룹을 선택합니다.
  5. 프로젝트 전송을 선택합니다.
  6. 프로젝트 이름을 입력하고 확인을 선택합니다.

원래 사용자 이름 바꾸기

이제 개인 네임스페이스의 원래 사용자 이름을 변경하여 그룹 네임스페이스에 사용 가능한 사용자 이름으로 만들어야 합니다. 개인 네임스페이스를 다른 개인 프로젝트에 계속 사용하거나 해당 사용자 계정을 삭제할 수 있습니다.

개인 네임스페이스의 사용자 이름을 변경한 순간부터 해당 사용자 이름은 사용 가능해지므로 누군가 다른 사람이 해당 아이디로 계정을 등록할 수 있습니다. 이를 피하기 위해 새 그룹 이름을 가능한 빨리 바꾸어야 합니다.

사용자 이름을 변경하려면:

  1. 왼쪽 사이드바에서 사용자 아바타를 선택합니다.
  2. 프로필 편집을 선택합니다.
  3. 왼쪽 사이드바에서 계정을 선택합니다.
  4. 사용자 이름 변경 섹션에서 새로운 사용자 이름을 경로로 입력합니다.
  5. 사용자 이름 업데이트를 선택합니다.

새 그룹 네임스페이스를 원래 사용자 이름으로 바꾸기

마지막으로, 새 그룹의 URL을 원래 개인 네임스페이스의 사용자 이름으로 변경합니다.

그룹 경로를 변경하려면 (그룹 URL):

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 고급 섹션을 확장합니다.
  4. 그룹 URL 변경에서 사용자의 원래 사용자 이름을 입력합니다.
  5. 그룹 URL 변경을 선택합니다.

이제 개인 네임스페이스를 그룹으로 변환하여 프로젝트에서 더 많은 구성원과 협업할 수 있는 새로운 가능성을 열었습니다.