Skip to main content

Completing your live migration from GitHub Enterprise Server to GHE.com

Complete follow-up tasks so users can start using the migrated repository.

Quem pode usar esse recurso?

Organization owners on GHE.com

Observação

Enterprise Live Migrations is in versão prévia pública and subject to change.

After you have run a migration with the elm CLI tool, there are some follow-up tasks to complete.

Restore users' access

Because GitHub Enterprise Server and GHE.com use different provisioning and authentication systems, organization membership is not carried over between platforms. You will need to add users to the organization before you can reattribute activity to them in a migrated repository.

  1. If you created a new organization for the migration process, add members to the organization. You can do this manually, but many enterprises manage organization membership from their identity provider (IdP) by syncing enterprise teams with IdP groups.
  2. Add organization members to the migrated repositories.

Reattribute activity to users

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. For more information, see Mannequins and user activity.

Once user accounts have been added to the organization on GHE.com, you can invite users to reclaim a mannequin's activity. You can do this in the browser or, with the GEI extension of the GitHub CLI tool, reclaim mannequins in bulk without the invite process.

Reclaiming mannequins in the browser

  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. To the right of the mannequin you want to reclaim, click Reattribute.

  6. In the search field, type the username of the organization member you want to attribute the mannequin's contributions to, then click the member.

    Observação

    You can only send attribution invitations to user accounts that are already members of the organization.

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

Reclaiming mannequins in bulk

You can install the GEI extension of the GitHub CLI to reclaim mannequins in bulk. See Como recuperar manequins no GitHub Enterprise Importer.

Reattribute Git activity

Authorship for Git commits is not associated with mannequins and cannot be attributed to GitHub users by reclaiming mannequins. Instead, commit authorship is attributed to user accounts on GitHub based on the email address that was used to author the commit in Git.

To reattribute Git activity on GHE.com, ensure the user's primary email address in your identity provider (IdP) matches the email address used for their commits. With Enterprise Managed Users, users cannot add email addresses to their user account on GitHub, so users will not be able to reattribute their Git commits independently.

Recreate organization settings

If you created a new organization for the migration process, restore settings such as policies, organization teams, and projects.