Enterprise Server 3.21 está disponível no momento como versão candidata a lançamento.

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.

Neste artigo

          Depois de executar uma migração com GitHub Enterprise Importer ou Enterprise Live Migrations, todas as atividades do usuário no repositório migrado (exceto confirmações do Git) são atribuídas a identidades de espaço reservado chamadas manequins. Para obter mais informações, consulte [AUTOTITLE](/migrations/overview/mannequins-and-user-activity).

Como recuperar manequins

Você pode recuperar manequins com GitHub CLI (recomendado) ou o navegador.

Observação

  • 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 GitHub usuário que você deseja convidar já está adicionado na organização.
          GitHub Enterprise Importer não migra o acesso do usuário para 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](/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository).

Recuperando manequins com o GitHub CLI (recomendado)

Você pode usar o 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 o GitHub CLI, consulte AUTOTITLE.

O comando exato que você precisa usar depende de qual extensão do GitHub CLI que você está usando.

Recuperando manequins com o GEI extension

Se a fonte de migração for um GitHub produto, você poderá recuperar manequins com o 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 personal access token obter requisitos, 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.

Recuperando manequins com o ADO2GH extension

Se a fonte de migração for Azure DevOps, você poderá recuperar manequins com o 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.

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

Restauração de manequins com o BBS2GH extension

Se a fonte de migração for o Servidor Bitbucket, você poderá recuperar manequins com o BBS2GH 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 personal access token obter requisitos, consulte Gerenciar o acesso para uma migração do Bitbucket Server.
  • 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 bbs2gh 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 bbs2gh 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 bbs2gh 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 bbs2gh 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 bbs2gh 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, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na seção "Access" da barra lateral, clique em Import/Export.

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

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

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

Visualizar 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 avatar.

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na seção "Access" da barra lateral, clique em Import/Export.

  5. 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 aba, rotulada "Convites de Atribuição", está destacada em laranja escuro.

Como gerenciar a autoria para commits do Git

A autoria das confirmações no Git não está associada a manequins e não pode ser atribuída aos usuários GitHub pela recuperação dos manequins. Em vez disso, a autoria do commit é atribuída a contas de usuário no GitHub com base no endereço de email que foi 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 à conta de usuário em GitHub. Para saber mais, confira Adicionando um endereço de email à sua conta de GitHub.

No entanto, se você usar Enterprise Managed Users, os usuários não poderão adicionar endereços de email à sua conta GitHub de usuário e, portanto, não poderão atribuir novamente confirmações do Git. Somente as confirmações criadas pelo endereço de email primário de um usuário em seu provedor de identidade (IdP) serão atribuídas a contas de usuário gerenciadas.

Além disso, as confirmações criadas por um GitHubendereço de email fornecido noreply não podem ser atribuídas novamente, pois você não pode adicionar manualmente um noreply endereço de email a uma conta de usuário. Para saber mais, confira Configurar o endereço de e-mail do commit.