Migrar dados para a sua empresa

Aplicar os dados importados em GitHub Enterprise Server

1. Como administrador do site, SSH into your target GitHub Enterprise Server instance.

   $ ssh -p 122 admin@HOSTNAME

2. Usando o comando ghe-migrator import, comece o processo de importação. Você precisará do seguinte:

   • Seu Migration GUID.
   • Seu token de acesso pessoal para autenticação. O token de acesso pessoal que você usa é apenas para autenticação como administrador do site e não requer nenhum escopo específico. Para mais informação, consulte "Criando um token de acesso pessoal."

   $ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN
   
   > Starting GitHub::Migrator
   > Import 100% complete /

   • Para especificar o local em que os arquivos de migração devem ser executados, acrescente o comando com --staging-path=/full/staging/path. O padrão é /data/user/tmp.

Revisar dados de migração

Por padrão, o ghe-migrator audit devolve todos os registros. Também é possível filtrar os registros por:

• Tipos de registro;
• Estado de registro.

Os tipos de registro correspondem aos encontrados nos dados migrados.

Filtros por tipo de registro

Filtros por estado de registro

Filtrar registros auditados

Com o comando ghe-migrator audit, é possível filtrar com base no tipo de registro usando o sinalizador -m. Da mesma forma, você pode filtrar no estado de importação usando o sinalizador -s. O comando fica parecido com o seguinte:

$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID

Por exemplo, para visualizar todas as organizações e equipes importadas com êxito, você digitaria:

$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed

É altamente recomendável fazer auditoria em todas as importações que tiveram falha. Para fazer isso, insira:

$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed

Em caso de problemas com falhas na importação, entre em contato com o Suporte do GitHub Enterprise ou Suporte do GitHub Premium.

Concluir a importação em GitHub Enterprise Server

Depois que sua migração for aplicada à sua instância de destino e você tiver revisado a migração, você desbloqueará os repositórios e os excluirá da fonte. Antes de excluir os dados da origem, é recomendável aguardar cerca de duas semanas para garantir o funcionamento adequado de todos os procedimentos.

Desbloquear repositórios na instância de destino

1. SSH em your GitHub Enterprise Server instance.

   $ ssh -p 122 admin@HOSTNAME

2. Desbloqueie todos os repositórios importados com o comando ghe-migrator unlock. Você precisará de sua GUID de Migração:

   $ ghe-migrator unlock -g MIGRATION_GUID
   > Unlocked octo-org/octo-project

Desbloquear repositórios na origem

Desbloquear repositórios de uma organização no GitHub.com

Para desbloquear repositórios em uma organização do GitHub.com, você enviará uma solicitação DELETE para o ponto de extremidade de desbloqueio da migração. Você precisará do seguinte:

• Token de acesso para autenticação.
• id exclusivo da migração;
• Nome do repositório a ser desbloqueado.

  curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \
    -H "Accept: application/vnd.github.wyandotte-preview+json" \
    https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock

Excluir repositórios de uma organização no GitHub.com

Depois de desbloquear os repositórios da organização do GitHub.com, você deve excluir todos os repositórios migrados anteriormente usando o endpoint de exclusão de repositórios. Você precisará do token de acesso para autenticação:

curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \
  https://api.github.com/repos/orgname/repo_name

Desbloquear repositórios de uma instância do GitHub Enterprise Server

1. SSH em your GitHub Enterprise Server instance.

   $ ssh -p 122 admin@HOSTNAME

2. Desbloqueie todos os repositórios importados com o comando ghe-migrator unlock. Você precisará de sua GUID de Migração:

   $ ghe-migrator unlock -g MIGRATION_GUID
   > Unlocked octo-org/octo-project