Aplicar os dados importados em GitHub Enterprise Server
Antes de migrar dados para seu GitHub Enterprise Server, você deve prepará-los e resolver quaisquer conflitos. Para obter mais informações, confira "Preparação para migrar dados para o GitHub Enterprise Server".
Depois de preparar os dados e os conflitos de resolução, você poderá aplicar os dados importados em GitHub.
- Como administrador do site, use o SSH para entrar na sua instância do GitHub Enterprise Server.
ssh -p 122 admin@HOSTNAME
-
Usando o comando
ghe-migrator import
, inicie o processo de importação. Você precisará de:- Seu Migration GUID. Para obter mais informações, confira "Preparação para migrar dados para o GitHub Enterprise Server".
- Seu personal access token para autenticação. O personal access token que você usa se destina apenas à autenticação como administrador do site e não exige nenhum escopo específico ou permissões. Para obter mais informações, confira "Gerenciar seus tokens 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 preparados, acrescente
--staging-path=/full/staging/path
ao comando. Assume o padrão de/data/user/tmp
.
Revisar dados de migração
Por padrão, ghe-migrator audit
retorna todos os registros. Também é possível filtrar os registros por:
- Tipos de registro;
- Estado de registro.
Os tipos de registros 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 |
Teams | team |
Marcos | milestone |
Quadros de projeto | project |
Problemas | issue |
Comentários dos problemas | issue_comment |
Solicitações de pull | 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
, você pode filtrar os registros com base no tipo usando o sinalizador -m
. Da mesma forma, você pode filtrar o estado de importação usando o sinalizador -s
. O comando se parece 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
Recomendamos fortemente auditar todas as importações com falha. Para fazer isso, você vai inserir:
$ 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.
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
-
Conecte-se via SSH ao GitHub.com. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Para obter mais informações sobre o acesso SSH, confira "Acesar 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
Aviso: se o repositório contiver fluxos de trabalho do GitHub Actions usando o gatilho schedule
, esses fluxos de trabalho não serão executados automaticamente após uma importação. Para iniciar os fluxos de trabalho agendados mais uma vez, envie uma confirmação para o repositório. Para obter mais informações, confira "Eventos que disparam fluxos de trabalho".
Desbloquear repositórios na origem
Desbloquear repositórios de uma organização no GitHub.com
Para desbloquear os 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á de:
- Token de acesso para autenticação;
- A
id
exclusiva da migração - Nome do repositório a ser desbloqueado.
curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
-H "Accept: application/vnd.github.wyandotte-preview+json" \
https://api.github.com/orgs/ORG-NAME/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 já migrados usando o ponto de extremidade de exclusão do repositório. Você precisará do token de acesso para autenticação:
curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
https://api.github.com/repos/ORG-NAME/REPO_NAME
Desbloquear repositórios de uma instância do GitHub Enterprise Server
-
Conecte-se via SSH ao GitHub.com. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Para obter mais informações sobre o acesso SSH, confira "Acesar 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