Esta versão do GitHub Enterprise foi descontinuada em 2021-06-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Migrar dados para a sua empresa

Após gerar um arquivo de migração, você poderá importar os dados para a sua instância de destino do GitHub Enterprise Server. Antes de aplicar as alterações permanentemente na instância de destino, será possível revisá-las para resolver possíveis conflitos.

Aplicar os dados importados em GitHub Enterprise Server

Após haver preparado a sua migração você poderá usar os seguintes passos para concluir a migração.

  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:

    $ 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

Tipo de registroNome do filtro
Usuáriosusuário
Organizaçõesorganização
Repositóriosrepositório
Equipesequipe
Marcosmarco
Quadros de projetoproject
Problemasproblema
Comentários dos problemasissue_comment
Pull requestspull_request
Revisões de pull requestpull_request_review
Comentários de commitcommit_comment
Comentários das revisões de pull requestpull_request_review_comment
Versõesversão
Ações feitas em problemas ou em pull requestsissue_event
Branches protegidosprotected_branch

Filtros por estado de registro

Estado de registroDescrição
exportO registro será exportado.
importO registro será importado.
mapO registro será mapeado.
renameO registro será renomeado.
mergeO registro passará por merge.
exportedO registro foi exportado com êxito.
importedO registro foi importado com êxito.
mappedO registro foi mapeado com êxito.
renamedO registro foi renomeado com êxito.
mergedO registro passou por merge com êxito.
failed_exportHouve falha ao exportar o registro.
failed_importHouve falha ao importar o registro.
failed_mapHouve falha ao mapear o registro.
failed_renameHouve falha ao renomear o registro.
failed_mergeHouve falha ao fazer merge no 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 sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Acessar o shell administrativo (SSH)".
    $ 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

Após desbloquear os repositórios da organização de GitHub.com, você deverá excluir todos os repositórios previamente migrados usando o ponto de extremidade de exclusão do repositório. 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 sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Acessar o shell administrativo (SSH)".
    $ 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