Migración de repositorios desde GitHub.com a GitHub Enterprise Cloud

Acerca de las migraciones de repositorios con GitHub Enterprise Importer

Las migraciones a GitHub Enterprise Cloud incluyen migraciones entre cuentas en GitHub.com y, si estás adoptando diferente residencia, migraciones al subdominio de tu empresa de GHE.com.

Puedes ejecutar la migración con la GitHub CLI o la API.

La GitHub CLI simplifica el proceso de migración y se recomienda para la mayoría de los clientes. Los clientes avanzados con necesidades de personalización intensivas pueden usar la API para crear sus propias integraciones con GitHub Enterprise Importer.

A fin de ver instrucciones para usar la API, utiliza el conmutador de herramientas en la parte superior de la página.

Para ver instrucciones de uso de la GitHub CLI, usa el conmutador de herramientas en la parte superior de la página.

Requisitos previos

Se recomienda encarecidamente realizar una ejecución de prueba de la migración y completar la migración de producción poco después. Para más información sobre las ejecuciones de prueba, consulta "Introducción a una migración entre productos de GitHub".
Asegúrate de comprender los datos que se migrarán y las limitaciones de compatibilidad conocidas del importador. Para obtener más información, consulte "Acerca de las migraciones entre productos de GitHub".
Aunque no es necesario, se recomienda detener el trabajo durante la migración de producción. Importer no admite migraciones diferenciales, por lo que los cambios que se produzcan durante la migración no se migrarán. Si decides no detener el trabajo durante la migración de producción, tendrás que migrar manualmente estos cambios.
En las organizaciones de origen y destino, debes ser propietario de la organización o tener el rol de migración. Para obtener más información, vea «Administración del acceso para una migración entre productos de GitHub».

Paso 0: Preparación para usar GraphQL API de GitHub

Para realizar consultas de GraphQL, tendrás que escribir scripts propios, o bien usar un cliente HTTP como Insomnia.

Para más información sobre cómo empezar a trabajar con GraphQL API de GitHub, incluido cómo autenticarse, consulta "Formar llamados con GraphQl".

Enviarás todas las consultas de GraphQL al destino de tu migración. Si vas a migrar a Nube de GitHub Enterprise con residencia de datos, asegúrate de enviar consultas al punto de conexión del subdominio de la empresa de GHE.com.

Paso 1: Obtención de `ownerId` para el destino de la migración

Como propietario de la organización en GitHub Enterprise Cloud, usa la consulta GetOrgInfo para devolver ownerId, también denomino id. de organización, para la organización que quieras que posea los repositorios migrados. Necesitarás el valor ownerId para identificar el destino de la migración.

Consulta `GetOrgInfo`

query(
  $login: String!
){
  organization (login: $login)
  {
    login
    id
    name
    databaseId
  }
}

Variable de consulta	Descripción
`login`	El nombre de la organización.

Respuesta `GetOrgInfo`

{
  "data": {
    "organization": {
      "login": "Octo",
      "id": "MDEyOk9yZ2FuaXphdGlvbjU2MTA=",
      "name": "Octo-org",
      "databaseId": 5610
    }
  }
}

En este ejemplo, MDEyOk9yZ2FuaXphdGlvbjU2MTA= es el id. de la organización o ownerId, que se usará en el paso siguiente.

Paso 2: Identificación del origen de la migración

Puedes configurar un origen de migración mediante la consulta createMigrationSource. Tendrás que proporcionar el valor ownerId, o id. de organización, recopilado de la consulta GetOrgInfo.

El origen de la migración es una organización en GitHub.com.

Mutación `createMigrationSource`

mutation createMigrationSource($name: String!, $ownerId: ID!) {
  createMigrationSource(input: {name: $name, url: "https://github.com", ownerId: $ownerId, type: GITHUB_ARCHIVE}) {
    migrationSource {
      id
      name
      url
      type
    }
  }
}

Nota: Asegúrate de usar GITHUB_ARCHIVE para type.

Variable de consulta	Descripción
`name`	Nombre para el origen de la migración. Este nombre es para referencia propia, por lo que puedes usar cualquier cadena.
`ownerId`	El id. de la organización en GitHub Enterprise Cloud.

Respuesta `createMigrationSource`

{
  "data": {
    "createMigrationSource": {
      "migrationSource": {
        "id": "MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA",
        "name": "GitHub.com Source",
        "url": "https://github.com",
        "type": "GITHUB_SOURCE"
      }
    }
  }
}

En este ejemplo, MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA es el id. de origen de la migración, que se usará en el paso siguiente.

Paso 3: Inicio de la migración del repositorio

Al iniciar una migración, un único repositorio y sus datos adjuntos se migran a un repositorio nuevo de GitHub que identifiques.

Si quieres mover varios repositorios a la vez desde la misma organización de origen, puedes poner en cola varias migraciones. Puedes ejecutar hasta cinco migraciones de repositorio a la vez.

Mutación `startRepositoryMigration`

mutation startRepositoryMigration (
  $sourceId: ID!,
  $ownerId: ID!,
  $sourceRepositoryUrl: URI!,
  $repositoryName: String!,
  $continueOnError: Boolean!,
  $accessToken: String!,
  $githubPat: String!,
  $targetRepoVisibility: String!
){
  startRepositoryMigration( input: {
    sourceId: $sourceId,
    ownerId: $ownerId,
    repositoryName: $repositoryName,
    continueOnError: $continueOnError,
    accessToken: $accessToken,
    githubPat: $githubPat,
    targetRepoVisibility: $targetRepoVisibility
    sourceRepositoryUrl: $sourceRepositoryUrl,
  }) {
    repositoryMigration {
      id
      migrationSource {
        id
        name
        type
      }
      sourceUrl
    }
  }
}

Variable de consulta	Descripción
`sourceId`	El origen de migración `id` devuelto por la mutación `createMigrationSource`.
`ownerId`	El id. de la organización en GitHub Enterprise Cloud.
`repositoryName`	Un nombre de repositorio único personalizado que actualmente no se use en ninguno de los repositorios propiedad de la organización en GitHub Enterprise Cloud. Se creará una incidencia de registro de errores en este repositorio cuando se complete la migración o se haya detenido.
`continueOnError`	Valor de migración que permite que continúe al encontrar errores que no hacen que se produzca un error en la migración. Debe ser `true` o `false`. Se recomienda encarecidamente establecer `continueOnError` en `true` para que la migración continúe a menos que Importer no pueda mover el origen de Git o Importer haya perdido la conexión y no se pueda volver a conectar para completar la migración.
`githubPat`	El valor personal access token de la organización de destino en GitHub Enterprise Cloud.
`accessToken`	El valor personal access token para el origen.
`targetRepoVisibility`	La visibilidad del nuevo repositorio. Debe ser `private`, `public` o `internal`. Si no se establece, el repositorio se migra como privado.
`sourceRepositoryUrl`	URL del repositorio de origen, con el formato `https://github.com/{organization}/{repository}`.

Para obtener los requisitos de personal access token, consulte "Administración del acceso para una migración entre productos de GitHub".

En el paso siguiente, usarás el id. de migración devuelto por la mutación startRepositoryMigration para comprobar el estado de la migración.

Paso 4: Comprobación del estado de la migración

Para detectar errores de migración y asegurarse de que la migración funciona, puedes comprobar el estado de la migración mediante la consulta getMigration. También puedes comprobar el estado de varias migraciones con getMigrations.

La consulta getMigration devolverá con un estado para que sepas si la migración es queued, in progress, failed o completed. Si se ha producido un error en la migración, en Importer se proporcionará un motivo para el error.

Consulta `getMigration`

query (
  $id: ID!
){
  node( id: $id ) {
    ... on Migration {
      id
      sourceUrl
      migrationSource {
        name
      }
      state
      failureReason
    }
  }
}

Variable de consulta	Descripción
`id`	El valor `id` de la migración que ha devuelto la mutación `startRepositoryMigration`.

Paso 5: Validación de la migración y comprobación del registro de errores

Para finalizar la migración, se recomienda comprobar la incidencia "Registro de migración". Esta incidencia se crea en GitHub en el repositorio de destino.

Captura de pantalla de una incidencia con el título "Registro de migración". El segundo comentario de la incidencia incluye registros para una migración.

Por último, se recomienda revisar los repositorios migrados para obtener una comprobación de solidez.

Paso 1: Instalación de la GEI extension of the GitHub CLI

Si se trata de la primera migración, tendrás que instalar la GEI extension of the GitHub CLI. Para más información sobre la GitHub CLI, consulta "Acerca del CLI de GitHub".

Como alternativa, puede descargar un binario independiente desde la página de versiones del repositorio github/gh-gei. Puede ejecutar el archivo binario directamente, sin el prefijo gh.

Instala la GitHub CLI. A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.

Nota: Necesitas la versión 2.4.0 o posterior de la GitHub CLI. Puedes comprobar la versión instalada con el comando gh --version.

Instalación de la GEI extension.

Shell

gh extension install github/gh-gei

gh extension install github/gh-gei

Cada vez que necesites ayuda con la GEI extension, puedes usar la marca --help con un comando. Por ejemplo, gh gei --help enumerará todos los comandos disponibles y gh gei migrate-repo --help todas las opciones disponibles para el comando migrate-repo.

Paso 2: Actualización de la GEI extension of the GitHub CLI

La GEI extension se actualiza semanalmente. Para asegurarte de que usas la versión más reciente, actualiza la extensión.

gh extension upgrade github/gh-gei

Paso 3: Establecimiento de variables de entorno

Para poder usar la GEI extension para la migración a GitHub Enterprise Cloud, debes crear instancias de personal access token que puedan acceder a las organizaciones de origen y destino y, después, establecer las instancias de personal access token como variables de entorno.

Crea y registra una instancia de personal access token (classic) que se autenticará para la organización de destino en GitHub Enterprise Cloud, y asegúrate de que el token cumple todos los requisitos. Para obtener más información, vea «Administración del acceso para una migración entre productos de GitHub».
Crea y registra una instancia de personal access token que se autenticará para la organización de origen, y asegúrate de que este token también cumple todos los mismos requisitos.
Establece variables de entorno para personal access token, y reemplaza TOKEN en los comandos siguientes por los valores personal access token que has registrado antes. Usa GH_PAT para la organización de destino y GH_SOURCE_PAT para la de origen.
- Si usas Terminal, utiliza el comando export.
  Shell
```
export GH_PAT="TOKEN"
export GH_SOURCE_PAT="TOKEN"
```
```
export GH_PAT="TOKEN"
export GH_SOURCE_PAT="TOKEN"
```
- Si usas PowerShell, utiliza el comando $env.
  Shell
```
$env:GH_PAT="TOKEN"
$env:GH_SOURCE_PAT="TOKEN"
```
```
$env:GH_PAT="TOKEN"
$env:GH_SOURCE_PAT="TOKEN"
```
Si vas a migrar a Nube de GitHub Enterprise con residencia de datos, para mayor comodidad, establece una variable de entorno para la dirección URL de la API base para tu empresa. Por ejemplo:
Shell
```
export TARGET_API_URL="https://api.octocorp.ghe.com"
```
```
export TARGET_API_URL="https://api.octocorp.ghe.com"
```
Usarás esta variable con la opción --target-api-url en los comandos que ejecutes con la GitHub CLI.

Paso 4: Generación de un script de migración

Si quieres migrar varios repositorios a GitHub Enterprise Cloud a la vez, usa la GitHub CLI para generar un script de migración. El script resultante contendrá una lista de comandos de migración, uno por cada repositorio.

Nota: La generación de un script genera un script de PowerShell. Si usas Terminal, tendrás que generar el script con la extensión de archivo .ps1 e instalar PowerShell para Mac o Linux para ejecutarlo.

Si quieres migrar un único repositorio, pasa al paso siguiente.

Generación de un script de migración

Para generar un script de migración, ejecuta el comando gh gei generate-script.

Shell

gh gei generate-script --github-source-org SOURCE --github-target-org DESTINATION --output FILENAME

gh gei generate-script --github-source-org SOURCE --github-target-org DESTINATION --output FILENAME

Si descargó GEI como un binario independiente en lugar de como una extensión para los GitHub CLI, deberá actualizar el script generado para ejecutar el binario en lugar de gh gei.

Marcadores de posición

Reemplaza los marcadores de posición del comando anterior por los valores siguientes.

Marcador de posición	Value
SOURCE	Nombre de la organización de origen
DESTINATION	Nombre de la organización de destino
FILENAME	Nombre de archivo para el script de migración resultante Si usas Terminal, utiliza una extensión de archivo `.ps1`, ya que el script generado necesita que se ejecute PowerShell. Puedes instalar PowerShell para Mac o Linux.

Argumentos adicionales

Argumento	Descripción
`--target-api-url TARGET-API-URL`	Si vas a migrar a GHE.com, agrega `--target-api-url TARGET-API-URL`, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: `https://api.octocorp.ghe.com`.
`--download-migration-logs`	Descarga el registro de migración para cada repositorio migrado. Para más información sobre los registros de migración, consulta "Acceso a los registros de migración para GitHub Enterprise Importer".

Revisión del script de migración

Después de generar el script, revisa el archivo y, opcionalmente, edita el script.

Si hay repositorios que no quieras migrar, elimina o convierte en comentario las líneas correspondientes.
Si quieres que los repositorios tengan otro nombre en la organización de destino, actualiza el valor de la marca --target-repo correspondiente.
Si desea cambiar la visibilidad del nuevo repositorio, actualice el valor de la marca --target-repo-visibility correspondiente. De manera predeterminada, el script establece la misma visibilidad que el repositorio de origen.

Si el repositorio tiene más de 10 GB de datos de versiones, las versiones no se pueden migrar. Usa la marca --skip-releases para migrar el repositorio sin versiones.

Si descargó GEI como un binario independiente en lugar de como una extensión para los GitHub CLI, deberá actualizar el script generado para ejecutar el binario en lugar de gh gei.

Paso 5: Migración de repositorios

Puedes migrar varios repositorios con un script de migración, o bien un único repositorio con el comando gh gei migrate-repo.

Migración de varios repositorios

Para migrar varios repositorios, ejecuta el script que has generado antes. Reemplaza FILENAME en los comandos siguientes por el nombre de archivo que has proporcionado al generar el script.

Si usas Terminal, utiliza ./.
Shell
```
./FILENAME
```
```
./FILENAME
```
Si usas PowerShell, utiliza .\.
Shell
```
.\FILENAME
```
```
.\FILENAME
```

Migración de un único repositorio

Para migrar un único repositorio, usa el comando gh gei migrate-repo.

Shell

gh gei migrate-repo --github-source-org SOURCE --source-repo CURRENT-NAME --github-target-org DESTINATION --target-repo NEW-NAME

gh gei migrate-repo --github-source-org SOURCE --source-repo CURRENT-NAME --github-target-org DESTINATION --target-repo NEW-NAME

Marcadores de posición

Reemplaza los marcadores de posición del comando anterior por los valores siguientes.

Marcador de posición	Value
SOURCE	Nombre de la organización de origen
CURRENT-NAME	Nombre del repositorio que quieres migrar
DESTINATION	Nombre de la organización de destino
NEW-NAME	Nombre que quieres que tenga el repositorio migrado

Argumentos adicionales

Argumento	Descripción
`--target-api-url TARGET-API-URL`	Si vas a migrar a GHE.com, agrega `--target-api-url TARGET-API-URL`, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: `https://api.octocorp.ghe.com`.
`--skip-releases`	Si el repositorio tiene más de 10 GB de datos de versiones, las versiones no se pueden migrar. Usa la marca `--skip-releases` para migrar el repositorio sin versiones.
`--target-repo-visibility TARGET-VISIBILITY`	Los repositorios se migran con visibilidad privada de manera predeterminada. Para establecer la visibilidad, puede agregar la marca `--target-repo-visibility`; para ello, debe especificar `private`, `public` o `internal`. Si va a migrar a una empresa con usuarios administrados, los repositorios públicos no están disponibles.

Cancelación de la migración

Si deseas cancelar una migración, usa el comando abort-migration, reemplazando MIGRATION-ID por el identificador devuelto de migrate-repo.

Shell

gh gei abort-migration --migration-id MIGRATION-ID

gh gei abort-migration --migration-id MIGRATION-ID

Paso 6: Validación de la migración y comprobación del registro de errores

Una vez que se complete la migración, se recomienda revisar el registro de migración. Para obtener más información, vea «Acceso a los registros de migración para GitHub Enterprise Importer».

Se recomienda revisar los repositorios migrados para obtener una comprobación de solidez.

Migración de repositorios desde GitHub.com a GitHub Enterprise Cloud

Tool navigation

En este artículo

Acerca de las migraciones de repositorios con GitHub Enterprise Importer

Requisitos previos

Paso 0: Preparación para usar GraphQL API de GitHub

Paso 1: Obtención de `ownerId` para el destino de la migración

Consulta `GetOrgInfo`

Respuesta `GetOrgInfo`

Paso 2: Identificación del origen de la migración

Mutación `createMigrationSource`

Respuesta `createMigrationSource`

Paso 3: Inicio de la migración del repositorio

Mutación `startRepositoryMigration`

Paso 4: Comprobación del estado de la migración

Consulta `getMigration`

Paso 5: Validación de la migración y comprobación del registro de errores

Paso 1: Instalación de la GEI extension of the GitHub CLI

Paso 2: Actualización de la GEI extension of the GitHub CLI

Paso 3: Establecimiento de variables de entorno

Paso 4: Generación de un script de migración

Generación de un script de migración

Marcadores de posición

Argumentos adicionales

Revisión del script de migración

Paso 5: Migración de repositorios

Migración de varios repositorios

Migración de un único repositorio

Marcadores de posición

Argumentos adicionales

Cancelación de la migración

Paso 6: Validación de la migración y comprobación del registro de errores