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

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

GitLab에서 namespace 개인 네임스페이스로 시작했지만, 이제는 해당 네임스페이스의 능력이 한계에 부딪혀 프로젝트 협업에 제한이 생기는 것을 발견했다면, 그룹 네임스페이스로 전환하고 싶을 수 있습니다. 그룹 네임스페이스를 사용하면 여러 하위 그룹을 만들고 회원 및 권한을 관리할 수 있습니다.

맨 처음부터 시작할 필요는 없습니다. 기존 프로젝트를 그룹으로 이동하고 추가 이점을 얻으려면 새 그룹을 만들어 기존 프로젝트를 이동할 수 있습니다. 자세한 방법은 튜토리얼: 개인 프로젝트를 그룹으로 이동을 참조하세요.

그러나 개인 네임스페이스를 그룹 네임스페이스로 변환하여 기존 사용자 이름 및 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 변경을 선택하세요.

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