프로젝트 이전

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

프로젝트를 다른 네임스페이스로 이전

프로젝트를 다른 네임스페이스로 이전하면 프로젝트가 다른 그룹으로 이동됩니다. 프로젝트의 모든 컴포넌트(이슈, Merge Request, 파이프라인, 대시보드 등)가 전이된 프로젝트와 함께 이동합니다. 프로젝트의 경로 또한 변경되므로 필요시 프로젝트 컴포넌트의 URL을 업데이트해야 합니다.

caution
이전 프로세스 중 발생하는 오류로 인해 프로젝트 컴포넌트나 최종 사용자의 의존성의 데이터 손실이 발생할 수 있습니다.

전제 조건:

  • 이전할 그룹에 대해 적어도 Maintainer 역할을 가져야 합니다.
  • 이전할 프로젝트의 소유자여야 합니다.
  • 그룹은 새 프로젝트를 만들 수 있어야 합니다.
  • 프로젝트는 어떤 컨테이너 이미지도 포함해서는 안 됩니다.
  • 프로젝트에 보안 정책이 없어야 합니다. 만약 프로젝트에 보안 정책이 할당되어 있다면, 전이하는 동안 자동으로 할당이 해제됩니다.
  • 루트 네임스페이스가 변경되면 프로젝트에서 명명 규칙을 따르는 npm 패키지를 제거해야 합니다. 프로젝트를 이전한 후에는 다음 중 하나를 수행할 수 있습니다:
    • 새 루트 네임스페이스 경로로 패키지 스코프를 업데이트하고 프로젝트에 다시 게시합니다.
    • 루트 네임스페이스 경로를 업데이트하지 않고 패키지를 다시 프로젝트에 발행하여 명명 규칙을 더 이상 따르지 않도록 합니다. 만약 루트 네임스페이스 경로를 업데이트하지 않고 패키지를 다시 발행하면 인스턴스 레벨 엔드포인트에서 해당 패키지를 사용할 수 없게 됩니다.

프로젝트를 이전하려면:

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

프로젝트의 새 페이지로 리디렉션되며 GitLab이 리디렉션을 적용합니다. 리포지터리 리디렉션에 대한 자세한 내용은 리포지터리 경로가 변경되었을 때의 동작을 참조하십시오.

note
관리자인 경우 관리 인터페이스를 사용하여 어떤 프로젝트든 어떤 네임스페이스로도 이동할 수 있습니다.

GitLab SaaS 프로젝트를 다른 구독 계층으로 이전

GitLab SaaS Premium 또는 Ultimate으로 라이선스가 부여된 네임스페이스에서 프로젝트를 GitLab Free로 이전하는 경우:

문제 해결

프로젝트 설정 작업 중 다음 문제를 만날 수 있거나 특정 작업을 완료하기 위해 대체 방법이 필요할 수 있습니다.

콘솔을 통한 프로젝트 이전

UI 또는 API를 통한 프로젝트 이전이 작동하지 않는 경우 Rails 콘솔 세션에서 이전을 시도할 수 있습니다. 

p = Project.find_by_full_path('<프로젝트_경로>')

# 프로젝트 소유자 설정
current_user = p.creator

# 여기로 이동할 네임스페이스
namespace = Namespace.find_by_full_path("<새_네임스페이스>")

Projects::TransferService.new(p, current_user).execute(namespace)

관련 주제