Fase 3. Instalación y configuración de GitHub Enterprise Importer

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

En este artículo

Paso 1: Instalación de 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 la GitHub CLI y la ADO2GH extension.

  1. Instala el GitHub CLI.

    • A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.
    • Si ya tiene GitHub CLI instalados, 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 repositorio GitHub CLI para obtener instrucciones de actualización.

  2. Instalación de ADO2GH extension.

    Shell
    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
    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

Para poder usar la ADO2GH 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.

  1. Asegúrese de tener listos los personal access tokens para GitHub y Azure DevOps. Consulta Fase 2. Administración del acceso.

  2. Establezca variables de entorno para personal access tokens, reemplazando TOKEN en los comandos a continuación por los personal access tokens 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
      export GH_PAT="TOKEN"
export ADO_PAT="TOKEN"

    • Si usas PowerShell, utiliza el comando $env.

      Shell
      $env:GH_PAT="TOKEN"
$env:ADO_PAT="TOKEN"

  3. 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.

    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
      export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"

    • Si usas PowerShell, utiliza el comando $env.

      Shell
      $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 GitHub CLI.

Pasos siguientes

En la siguiente fase, usarás GitHub Enterprise Cloud para prepararte para la migración. Consulta Fase 4. Preparación para la migración desde Azure DevOps a GitHub.