튜토리얼: 개인 네임스페이스를 그룹으로 전환

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

GitLab에서 개인 네임스페이스로 시작했지만 이제 능력이 부족하다고 느끼거나 제약으로 인해 프로젝트 협업을 방해하는 경우 개인 네임스페이스를 그룹 네임스페이스로 전환하려고 할 수 있습니다. 그룹 네임스페이스를 사용하면 여러 하위 그룹을 생성하고 이들의 구성원 및 권한을 관리할 수 있습니다.

처음부터 새롭게 시작할 필요가 없습니다. 기존 프로젝트를 이전하여 그룹의 추가 혜택을 누릴 수 있습니다. 이를 확인하려면 튜토리얼: 개인 프로젝트를 그룹으로 이동을 참조하세요.

그러나 더 나아가 개인 네임스페이스를 그룹 네임스페이스로 전환하여 기존 사용자 이름과 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은 일시적으로만 사용됩니다. 마지막 단계에서 이 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 변경을 선택합니다.

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