Skip to main content

Como recuperar manequins no GitHub Enterprise Importer

Após a migração, você pode atribuir o histórico de uma identidade de espaço reservado, ou manequim, a um membro da organização.

Quem pode usar esse recurso?

Organization owners can reclaim mannequins.

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.

Captura de tela do cabeçalho de um comentário de problema. O autor do comentário é rotulado manequim, e o rótulo "Manequim" é contornado em laranja escuro.

Você pode atribuir novamente o histórico de cada manequim a um membro da organização com a GitHub CLI ou em seu navegador. Se você usar a GitHub CLI, poderá recuperar manequins em massa.

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 os manequins com a GitHub CLI (recomendado) ou o navegador.

Por padrão, recuperar um manequim enviará um convite de atribuição ao usuário de destino.

O usuário de destino pode optar por aceitar ou rejeitar o convite. Depois que um usuário aceitar um convite de atribuição, todas as contribuições atribuídas anteriormente ao manequim serão atribuídas ao usuário. Em migrações futuras para a mesma organização, todas as contribuições do mesmo manequim serão recuperadas automaticamente para o mesmo usuário.

Se sua organização usa o Enterprise Managed Users e você opta por recuperar manequins com a GitHub CLI, você tem a opção de ignorar o processo de convite, recuperando imediatamente o manequim sem a aprovação do usuário.

Note

  • Você não pode recuperar manequins depois de transferir um repositório para outra organização. Se você quiser transferir um repositório para outra organização após a migração, deverá recuperar os manequins antes da transferência.
  • Ao recuperar manequins, você só pode segmentar membros existentes 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 GitHub Enterprise Importer não migra o acesso do usuário aos repositórios. Depois de recuperar os manequins, se algum dos usuários ainda não tiver acesso apropriado ao repositório por meio da associação à equipe, você precisará permitir separadamente aos usuários o acesso ao repositório. Para obter mais informações, confira "Como gerenciar o acesso de uma pessoa a um repositório da organização".

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 "Sobre 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 requisitos de personal access token, consulte "Gerenciando o acesso para uma migração entre produtos GitHub".
  • Se você estiver migrando para o GHE.com, adicione --target-api-url TARGET-API-URL, em que TARGET-API-URL é a URL da API base para o subdomínio da sua empresa. Por exemplo: https://api.octocorp.ghe.com.
  1. 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.

  2. 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.

      Se sua organização usar Enterprise Managed Users e você quiser ignorar o convite de atribuição para recuperar o manequim imediatamente, adicione o argumento --skip-invitation.

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

Por padrão, 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 requisitos de personal access token, consulte "Gerenciando o acesso para uma migração do Azure DevOps".
  • Se você estiver migrando para o GHE.com, adicione --target-api-url TARGET-API-URL, em que TARGET-API-URL é a URL da API base para o subdomínio da sua empresa. Por exemplo: https://api.octocorp.ghe.com.
  1. 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.

  2. 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.

      Se sua organização usar Enterprise Managed Users e você quiser ignorar o convite de atribuição para recuperar o manequim imediatamente, adicione o argumento --skip-invitation.

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

Por padrão, 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

  1. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

  2. Ao lado da organização, clique em Configurações.

  3. Na seção "Acesso" da barra lateral, clique em Importação/Exportação.

  4. À direita do manequim que deseja recuperar, clique em Reatribuir.

  5. 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.

    Note

    Você só pode enviar convites de atribuição para as contas de usuário que já são membros da organização.

  6. Clique em Convidar. Por padrão, 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 recebeu um convite, mas ainda não respondeu ao convite.
  • Concluído: o usuário aceitou ou o processo de convite foi ignorado. As contribuições do usuário foram reatribuídas.
  • Rejeitado: o usuário optou por não ser creditado pelas contribuições do manequim.
  1. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

  2. Ao lado da organização, clique em Configurações.

  3. Na seção "Acesso" da barra lateral, clique em Importação/Exportação.

  4. Em " Importação/Exportação", clique em Convites de Atribuição.

    Captura de tela da página "Importação/Exportação" de um repositório. Uma guia, rotulada "Convites de Atribuição", está contornada em laranja escuro.

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 "Adicionar endereço de e-mail à sua conta do GitHub".

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".