Concluindo sua migração ao vivo do GitHub Enterprise Server para o GHE.com

Depois de executar uma migração com a ELM CLI ferramenta, há algumas tarefas de acompanhamento a serem concluídas.

Restaurar o acesso dos usuários

Como GitHub Enterprise Server e GHE.com usam sistemas de provisionamento e autenticação diferentes, a associação à organização não é transmitida entre plataformas. Você precisará adicionar usuários à organização antes de poder atribuir novamente a atividade a eles em um repositório migrado.

1. Se você criou uma nova organização para o processo de migração, adicione membros à organização. Você pode fazer isso manualmente, mas muitas empresas gerenciam a associação da organização a partir do seu provedor de identidade (IdP), sincronizando equipes empresariais com grupos do IdP.
2. Adicione membros da organização aos repositórios migrados.

Reatribuir atividade aos usuários

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 Manequins e atividade do usuário.

Depois que as contas de usuário tiverem sido adicionadas à organização na GHE.com, você poderá convidar os usuários para assumir a atividade de um modelo. Você pode fazer isso no navegador ou, com a ferramenta ELM CLI, reivindicar manequins de maneira coletiva sem precisar do processo de convite.

Recuperando manequins em lote usando o ELM CLI

Você pode usar o ELM CLI para recolher manequins em lote.

1. Gere a lista de manequins na migração. O comando a seguir produz um arquivo CSV que mapeia manequins para membros da organização. Opcionalmente, para incluir os manequins que já foram recuperados, adicione o sinalizador --include-reclaimed.

   Shell

   gh target mannequin list ORGANIZATION_NAME
   

   Isso produzirá um arquivo CSV de todos os manequins na organização de destino, no formulário mannequin-user,mannequin-id,target-user:

   ghe-admin,M_kgDOAAw-zw,
   unit-test,M_kgDOAA5FYg,
   admin-octoshift,M_kgDOAA5FZw,
   

2. Envie a saída do comando para um arquivo que você possa editar.

   Shell

   gh elm target mannequin list ORGANIZATION_NAME > MANNEQUINS.csv
   

3. Edite o arquivo CSV, adicionando o nome de usuário do membro da organização que corresponde a cada manequim. Certifique-se de salvar o arquivo depois de editá-lo.

4. Recupere manequins usando o comando mannequin reclaim. Use o ORGANIZATION_NAME e o nome do arquivo da etapa anterior.

   Shell

   gh target mannequin reclaim ORGANIZATION_NAME --csv MANNEQUINS.csv
   

Para obter uma referência completa do comando de recuperação, incluindo opções para controlar convites e solicitações, consulte Referência da CLI do Enterprise Live Migrations.

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

   

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.

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

Para reatribuir a atividade do Git em GHE.com, verifique se o endereço de email primário do usuário em seu provedor de identidade (IdP) corresponde ao endereço de email usado para seus commits. Com Enterprise Managed Users, os usuários não podem adicionar endereços de email à sua conta GitHubde usuário, portanto, os usuários não poderão atribuir novamente suas confirmações do Git de forma independente.

Recriar configurações da organização

Se você criou uma nova organização para o processo de migração, restaure configurações como políticas, equipes da organização e projetos.