# Instalación y configuración de GitHub Enterprise Importer

Instale el ADO2GH extension of the GitHub CLI y configure el entorno para la migración.

## Paso 1: Instalar el ADO2GH extension of the GitHub CLI

GitHub Enterprise Importer es una colección de extensiones para GitHub CLI. Si esta es la primera migración, deberá instalar GitHub CLI y ADO2GH extension.

1. Instale los GitHub CLI.
   * A fin de obtener instrucciones de instalación para GitHub CLI, vea el [repositorio de GitHub CLI](https://github.com/cli/cli#installation).
   * Si ya tiene GitHub CLI instalado, ejecute `gh --version` para asegurarse de que está ejecutando la versión 2.4.0 o posterior. Si tiene una versión anterior, visite el [GitHub CLI repositorio](https://github.com/cli/cli#installation) para obtener instrucciones de actualización.

2. Instale los ADO2GH extension.

   ```shell copy
   gh extension install github/gh-ado2gh
   ```

3. ADO2GH extension of the GitHub CLI se actualiza semanalmente. Para asegurarte de que usas la versión más reciente, actualiza la extensión.

   ```shell copy
   gh extension upgrade github/gh-ado2gh
   ```

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

## Paso 2: Establecimiento de variables de entorno

Antes de poder usar el ADO2GH extension para migrar a GitHub Enterprise Cloud, debe crear personal access tokens que puedan acceder a las organizaciones de origen y destino, y luego establecer los personal access tokens como variables de entorno.

1. Asegúrese de que tiene los personal access token listos tanto para GitHub como para Azure DevOps. Consulte [Administración del acceso](/es/enterprise-cloud@latest/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) si aún no ha creado un token.

2. Establezca las variables de entorno para los personal access token, reemplazando TOKEN en los siguientes comandos por los personal access token que creó anteriormente. Usa `GH_PAT` para la organización de destino y `ADO_PAT` para la de origen.

   * Si usas Terminal, utiliza el comando `export`.

     ```shell copy
     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     ```

   * Si usas PowerShell, utiliza el comando `$env`.

     ```shell copy
     $env:GH_PAT="TOKEN"
     $env:ADO_PAT="TOKEN"
     ```

3. Si va a migrar a Nube de GitHub Enterprise con residencia de datos, para mayor comodidad, establezca una variable de entorno para la dirección **URL de API base** para la empresa.

   Asegúrese de reemplazar `SUBDOMAIN` por el subdominio de la empresa. Por ejemplo, si el subdominio de la empresa es `acme`, el `TARGET_API_URL` valor sería `https://api.acme.ghe.com`.

   * Si usas Terminal, utiliza el comando `export`.

     ```shell copy
     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     ```

   * Si usas PowerShell, utiliza el comando `$env`.

     ```shell copy
     $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     ```

   Usarás esta variable con la opción `--target-api-url` en los comandos que ejecutes con la opción GitHub CLI.