Observação: atualmente, o GitHub Enterprise Importer está em versão beta pública e sujeito a alterações.
Sobre os manequins
Depois que você executar uma migração com o GitHub Enterprise Importer, todas as atividades do usuário no repositório migrado (exceto os commits do Git) são atribuídas a identidades de espaço reservado chamadas manequins.
Cada manequim tem apenas um nome de exibição, proveniente do nome de exibição no repositório de origem. Os manequins não têm acesso ao repositório nem associação à organização. Eles sempre usam o mesmo avatar, um octocat fantasma, e incluem um rótulo de manequins seguindo o nome de exibição.
Você pode atribuir novamente o histórico de cada manequim a um membro da organização enviando um convite de atribuição com a GitHub CLI ou no navegador. Se você usar a GitHub CLI, poderá recuperar manequins em massa. Você também pode ver o status de todos os convites de atribuição. Depois que a pessoa aceita o convite, o manequim é recuperado.
A recuperação é opcional e pode ocorrer a qualquer momento após a conclusão de uma migração. Por esse motivo, você pode permitir que a sua equipe comece a trabalhar nos repositórios migrados antes da recuperação.
Os manequins não são usados para atribuição de commit do Git. Para obter mais detalhes sobre a atribuição de commit, confira "Como gerenciar a autoria em commits" abaixo.
Como recuperar manequins
Você pode recuperar um manequim enviando um convite de atribuição para um membro da organização, com a GitHub CLI ou no navegador.
Observação: você só pode enviar convites de atribuição para os membros da organização. Antes de tentar recuperar um manequim, verifique se o usuário do GitHub que você deseja convidar já foi adicionado à organização.
O membro pode optar por aceitar ou rejeitar o convite. Depois que um membro aceitar um convite de atribuição, todas as contribuições atribuídas anteriormente ao manequim serão atribuídas ao membro. Em migrações futuras para a mesma organização, todas as contribuições do mesmo manequim serão recuperadas automaticamente para o mesmo membro.
O GitHub Enterprise Importer não migra o acesso do usuário aos repositórios. Depois de recuperar os manequins, se algum dos membros ainda não tiver acesso apropriado ao repositório por meio da associação à equipe, você precisará permitir separadamente aos membros acesso ao repositório. Para obter mais informações, confira "Como gerenciar o acesso de uma pessoa a um repositório da organização".
Você pode recuperar os manequins com a GitHub CLI (recomendado) ou o navegador.
Como recuperar manequins com a GitHub CLI (recomendado)
Use a GitHub CLI para recuperar manequins individualmente ou em massa. Para obter mais informações sobre como instalar e atualizar extensões de migração para a GitHub CLI, confira "Como migrar repositórios com o GitHub Enterprise Importer".
O comando exato que você precisa usar depende da extensão da GitHub CLI que você está usando.
Como recuperar manequins com a GEI extension
Se a origem de migração for um produto do GitHub, você poderá recuperar manequins com a GEI extension of the GitHub CLI.
Se você ainda não tiver uma variável de ambiente GH_PAT
definida para um personal access token com acesso à organização de destino, adicione --github-target-pat TOKEN
a cada um dos comandos abaixo, substituindo TOKEN
pelo personal access token. Para ver os requisitos do personal access token, confira "Como gerenciar o acesso do GitHub Enterprise Importer".
-
Opcionalmente, para recuperar manequins em massa, crie um arquivo CSV que mapeie os manequins para os membros da organização.
-
Para gerar um arquivo CSV com uma lista de manequins para uma organização, use o comando
gh gei generate-mannequin-csv
, substituindo DESTINATION pela organização de destino e FILENAME pelo nome do arquivo CSV resultante.Opcionalmente, para incluir os manequins que já foram recuperados, adicione o sinalizador
--include-reclaimed
.Shell gh gei generate-mannequin-csv --github-target-org DESTINATION --output FILENAME.csv
-
Edite o arquivo CSV, adicionando o nome de usuário do membro da organização que corresponde a cada manequim.
-
Salve o arquivo.
-
-
Para recuperar manequins, use o comando
gh gei reclaim-mannequin
.-
Para recuperar manequins em massa com o arquivo de mapeamento criado anteriormente, substitua DESTINATION pela organização de destino e FILENAME pelo nome do arquivo de mapeamento.
Shell gh gei reclaim-mannequin --github-target-org DESTINATION --csv FILENAME.csv
-
Para recuperar um manequim individual, substitua DESTINATION pela organização de destino, MANNEQUIN pelo logon do manequim e USERNAME pelo nome de usuário do membro da organização que corresponde ao manequim.
Se houver vários manequins com o mesmo logon, substitua
--mannequin-user MANNEQUIN
por--mannequin-ID ID
, substituindo a ID pela ID do manequim.Shell gh gei reclaim-mannequin --github-target-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME
-
-
O membro da organização receberá um convite por email, e o manequim não será recuperado até que o membro aceite o convite.
Como recuperar manequins com a ADO2GH extension
Se a origem de migração for o Azure DevOps, você poderá recuperar manequins com a ADO2GH extension of the GitHub CLI.
Se você ainda não tiver uma variável de ambiente GH_PAT
definida para um personal access token com acesso à organização de destino, adicione --github-target-pat TOKEN
a cada um dos comandos abaixo, substituindo TOKEN
pelo personal access token. Para ver os requisitos do personal access token, confira "Como gerenciar o acesso do GitHub Enterprise Importer".
-
Opcionalmente, para recuperar manequins em massa, crie um arquivo CSV que mapeie os manequins para os membros da organização.
-
Para gerar um arquivo CSV com uma lista de manequins para uma organização, use o comando
gh ado2gh generate-mannequin-csv
, substituindo DESTINATION pela organização de destino e FILENAME pelo nome do arquivo CSV resultante.Opcionalmente, para incluir os manequins que já foram recuperados, adicione o sinalizador
--include-reclaimed
.Shell gh ado2gh generate-mannequin-csv --github-org DESTINATION --output FILENAME.csv
-
Edite o arquivo CSV, adicionando o nome de usuário do membro da organização que corresponde a cada manequim.
-
Salve o arquivo.
-
-
Para recuperar manequins, use o comando
gh ado2gh reclaim-mannequin
.-
Para recuperar manequins em massa com o arquivo de mapeamento criado anteriormente, substitua DESTINATION pela organização de destino e FILENAME pelo nome do arquivo de mapeamento.
Shell gh ado2gh reclaim-mannequin --github-org DESTINATION --csv FILENAME.csv
-
Para recuperar um manequim individual, substitua DESTINATION pela organização de destino, MANNEQUIN pelo logon do manequim e USERNAME pelo nome de usuário do membro da organização que corresponde ao manequim.
Se houver vários manequins com o mesmo logon, substitua
--mannequin-user MANNEQUIN
por--mannequin-ID ID
, substituindo a ID pela ID do manequim.Shell gh ado2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME
-
-
O membro da organização receberá um convite por email, e o manequim não será recuperado até que o membro aceite o convite.
Como recuperar manequins no navegador
-
No canto superior direito do GitHub Enterprise Server, clique na foto do seu perfil e clique em Suas organizações.
2. Ao lado da organização, clique em Configurações. 1. Na seção "Acesso" da barra lateral, clique em Importação/Exportação. -
À direita do manequim que deseja recuperar, clique em Reatribuir.
-
No campo de pesquisa, digite o nome de usuário do membro da organização ao qual deseja atribuir as contribuições do manequim e clique no membro.
Observação: você só pode enviar convites de atribuição para as contas de usuário que já são membros da organização.
-
Clique em Convidar.
-
O membro da organização receberá um convite por email, e o manequim não será recuperado até que o membro aceite o convite.
Como exibir o status dos convites de atribuição
Você pode ver o status de todos os convites de atribuição da sua organização.
- Convidado: o usuário ainda não respondeu ao convite.
- Concluído: o usuário aceitou e as contribuições deles foram reatribuídas.
- Rejeitado: o usuário optou por não ser creditado pelas contribuições do manequim.
-
No canto superior direito do GitHub Enterprise Server, clique na foto do seu perfil e clique em Suas organizações.
2. Ao lado da organização, clique em Configurações. 1. Na seção "Acesso" da barra lateral, clique em Importação/Exportação. -
Em " Importação/Exportação", clique em Convites de Atribuição.
Como gerenciar a autoria para commits do Git
A autoria para commits do Git não está associada a manequins e não pode ser atribuída aos usuários do GitHub recuperando os manequins. Em vez disso, a autoria de commit é atribuída às contas de usuário do GitHub com base no endereço de email usado para criar o commit no Git.
Em muitos casos, os usuários podem reatribuir commits a si mesmos adicionando o endereço de email usado para criar o commit para a própria conta de usuário no GitHub. Para obter mais informações, confira "Reclaiming mannequins for GitHub Enterprise Importer".
No entanto, se você usar o Enterprise Managed Users, os usuários não poderão adicionar endereços de email à própria conta de usuário no GitHub e, portanto, não poderão reatribuir commits do Git. Somente os commits criados pelo endereço de email principal de um usuário em seu IdP (provedor de identidade) serão atribuídos a contas de usuário gerenciadas.
Além disso, os commits criados por um endereço de email noreply
fornecido pelo GitHub não podem ser reatribuídos, pois você não pode adicionar manualmente um endereço de email noreply
a uma conta de usuário. Para obter mais informações, confira "Configurar o endereço de e-mail do commit".