Migrar dados para a sua empresa

Aplicar os dados importados em GitHub Enterprise Server

Antes de migrar dados para sua empresa, você deve preparar os dados e resolver quaisquer conflitos. Para obter mais informações, confira "Como se preparar para migrar dados para sua empresa".

Depois de preparar os dados e os conflitos de resolução, você poderá aplicar os dados importados em GitHub Enterprise Server.

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 "Como se 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 obter mais informações, confira "Como criar 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 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 your GitHub Enterprise Server instance. 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 "Como acessar o shell administrativo (SSH)".
```
$ ssh -p 122 admin@HOSTNAME
```
1. 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 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/orgname/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/orgname/repo_name

Desbloquear repositórios de uma instância do GitHub Enterprise Server

Conecte-se via SSH ao your GitHub Enterprise Server instance. 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 "Como acessar o shell administrativo (SSH)".
```
$ ssh -p 122 admin@HOSTNAME
```
1. 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
```