Migrar datos a tu empresa

Aplicar los datos importados en GitHub Enterprise Server

Antes de que puedas migrar los datos a tu empresa, debes prepararlos y resolver cualquier conflicto. Para más información, vea "Preparación para migrar datos a la empresa".

Después de que prepares los datos y resuelvas conflictos, puedes aplicar los datos importados en GitHub Enterprise Server.

Como administrador del sitio, acceda mediante SSH a la instancia de GitHub Enterprise Server de destino.
```
$ ssh -p 122 admin@HOSTNAME
```
Con el comando ghe-migrator import, inicie el proceso de importación. Necesitará:
- El GUID de migración. Para más información, vea "Preparación para migrar datos a la empresa".
- Tu token de acceso personal para autenticación. El token de acceso personal que utilices es solo para autenticación como administrador de sitio, y no requiere ningún alcance específico. Para más información, vea "Creación de un token de acceso personal".
```
$ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN

> Starting GitHub::Migrator
> Import 100% complete /
```
- Para especificar dónde se deben almacenar provisionalmente los archivos de migración, anexe --staging-path=/full/staging/path al comando. Tiene como valor predeterminado /data/user/tmp.

Revisar datos de migración

De forma predeterminada, ghe-migrator audit devuelve todos los registros. También te permite filtrar los registros por:

Los tipos de registros.
El estado de los registros.

Los tipos de registro coinciden con los encontrados en los datos migrados.

Filtros de tipo de registro

Tipo de registro	Nombre de filtro
Usuarios	`user`
Las organizaciones	`organization`
Repositorios	`repository`
Teams	`team`
Hitos	`milestone`
Tableros de proyecto	`project`
Issues	`issue`
Comentarios de propuestas	`issue_comment`
Solicitudes de incorporación de cambios	`pull_request`
Revisiones de solicitudes de extracción	`pull_request_review`
Comentarios sobre confirmación de cambios	`commit_comment`
Comentarios sobre revisiones de solicitudes de extracción	`pull_request_review_comment`
Versiones	`release`
Medidas adoptadas en las solicitudes de extracción o propuestas	`issue_event`
Ramas protegidas	`protected_branch`

Filtros de estado de registro

Estado de registro	Descripción
`export`	El registro se exportará.
`import`	El registro se importará.
`map`	El registro se asignará.
`rename`	El registro se renombrará.
`merge`	El registro se fusionará.
`exported`	El registro se exportó con éxito.
`imported`	El registro se importó con éxito.
`mapped`	El registro se asignó con éxito.
`renamed`	El registro se renombró con éxito.
`merged`	El registro se fusionó con éxito.
`failed_export`	El registro no se pudo exportar.
`failed_import`	El registro no se pudo importar.
`failed_map`	El registro no se pudo asignar.
`failed_rename`	El registro no se pudo renombrar.
`failed_merge`	El registro no se pudo fusionar.

Filtrar registros auditados

Con el comando ghe-migrator audit, puede filtrar según el tipo de registro mediante la marca -m. Del mismo modo, puede filtrar por el estado de importación mediante la marca -s. El comando tiene este aspecto:

$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID

Por ejemplo, para ver cada organización y equipo importados con éxito, debes ingresar:

$ 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

Se recomienda encarecidamente auditar todas las importaciones con errores. Para ello, escribirá lo siguiente:

$ 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

Si tienes alguna duda sobre las importaciones fallidas, comunícate con Soporte de GitHub Enterprise.

Completar la importación en GitHub Enterprise Server

Después de que se aplique tu migración a tu instancia destino y la hayas revisado, desbloquearás los repositorios y los borrarás del origen. Antes de eliminar los datos de origen, se recomienda esperar alrededor de dos semanas para asegurarse de que todo funciona de acuerdo con lo esperado.

Desbloquear repositorios en la instancia de destino

SSH en your GitHub Enterprise Server instance. Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Para obtener más información acerca del acceso a SSH, consulta "Acceso al shell administrativo (SSH)".
```
$ ssh -p 122 admin@HOSTNAME
```
1. Desbloquee todos los repositorios importados con el comando `ghe-migrator unlock`. Nececitarás tu GUID de Migración:
```
$ ghe-migrator unlock -g MIGRATION_GUID
> Unlocked octo-org/octo-project
```

Desbloquear repositorios en el origen

Desbloquear los repositorios de una organización en GitHub.com

Para desbloquear los repositorios en una organización de GitHub.com, enviará una solicitud DELETE al punto de conexión de desbloqueo de migración. Necesitará:

Tu token de acceso para autenticación
id único de la migración

El nombre del repositorio a desbloquear

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

Borrar los repositorios de una organización en GitHub.com

Después de desbloquear los repositorios de la organización de GitHub.com, tendrá que borrar todos los repositorios que haya migrado antes mediante el punto de conexión de eliminación de repositorios. Necesitarás tu token de acceso para la autenticación:

curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
  https://api.github.com/repos/orgname/repo_name

Desbloquear repositorios desde una instancia de GitHub Enterprise Server

SSH en your GitHub Enterprise Server instance. Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Para obtener más información acerca del acceso a SSH, consulta "Acceso al shell administrativo (SSH)".
```
$ ssh -p 122 admin@HOSTNAME
```
1. Desbloquee todos los repositorios importados con el comando `ghe-migrator unlock`. Nececitarás tu GUID de Migración:
```
$ ghe-migrator unlock -g MIGRATION_GUID
> Unlocked octo-org/octo-project
```