Versão do artigo: Enterprise Server 2.17
Revisar dados de migração
Depois de cada etapa da migração, você pode revisar o estado dos dados migrados. Será possível garantir que os registros estejam sendo mapeados ou renomeados corretamente, obter as novas URLs dos registros após a etapa de importação e listar todos os registros que não foram migrados.
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 | user |
Organizações | organization |
Repositórios | repository |
Equipes | equipe |
Marcos | milestone |
Quadros de projeto | project |
Problemas | issue |
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 | release |
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_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.