최상위 그룹의 Owner 권한이 있는 사용자는 플레이스홀더 사용자의 기여와 멤버십을 기존 활성 비봇(non-bot) 사용자에게 재배정할 수 있습니다. 대상 인스턴스에서 최상위 그룹의 Owner 권한이 있는 사용자는 다음을 수행할 수 있습니다:

• UI를 통해 또는 CSV 파일을 사용하여 기여와 멤버십 재배정을 사용자에게 요청합니다. 플레이스홀더 사용자 수가 많은 경우 CSV 파일을 사용하는 것이 좋습니다. 두 경우 모두 사용자는 재배정을 수락하거나 거부할 수 있는 요청을 이메일로 받습니다. 선택된 사용자가 재배정 요청을 수락한 후에만 재배정이 시작됩니다.

• 기여와 멤버십을 재배정하지 않고 플레이스홀더 사용자로 유지하도록 선택합니다.

GitLab Self-Managed 및 GitLab Dedicated에서 관리자는 확인 없이 즉시 활성 및 비활성 비봇 사용자에게 기여와 멤버십을 재배정할 수 있습니다. 자세한 내용은 관리자가 플레이스홀더 사용자를 재배정할 때 확인 건너뛰기를 참조하세요. 관리자에게 기여와 멤버십을 재배정하려면 관리자에 대한 기여 매핑 허용을 참조하세요.

플레이스홀더 사용자 재배정 시 확인 우회#

히스토리

• GitLab 18.1에서 group_owner_placeholder_confirmation_bypass라는 기능 플래그와 함께 GitLab.com에 도입됨. 기본적으로 비활성화됨.

• GitLab 18.4에서 GitLab.com에 활성화됨.

• GitLab 18.7에서 GitLab.com에서 일반적으로 사용 가능해짐. 기능 플래그 group_owner_placeholder_confirmation_bypass 제거됨.

사전 요구사항:

• 그룹의 Owner 권한이 있어야 합니다.

플레이스홀더를 재배정할 때 엔터프라이즈 사용자에 대한 확인을 우회하려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 설정 > 일반을 선택합니다.

• 권한 및 그룹 기능을 확장합니다.

• 플레이스홀더 사용자 확인 아래에서 사용자 확인 없이 플레이스홀더를 엔터프라이즈 사용자에게 재배정 확인란을 선택합니다.

• 사용자 확인 복원 시기에서 사용자 확인 우회 종료 날짜를 선택합니다. 기본값은 하루입니다.

• 변경 사항 저장을 선택합니다.

여러 플레이스홀더 사용자의 기여 재배정#

단일 플레이스홀더 사용자에게 처음 배정된 모든 기여를 대상 인스턴스의 단일 활성 일반 사용자, 서비스 계정, 프로젝트 봇, 그룹 봇에게 재배정할 수 있습니다. 단일 플레이스홀더 사용자에게 배정된 기여를 여러 사용자에게 분할할 수는 없습니다.

플레이스홀더 사용자가 다음에 해당하는 경우, 여러 플레이스홀더 사용자의 기여를 대상 인스턴스의 동일한 사용자에게 재배정할 수 있습니다:

• 서로 다른 소스 인스턴스에서 온 경우

• 동일한 소스 인스턴스에서 왔으며 대상 인스턴스의 다른 최상위 그룹으로 가져온 경우

배정된 사용자가 재배정 요청을 수락하기 전에 비활성화되면, 대기 중인 재배정은 수락할 때까지 해당 사용자와 연결된 상태로 유지됩니다.

재배정 요청을 받은 사용자는 다음을 수행할 수 있습니다:

• 요청 수락. 이전에 플레이스홀더 사용자에게 귀속된 모든 기여와 멤버십이 수락한 사용자에게 재귀속됩니다. 이 프로세스는 기여 수에 따라 몇 분이 걸릴 수 있습니다.

• 요청 거부 또는 스팸으로 신고. 이 옵션은 재배정 요청 이메일에서 사용할 수 있습니다.

서비스 계정, 프로젝트 봇, 그룹 봇에게 기여를 재배정하면 재배정 요청이 자동으로 승인됩니다.

동일한 최상위 그룹으로의 후속 가져오기에서, 동일한 소스 사용자에 속하는 기여와 멤버십은 해당 소스 사용자에 대한 재배정을 이전에 수락한 사용자에게 자동으로 매핑됩니다.

GitLab Self-Managed 및 GitLab Dedicated에서 관리자는 확인 없이 즉시 활성 및 비활성 비봇 사용자에게 기여와 멤버십을 재배정할 수 있습니다. 자세한 내용은 관리자가 플레이스홀더 사용자를 재배정할 때 확인 건너뛰기를 참조하세요. 관리자에게 기여와 멤버십을 재배정하려면 관리자에 대한 기여 매핑 허용을 참조하세요.

재배정 완료#

다음을 수행하기 전에 재배정 프로세스가 완전히 완료되어야 합니다:

• 동일한 GitLab 인스턴스에서 가져온 그룹 이동.

• 가져온 프로젝트를 다른 그룹으로 이동.

• 가져온 이슈 복제.

• 가져온 이슈를 에픽으로 승격.

프로세스가 완료되지 않으면, 플레이스홀더 사용자에게 여전히 배정된 기여는 실제 사용자에게 재배정될 수 없으며 플레이스홀더 사용자와 연결된 상태로 유지됩니다.

보안 고려사항#

기여 및 멤버십 재배정은 취소할 수 없으므로 시작하기 전에 모든 것을 신중하게 확인하세요.

잘못된 사용자에게 기여와 멤버십을 재배정하면 보안 위협이 될 수 있습니다. 해당 사용자가 그룹의 멤버가 되어 볼 수 없어야 하는 정보를 볼 수 있게 됩니다.

관리자 액세스 권한이 있는 사용자에게 기여를 재배정하는 것은 기본적으로 비활성화되어 있지만 활성화할 수 있습니다.

멤버십 보안 고려사항#

GitLab 권한 모델로 인해, 그룹 또는 프로젝트가 기존 상위 그룹으로 가져와지면 상위 그룹의 멤버는 가져온 그룹 또는 프로젝트의 상속된 멤버십을 부여받습니다.

이미 가져온 그룹 또는 프로젝트의 기존 상속된 멤버십을 가진 사용자를 기여 및 멤버십 재배정 대상으로 선택하면 멤버십이 해당 사용자에게 재배정되는 방식에 영향을 줄 수 있습니다.

GitLab은 하위 프로젝트 또는 그룹의 멤버십이 상속된 멤버십보다 낮은 권한을 갖도록 허용하지 않습니다. 배정된 사용자에 대해 가져온 멤버십이 기존 상속된 멤버십보다 낮은 권한을 가지면, 가져온 멤버십은 해당 사용자에게 재배정되지 않습니다.

그 결과, 가져온 그룹 또는 프로젝트에 대한 해당 사용자의 멤버십이 소스에서의 멤버십보다 높아질 수 있습니다.

UI에서 재배정 요청#

사전 요구사항:

• 그룹의 Owner 권한이 있어야 합니다.

최상위 그룹에서 기여와 멤버십을 재배정할 수 있습니다. 기여와 멤버십 재배정을 요청하려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 재배정 대기 중 하위 탭으로 이동합니다. 여기에 플레이스홀더가 테이블에 나열됩니다.

• 각 플레이스홀더에 대해 플레이스홀더 사용자 및 소스 테이블 칼럼의 정보를 검토합니다.

• 플레이스홀더 재배정 대상 칼럼에서 드롭다운 목록에서 사용자를 선택합니다.

• 재배정을 선택합니다.

단일 플레이스홀더 사용자의 기여만 대상 인스턴스의 활성 비봇 사용자에게 재배정할 수 있습니다.

사용자가 재배정을 수락하기 전에 요청을 취소할 수 있습니다.

GitLab Self-Managed 및 GitLab Dedicated에서 관리자는 확인 없이 즉시 활성 및 비활성 비봇 사용자에게 기여와 멤버십을 재배정할 수 있습니다. 자세한 내용은 관리자가 플레이스홀더 사용자를 재배정할 때 확인 건너뛰기를 참조하세요. 관리자에게 기여와 멤버십을 재배정하려면 관리자에 대한 기여 매핑 허용을 참조하세요.

CSV 파일을 사용하여 재배정 요청#

히스토리

• GitLab 17.10에서 importer_user_mapping_reassignment_csv라는 플래그와 함께 도입됨. 기본적으로 활성화됨.

• GitLab 18.0에서 일반적으로 사용 가능해짐. 기능 플래그 importer_user_mapping_reassignment_csv 제거됨.

사전 요구사항:

• 그룹의 Owner 권한이 있어야 합니다.

플레이스홀더 사용자 수가 많은 경우 CSV 파일을 사용하여 기여와 멤버십을 재배정할 수 있습니다. 다음 정보가 미리 채워진 CSV 템플릿을 다운로드할 수 있습니다. 예:

Source host, Import type, Source user identifier는 업데이트하지 마세요. 이 정보는 완성된 CSV 파일을 업로드한 후 해당 데이터베이스 레코드를 찾는 데 사용됩니다. Source user name과 Source username은 소스 사용자를 식별하며 CSV 파일을 업로드한 후에는 사용되지 않습니다.

CSV 파일의 모든 행을 업데이트할 필요는 없습니다. GitLab username 또는 GitLab public email이 있는 행만 처리됩니다. 다른 모든 행은 건너뜁니다.

CSV 파일을 사용하여 기여와 멤버십 재배정을 요청하려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• CSV로 재배정을 선택합니다.

• 미리 채워진 CSV 템플릿을 다운로드합니다.

• GitLab username 또는 GitLab public email에 대상 인스턴스의 GitLab 사용자의 사용자 이름 또는 공개 이메일 주소를 입력합니다. 인스턴스 관리자는 확인된 이메일 주소가 있는 모든 사용자를 재배정할 수 있습니다.

• 완성된 CSV 파일을 업로드합니다.

• 재배정을 선택합니다.

대상 인스턴스의 각 활성 비봇 사용자에게는 단일 플레이스홀더 사용자의 기여만 배정할 수 있습니다. 사용자는 재배정된 기여를 검토하고 수락할 수 있는 이메일을 받습니다. 사용자가 검토하기 전에 재배정 요청을 취소할 수 있습니다.

GitLab Self-Managed 및 GitLab Dedicated에서 관리자는 확인 없이 즉시 활성 및 비활성 비봇 사용자에게 기여와 멤버십을 재배정할 수 있습니다. 자세한 내용은 관리자가 플레이스홀더 사용자를 재배정할 때 확인 건너뛰기를 참조하세요. 관리자에게 기여와 멤버십을 재배정하려면 관리자에 대한 기여 매핑 허용을 참조하세요.

기여를 재배정한 후 GitLab은 다음 항목의 수가 포함된 이메일을 보냅니다:

• 성공적으로 처리된 행

• 처리에 실패한 행

• 건너뛴 행

성공적으로 처리되지 않은 행이 있으면 이메일에 더 자세한 결과가 담긴 CSV 파일이 첨부됩니다.

UI를 사용하지 않고 플레이스홀더 사용자를 일괄 재배정하려면 그룹 플레이스홀더 재배정 API를 참조하세요.

플레이스홀더로 유지#

히스토리

• GitLab 18.5에서 변경됨. 작업을 취소할 수 있게 됨.

대상 인스턴스의 사용자에게 기여와 멤버십을 재배정하지 않을 수도 있습니다. 예를 들어 소스 인스턴스에서 기여한 전직 직원이 대상 인스턴스에 사용자로 존재하지 않을 수 있습니다.

이러한 경우 기여를 플레이스홀더 사용자에게 배정된 상태로 유지할 수 있습니다. 플레이스홀더 사용자는 프로젝트 또는 그룹의 멤버가 될 수 없으므로 멤버십 정보를 유지하지 않습니다.

플레이스홀더 사용자의 이름과 사용자 이름이 소스 사용자의 이름과 사용자 이름과 유사하기 때문에 많은 히스토리적 맥락을 유지할 수 있습니다.

기여를 플레이스홀더 사용자에게 배정된 상태로 한 번에 하나씩 또는 일괄로 유지할 수 있습니다. 기여를 일괄로 재배정하면 전체 네임스페이스와 다음 재배정 상태의 사용자가 영향을 받습니다:

• Not started

• Rejected

플레이스홀더 사용자를 한 번에 하나씩 유지하려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 재배정 대기 중 하위 탭으로 이동합니다. 여기에 플레이스홀더가 테이블에 나열됩니다.

• 플레이스홀더 사용자 및 소스 칼럼을 검토하여 유지할 플레이스홀더 사용자를 찾습니다.

• 플레이스홀더 재배정 대상 칼럼에서 재배정하지 않음을 선택합니다.

• 확인을 선택합니다.

플레이스홀더 사용자를 일괄로 유지하려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 목록 위에서 세로 줄임표 ( ellipsis_v ) > 모두 플레이스홀더로 유지를 선택합니다.

• 확인 대화상자에서 확인을 선택합니다.

작업을 취소하려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 재배정됨 하위 탭으로 이동합니다. 여기에 플레이스홀더가 테이블에 나열됩니다.

• 해당 행에서 취소를 선택합니다.

재배정 요청 취소#

사용자가 재배정 요청을 수락하기 전에 요청을 취소할 수 있습니다:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 재배정 대기 중 하위 탭으로 이동합니다. 여기에 플레이스홀더가 테이블에 나열됩니다.

• 해당 행에서 취소를 선택합니다.

대기 중인 재배정 요청에 대해 사용자에게 다시 알리기#

사용자가 재배정 요청에 응하지 않는 경우 다른 이메일을 보내 다시 알릴 수 있습니다:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 재배정 대기 중 하위 탭으로 이동합니다. 여기에 플레이스홀더가 테이블에 나열됩니다.

• 해당 행에서 알림을 선택합니다.

재배정 상태 보기 및 필터링#

모든 플레이스홀더 사용자의 재배정 상태를 보려면:

• 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 이 그룹은 최상위 수준이어야 합니다.

• 왼쪽 사이드바에서 관리 > 멤버를 선택합니다.

• 플레이스홀더 탭을 선택합니다.

• 재배정 대기 중 하위 탭으로 이동합니다. 여기에 플레이스홀더가 테이블에 나열됩니다.

• 재배정 상태 칼럼에서 각 플레이스홀더 사용자의 상태를 확인합니다.

재배정 대기 중 탭에서 가능한 상태는 다음과 같습니다:

• Not started - 재배정이 시작되지 않음.

• Pending approval - 재배정이 사용자 승인을 기다리고 있음.

• Reassigning - 재배정이 진행 중.

• Rejected - 재배정이 사용자에 의해 거부됨.

• Failed - 재배정이 실패함.

재배정됨 탭에서 가능한 상태는 다음과 같습니다:

• Success - 재배정 성공.

• Kept as placeholder - 플레이스홀더 사용자가 영구적으로 설정됨.

기본적으로 테이블은 플레이스홀더 사용자 이름 기준으로 알파벳 순으로 정렬됩니다. 재배정 상태를 기준으로 테이블을 정렬할 수도 있습니다.

기여 재배정 확인#

관리자가 플레이스홀더 사용자를 재배정할 때 확인 건너뛰기가 활성화된 경우:

• 관리자는 사용자 확인 없이 즉시 기여를 재배정할 수 있습니다.

• 관리자는 활성 및 비활성 비봇 사용자에게 기여를 재배정할 수 있습니다.

• 기여가 재배정되었음을 알리는 이메일을 받습니다.

이 설정이 활성화되지 않은 경우 재배정을 수락하거나 거부할 수 있습니다.

기여 재배정 수락#

가져오기 프로세스가 진행되었으며 자신에게 기여 재배정을 확인하도록 요청하는 이메일을 받을 수 있습니다.

이 가져오기 프로세스에 대해 이미 알고 있었더라도 재배정 세부 정보를 매우 신중하게 검토해야 합니다. 이메일에 나열된 세부 정보는 다음과 같습니다:

• Imported from - 가져온 콘텐츠의 원본 플랫폼. 예: GitLab의 다른 인스턴스, GitHub, 또는 Bitbucket.

• Original user - 소스 플랫폼의 사용자 이름과 사용자 이름. 해당 플랫폼에서의 본인 이름과 사용자 이름일 수 있습니다.

• Imported to - 새 플랫폼의 이름으로, GitLab 인스턴스만 해당됩니다.

• Reassigned to - GitLab 인스턴스에서의 본인 전체 이름과 사용자 이름.

• Reassigned by - 가져오기를 수행한 동료 또는 관리자의 전체 이름과 사용자 이름.

기여 재배정 거부#

자신에게 기여 재배정을 확인하도록 요청하는 이메일을 받았는데 이 정보를 인식하지 못하거나 실수를 발견한 경우:

• 진행하지 않거나 기여 재배정을 거부합니다.

• 신뢰할 수 있는 동료 또는 관리자에게 문의합니다.

보안 고려사항#

재배정 요청의 재배정 세부 정보를 매우 신중하게 검토해야 합니다. 신뢰할 수 있는 동료나 관리자로부터 이 프로세스에 대해 미리 알지 못한 경우 더욱 주의를 기울이세요.

의심스러운 재배정을 수락하는 대신:

• 이메일에 응하지 마세요.

• 신뢰할 수 있는 동료 또는 관리자에게 문의하세요.

알고 신뢰하는 사용자의 재배정만 수락하세요. 기여 재배정은 영구적이며 취소할 수 없습니다. 재배정을 수락하면 기여가 잘못 귀속될 수 있습니다.

기여 재배정 프로세스는 GitLab에서 재배정 승인을 선택하여 재배정 요청을 수락한 후에만 시작됩니다. 이메일의 링크를 선택해도 프로세스가 시작되지 않습니다.