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.
-
Como administrador do site, SSH into your target GitHub Enterprise Server instance.
$ ssh -p 122 admin@HOSTNAME -
Usando o comando
ghe-migrator import, comece o processo de importação. Você precisará do seguinte:- Seu Migration GUID. Para obter mais informações, consulte "Preparar para migrar dados para sua empresa".
- 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
| Tipo de registro | Nome do filtro |
|---|---|
| Usuários | usuário |
| Organizações | organização |
| Repositórios | repositório |
| Equipes | equipe |
| Marcos | marco |
| Quadros de projeto | project |
| Problemas | problema |
| Comentários dos problemas | issue_comment |
| Pull requests | pull_request |
| Revisões de pull request | pull_request_review |
| Comentários de commit | commit_comment |
| Comentários das revisões de pull request | pull_request_review_comment |
| Versões | versão |
| Ações feitas em problemas ou em pull requests | issue_event |
| Branches protegidos | protected_branch |
Filtros por estado de registro
| Estado de registro | Descrição |
|---|---|
export | O registro será exportado. |
import | O registro será importado. |
map | O registro será mapeado. |
rename | O registro será renomeado. |
merge | O registro passará por merge. |
exported | O registro foi exportado com êxito. |
imported | O registro foi importado com êxito. |
mapped | O registro foi mapeado com êxito. |
renamed | O registro foi renomeado com êxito. |
merged | O registro passou por merge com êxito. |
failed_export | Houve falha ao exportar o registro. |
failed_import | Houve falha ao importar o registro. |
failed_map | Houve falha ao mapear o registro. |
failed_rename | Houve falha ao renomear o registro. |
failed_merge | Houve 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_GUIDPor 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,failedEm 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
- 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 - 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.
idexclusivo 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_nameDesbloquear repositórios de uma instância do GitHub Enterprise Server
- 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 - 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