Migración desde GitLab con Acciones de GitHub Importer

Acerca de la migración desde GitLab con Acciones de GitHub Importer

Las instrucciones siguientes le guiarán a través de la configuración del entorno para usar GitHub Actions Importer para migrar canalizaciones de GitLab a GitHub Actions.

Prerrequisitos

• Una cuenta u organización de GitLab con canalizaciones y trabajos que quiere convertir a flujos de trabajo de GitHub Actions.
• Acceso para crear un GitLab personal access token para su cuenta u organización.
• Un entorno en el que puedas ejecutar contenedores basados en Linux e instalar las herramientas necesarias.

  • Docker está instalado y funcionando.

  • La CLI de GitHub está instalada.

  Nota:

  El contenedor y la CLI de GitHub Actions Importer no deben estar instalados en el mismo servidor que tu plataforma de CI.

Limitaciones

Existen algunas limitaciones en la migración automática de procesos desde canalizaciones de GitLab a GitHub Actions con GitHub Actions Importer.

• No se admite el almacenamiento en caché automático entre trabajos de diferentes flujos de trabajo.
• El comando audit solo se admite cuando se usa una cuenta de organización. Sin embargo, los comandos dry-run y migrate se pueden usar con una cuenta de organización o de usuario.

Tareas manuales

Algunas construcciones de GitLab deben migrarse manualmente. Entre ellas se incluyen las siguientes:

• Valores de variables de grupo o proyecto enmascarados
• Informes de artefactos

Para obtener más información sobre las migraciones manuales, consulta Migración de CI/CD de GitLab a Acciones de GitHub.

Instalación de la extensión de la GitHub Actions Importer CLI

1. Instala la extensión de la CLI del GitHub Actions Importer:

   Bash

   gh extension install github/gh-actions-importer
   

2. Comprueba que la extensión está instalada:

   $ gh actions-importer -h
   Options:
     -?, -h, --help  Show help and usage information
   
   Commands:
     update     Update to the latest version of GitHub Actions Importer.
     version    Display the version of GitHub Actions Importer.
     configure  Start an interactive prompt to configure credentials used to authenticate with your CI server(s).
     audit      Plan your CI/CD migration by analyzing your current CI/CD footprint.
     forecast   Forecast GitHub Actions usage from historical pipeline utilization.
     dry-run    Convert a pipeline to a GitHub Actions workflow and output its yaml file.
     migrate    Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.
   

Configuración de credenciales

El configure comando de la CLI se usa para establecer las credenciales y opciones necesarias para GitHub Actions Importer cuando se trabaja con GitLab y GitHub.

1. Cree un GitHubpersonal access token (classic). Para más información, consulta Administración de tokens de acceso personal.

   El token debe tener el ámbito workflow.

   Después de crear el token, cópialo y guárdalo en una ubicación segura para utilizarlo más adelante.

2. Cree un GitLab personal access token. Para obtener más información, consulte Personal access tokens la documentación de GitLab.

   El token debe tener el ámbito read_api.

   Después de crear el token, cópialo y guárdalo en una ubicación segura para utilizarlo más adelante.

3. En el terminal, ejecute el comando de la GitHub Actions Importerconfigure CLI:

   gh actions-importer configure
   

   El comando configure te pedirá la siguiente información:

   • En "¿Qué proveedores de CI estás configurando?", usa las teclas de dirección para seleccionar GitLab, presiona Espacio para seleccionarlo y, a continuación, presiona Entrar.
   • En "Personal access token para GitHub", escriba el valor de personal access token (classic) que creó anteriormente y pulse Enter.
   • En "Dirección URL base de la instancia de GitHub", Presione Entrar para aceptar el valor predeterminado (https://github.com).