Migrar dados para a sua empresa

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_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

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.
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

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
```

Explorar por produto