GitHub Enterprise Importer에 대한 마네킹 회수

마이그레이션한 후 자리 표시자 ID 또는 마네킹의 기록을 조직의 구성원에게 할당할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Organization owners can reclaim mannequins.

이 문서의 내용

마네킹 정보

GitHub Enterprise Importer을(를) 사용하여 마이그레이션을 실행하면, 마이그레이션된 리포지토리의 모든 사용자 활동(Git 커밋 제외)은 마네킹이라는 자리 표시자 ID에 기인합니다.

각 마네킹에는 원본 리포지토리의 표시 이름에서 가져온 표시 이름만 있습니다. 마네킹에는 조직 멤버십 또는 리포지토리 액세스 권한이 없습니다. 마네킹은 항상 동일한 아바타인 고스트 옥토캣을 사용하며 표시 이름 다음에 마네킹 레이블을 포함합니다.

문제 주석의 헤더 스크린샷. 주석 작성자는 마네킹으로 레이블이 지정되고 "마네킹" 레이블은 진한 주황색으로 표시됩니다.

GitHub CLI을(를) 사용하거나 브라우저에서 각 마네킹의 기록을 조직 구성원에게 다시 배포할 수 있습니다. GitHub CLI을(를) 사용하는 경우 마네킹을 대량으로 회수할 수 있습니다.

회수는 선택 사항이며 마이그레이션이 완료된 후 언제든지 발생할 수 있습니다. 이러한 이유로 팀이 회수하기 전에 마이그레이션된 리포지토리에서 작업을 시작하도록 허용할 수 있습니다.

마네킹은 Git 커밋 특성에 사용되지 않습니다. 커밋 특성에 대한 자세한 내용은 아래의 "커밋에 대한 작성자 관리"를 참조하세요.

마네킹 회수

GitHub CLI(권장) 또는 브라우저를 사용하여 마네킹을 회수할 수 있습니다.

기본적으로 마네킹을 회수하면 대상 사용자에게 특성 초대가 전송됩니다.

대상 사용자는 초대를 수락하거나 거부할 수 있습니다. 사용자가 특성 초대를 수락하면 이전에 마네킹에 기인한 모든 기여는 대신에 사용자에게 귀속됩니다. 나중에 동일한 조직으로 마이그레이션할 때 동일한 마네킹의 기여는 동일한 사용자와 관련하여 자동으로 회수됩니다.

조직에서 Enterprise Managed Users을(를) 사용하고 GitHub CLI을(를) 사용하여 마네킹을 회수하려는 경우, 필요에 따라 초대 프로세스를 건너뛰고 사용자의 승인 없이 즉시 마네킹을 회수할 수 있습니다.

참고:

  • 리포지토리를 다른 조직으로 전송한 후에는 마네킹을 회수할 수 없습니다. 마이그레이션한 후 리포지토리를 다른 조직으로 전송하려는 경우 전송하기 전에 마네킹을 회수해야 합니다.
  • 마네킹을 회수할 때 기존 조직 구성원만 대상으로 지정할 수 있습니다. 마네킹을 회수하려고 시도하기 전에 초대하려는 GitHub 사용자가 이미 조직에 추가되었는지 확인합니다.

GitHub Enterprise Importer은(는) 사용자 액세스를 리포지토리로 마이그레이션하지 않습니다. 마네킹을 회수한 후 팀 멤버십을 통해 리포지토리에 대한 적절한 액세스 권한이 없는 사용자는 해당 사용자에게 리포지토리에 대한 액세스 권한을 별도로 부여해야 합니다. 자세한 내용은 “조직 리포지토리에 대한 개인 액세스 권한 관리”를 참조하세요.

GitHub CLI을(를) 사용하여 마네킹 회수(권장)

GitHub CLI을(를) 사용하여 개별적으로 또는 대량으로 마네킹을 회수할 수 있습니다. GitHub CLI 관련 마이그레이션 확장 설치 및 업데이트에 대한 자세한 내용은 "GitHub Enterprise Importer 정보"을 참조하세요.

사용해야 하는 정확한 명령은 사용 중인 GitHub CLI의 확장에 따라 달라집니다.

GEI extension을(를) 사용하여 마네킹 회수

마이그레이션 원본이 GitHub 제품인 경우 GEI extension of the GitHub CLI을(를) 사용하여 마네킹을 회수할 수 있습니다.

대상 조직에 대한 액세스 권한이 있는 personal access token에 대한 GH_PAT 환경 변수가 아직 설정되어 있지 않은 경우 아래의 각 명령에 --github-target-pat TOKEN을(를) 추가하여 TOKEN을(를) personal access token로 바꿉니다. personal access token 요구 사항은 "GitHub 제품 간의 마이그레이션에 대한 액세스 관리"을 참조하세요.

  1. 필요에 따라 마네킹을 대량으로 회수하려면 마네킹을 조직 구성원에게 매핑하는 CSV 파일을 만듭니다.

    • 조직의 마네킹 목록이 포함된 CSV 파일을 생성하려면 대상을 대상 조직으로, 파일 이름을 결과 CSV 파일의 파일 이름으로 바꾸는 gh gei generate-mannequin-csv 명령을 사용합니다.

      필요에 따라 이미 회수된 마네킹을 포함하려면 --include-reclaimed 플래그를 추가합니다.

      Shell
      gh gei generate-mannequin-csv --github-target-org DESTINATION --output FILENAME.csv

    • CSV 파일을 편집하고 각 마네킹에 해당하는 조직 구성원의 사용자 이름을 추가합니다.

    • 파일을 저장합니다.

  2. 마네킹을 회수하려면 gh gei reclaim-mannequin 명령을 사용합니다.

    • 이전에 만든 매핑 파일로 대량으로 마네킹을 회수하려면 목적지를 대상 조직으로, 파일 이름을 매핑 파일의 파일 이름으로 바꿉니다.

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --csv FILENAME.csv

    • 개별 마네킹을 회수하려면 DESTINATION을 목적지의 조직으로, MANNEQUIN을 마네킹 로그인으로 바꾸고, USERNAME을 마네킹에 해당하는 조직 구성원의 사용자 이름으로 바꿉니다.

      동일한 로그인을 가진 마네킹이 여러 개 있는 경우, --mannequin-user MANNEQUIN을(를) --mannequin-ID ID(으)로 바꾸고 ID를 마네킹의 ID로 바꿀 수 있습니다.

      조직에서 Enterprise Managed Users을(를) 사용하고 특성 초대를 건너뛰어 마네킹을 즉시 회수하려면 --skip-invitation 인수를 추가합니다.

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME

기본적으로 조직 구성원은 이메일을 통해 초대받게 되며, 구성원이 초대를 수락할 때까지 마네킹은 회수되지 않습니다.

ADO2GH extension을(를) 사용하여 마네킹 회수

마이그레이션 원본이 Azure DevOps인 경우 ADO2GH extension of the GitHub CLI을(를) 사용하여 마네킹을 회수할 수 있습니다.

대상 조직에 대한 액세스 권한이 있는 personal access token에 대한 GH_PAT 환경 변수가 아직 설정되어 있지 않은 경우 아래의 각 명령에 --github-target-pat TOKEN을(를) 추가하여 TOKEN을(를) personal access token로 바꿉니다. personal access token 요구 사항은 "Azure DevOps에서 마이그레이션에 대한 액세스 관리"을 참조하세요.

  1. 필요에 따라 마네킹을 대량으로 회수하려면 마네킹을 조직 구성원에게 매핑하는 CSV 파일을 만듭니다.

    • 조직의 마네킹 목록이 포함된 CSV 파일을 생성하려면 대상을 대상 조직으로, 파일 이름을 결과 CSV 파일의 파일 이름으로 바꾸는 gh ado2gh generate-mannequin-csv 명령을 사용합니다.

      필요에 따라 이미 회수된 마네킹을 포함하려면 --include-reclaimed 플래그를 추가합니다.

      Shell
      gh ado2gh generate-mannequin-csv --github-org DESTINATION --output FILENAME.csv

    • CSV 파일을 편집하고 각 마네킹에 해당하는 조직 구성원의 사용자 이름을 추가합니다.

    • 파일을 저장합니다.

  2. 마네킹을 회수하려면 gh ado2gh reclaim-mannequin 명령을 사용합니다.

    • 이전에 만든 매핑 파일로 대량으로 마네킹을 회수하려면 목적지를 대상 조직으로, 파일 이름을 매핑 파일의 파일 이름으로 바꿉니다.

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --csv FILENAME.csv

    • 개별 마네킹을 회수하려면 DESTINATION을 목적지의 조직으로, MANNEQUIN을 마네킹 로그인으로 바꾸고, USERNAME을 마네킹에 해당하는 조직 구성원의 사용자 이름으로 바꿉니다.

      동일한 로그인을 가진 마네킹이 여러 개 있는 경우, --mannequin-user MANNEQUIN을(를) --mannequin-ID ID(으)로 바꾸고 ID를 마네킹의 ID로 바꿀 수 있습니다.

      조직에서 Enterprise Managed Users을(를) 사용하고 특성 초대를 건너뛰어 마네킹을 즉시 회수하려면 --skip-invitation 인수를 추가합니다.

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME

기본적으로 조직 구성원은 이메일을 통해 초대받게 되며, 구성원이 초대를 수락할 때까지 마네킹은 회수되지 않습니다.

브라우저에서 마네킹 회수

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 사이드바의 "액세스" 섹션에서 가져오기/내보내기를 클릭합니다.

  4. 회수하려는 마네킹의 오른쪽에서 재귀속을 클릭합니다.

  5. 검색 필드에 마네킹이 기여할 특성을 지정할 조직 구성원의 사용자 이름을 입력한 다음 구성원을 클릭합니다.

    참고: 이미 조직의 구성원인 사용자 계정에만 특성 초대를 보낼 수 있습니다.

  6. 초대를 클릭합니다. 기본적으로 조직 구성원은 이메일을 통해 초대받게 되며, 구성원이 초대를 수락할 때까지 마네킹은 회수되지 않습니다.

특성 초대의 상태 보기

조직에 대한 모든 특성 초대의 상태를 볼 수 있습니다.

  • 초대됨: 사용자가 초대를 보냈지만 아직 초대에 회신하지 않았습니다.
  • 완료됨: 사용자가 수락했거나 초대 프로세스를 건너뛰었습니다. 사용자의 기여가 재귀속되었습니다.
  • 거부됨: 사용자가 마네킹의 기여 대해 크레딧을 받지 않겠다고 선택했습니다.

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 사이드바의 "액세스" 섹션에서 가져오기/내보내기를 클릭합니다.

  4. " Import/Export"에서 특성 초대를 클릭합니다.

    리포지토리에 대한 "가져오기/내보내기" 페이지의 스크린샷. "특성 초대"라는 레이블이 지정된 탭은 진한 주황색으로 표시됩니다.

Git 커밋에 대한 작성 관리

Git 커밋 작성은 마네킹과 연결되지 않으며 마네킹을 회수하여 GitHub 사용자에게 귀속할 수 없습니다. 대신 커밋 작성자는 Git에서 커밋을 작성하는 데 사용된 이메일 주소를 기반으로 GitHub의 사용자 계정에 귀속됩니다.

대부분의 경우 사용자는 GitHub에서 사용자 계정에 커밋을 작성하는 데 사용되는 이메일 주소를 추가하여 커밋을 재귀속할 수 있습니다. 자세한 내용은 "GitHub 계정에 메일 주소 추가"을(를) 참조하세요.

그러나 Enterprise Managed Users을(를) 사용하는 경우 사용자는 GitHub의 사용자 계정에 이메일 주소를 추가할 수 없으므로 Git 커밋을 재귀속할 수 없습니다. ID 공급자(IdP)의 사용자 기본 이메일 주소에 따라 작성한 커밋만 관리형 사용자 계정에 귀속됩니다.

또한, 사용자 계정에 noreply 이메일 주소를 수동으로 추가할 수 없으므로 GitHub에서 제공한 noreply 이메일 주소로 작성된 커밋은 재귀속될 수 없습니다. 자세한 내용은 "커밋 메일 주소 설정"을(를) 참조하세요.