Migración de datos a GitHub Enterprise Server

Aplicar los datos importados en GitHub Enterprise Server

Antes de que puedas migrar los datos a GitHub Enterprise Server, debes prepararlos y resolver cualquier conflicto. Para obtener más información, vea «Preparación para migrar datos a GitHub Enterprise Server».

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

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 obtener más información, vea «Preparación para migrar datos a GitHub Enterprise Server».
- personal access token para la autenticación. Los datos personal access token que se usan solo son para la autenticación como administrador del sitio y no requieren ningún ámbito específico o permisos. Para obtener más información, vea «Administración de tokens 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 técnico para 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 GitHub.com 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 más información sobre el acceso SSH, consulta "Acceder al shell administrativo (SSH)".
```
ssh -p 122 admin@HOSTNAME
```
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

Advertencia: Si el repositorio contiene flujos de trabajo GitHub Actions que usan el desencadenador schedule, los flujos de trabajo no se ejecutarán automáticamente después de una importación. Para volver a iniciar los flujos de trabajo programados, suba una confirmación en el repositorio. Para obtener más información, vea «Eventos que desencadenan flujos de trabajo».

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/ORG-NAME/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/ORG-NAME/REPO_NAME

Desbloquear repositorios desde una instancia de GitHub Enterprise Server

SSH en GitHub.com 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 más información sobre el acceso SSH, consulta "Acceder al shell administrativo (SSH)".
```
ssh -p 122 admin@HOSTNAME
```
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

Migración de datos a GitHub Enterprise Server

En este artículo