# Migración desde Travis CI con Acciones de GitHub Importer Aprenda a usar GitHub Actions Importer para automatizar la migración de las canalizaciones de CI de Travis a GitHub Actions. ## Acerca de la migración desde Travis CI 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 CI de Travis a GitHub Actions. ### Requisitos previos * Una cuenta de CI de Travis u organización con canalizaciones y trabajos que desea convertir en GitHub Actions flujos de trabajo. * Acceso para crear un token de acceso de API de Travis CI para tu cuenta u organización. * Un entorno en el que puedas ejecutar contenedores basados en Linux e instalar las herramientas necesarias. * Docker está [instalado](https://docs.docker.com/get-docker/) y funcionando. * [La CLI de GitHub](https://cli.github.com) está instalada. > \[!NOTE] > El contenedor y la CLI de GitHub Actions Importer no deben estar instalados en el mismo servidor que tu plataforma de CI. ### Limitaciones Hay algunas limitaciones al migrar desde canalizaciones de CI de Travis a GitHub Actions con GitHub Actions Importer. #### Tareas manuales Algunas construcciones de Travis CI deben migrarse manualmente. Entre ellas se incluyen las siguientes: * Secretos * Propiedades de tarea desconocidas Para obtener más información sobre las migraciones manuales, consulta [Migración de Travis CI a Acciones de GitHub](/es/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci). #### Lenguajes de proyecto de Travis CI GitHub Actions Importer transforma los lenguajes de proyecto de CI de Travis agregando un conjunto de herramientas de compilación preconfiguradas y un script de compilación predeterminado al flujo de trabajo transformado. Si no se declara explícitamente ningún lenguaje, GitHub Actions Importer se supone que un lenguaje de proyecto es Ruby. Para obtener una lista de los lenguajes de proyecto admitidos por GitHub Actions Importer, vea [Idiomas de proyecto admitidos](#supported-project-languages). ## 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 copy gh extension install github/gh-actions-importer ``` 2. Comprueba que la extensión está instalada: ```bash $ 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 LA CI de Travis y GitHub. 1. Cree un GitHubpersonal access token (classic). Para más información, consulta [Administración de tokens de acceso personal](/es/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic). 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. Crea un token de acceso de API de Travis CI. Para más información, consulta [Obtención del token de API de Travis CI](https://docs.travis-ci.com/user/migrate/travis-migrate-to-apps-gem-guide/#4-get-your-travis-ci-api-token) en la documentación de Travis CI. 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 Importer`configure` CLI: ```shell 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 `Travis CI`, 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`). * En "Personal access token para Travis CI", escriba el valor del token de acceso de la API de CI de Travis que creó anteriormente y presione Entrar. * En "Dirección URL base de la instancia de Travis CI", escribe la dirección URL de la instancia de Travis CI y presiona Entrar. * En "Nombre de la organización de Travis CI", escribe el nombre de la organización de Travis CI y presiona Entrar. A continuación se muestra un ejemplo de la salida del comando `configure`. ```shell $ gh actions-importer configure ✔ Which CI providers are you configuring?: Travis CI Enter the following values (leave empty to omit): ✔ Personal access token for GitHub: *************** ✔ Base url of the GitHub instance: https://github.com ✔ Personal access token for Travis CI: *************** ✔ Base url of the Travis CI instance: https://travis-ci.com ✔ Travis CI organization name: actions-importer-labs Environment variables successfully updated. ``` 4. En tu terminal, ejecuta el comando GitHub Actions Importer`update` CLI para conectarte a GitHub PackagesContainer registry y asegurarte de que la imagen de contenedor esté actualizada a la versión más reciente. ```shell gh actions-importer update ``` El resultado del comando debe ser similar al siguiente: ```shell Updating ghcr.io/actions-importer/cli:latest... ghcr.io/actions-importer/cli:latest up-to-date ``` ## Realización de una auditoría de Travis CI Puedes usar el comando `audit` para obtener una vista general de todas las canalizaciones de un servidor de Travis CI. El comando `audit` realiza los pasos siguientes: 1. Captura todos los proyectos definidos en un servidor de Travis CI. 2. Convierte cada canalización en su flujo de trabajo equivalente GitHub Actions . 3. Genera un informe que resume cómo es posible realizar una migración completa y compleja con GitHub Actions Importer. ### Ejecución del comando de auditoría Para realizar una auditoría de un servidor de Travis CI, ejecuta el siguiente comando en el terminal: ```shell gh actions-importer audit travis-ci --output-dir tmp/audit ``` ### Inspección de los resultados de la auditoría Los archivos del directorio de salida especificado contienen los resultados de la auditoría. Consulta el archivo `audit_summary.md` para obtener un resumen de los resultados de la auditoría. El resumen de la auditoría tiene las secciones siguientes. #### Canalizaciones La sección "Canalizaciones" contiene estadísticas de alto nivel con respecto a la tasa de conversión realizada por GitHub Actions Importer. A continuación se incluyen algunos términos clave que pueden aparecer en la sección "Canalizaciones": * **Las** canalizaciones correctas tenían 100% de las construcciones de canalización y los elementos individuales convertidos automáticamente a su GitHub Actions equivalente. * Las canalizaciones **parcialmente correctas** tenían todas las construcciones de canalización convertidas; sin embargo, había algunos elementos individuales que no se convertían automáticamente en su GitHub Actions equivalente. * Las canalizaciones **no admitidas** son tipos de definición que no son compatibles con GitHub Actions Importer. * En las canalizaciones **con error**, se produjo un error grave al realizar la conversión. Esto puede deberse a uno de los siguientes motivos: * La canalización se configuró mal originalmente y no es válida. * GitHub Actions Importer encontró un error interno al convertirlo. * Se produjo un error de red que provocó que la canalización no fuera accesible, lo que a menudo se debe a credenciales no válidas. #### Pasos de compilación La sección "Pasos de compilación" contiene información general sobre los pasos de compilación individuales que se usan en todas las canalizaciones y cuántos se convierten automáticamente en GitHub Actions Importer. A continuación se indican algunos términos clave que pueden aparecer en la sección "Pasos de compilación": * Un paso de compilación **conocido** es un paso que se ha convertido automáticamente en una acción equivalente. * Un paso de compilación **desconocido** es un paso que no se ha convertido automáticamente en una acción equivalente. * Un paso de compilación **no admitido** es un paso que es cualquiera de los siguientes: * Fundamentalmente, no es compatible con GitHub Actions. * Configurado de una manera que no es compatible con GitHub Actions. * Una **acción** es una lista de las acciones que se han usado en los flujos de trabajo convertidos. Esto puede ser importante por las siguientes razones: * Si usa GitHub Enterprise Server, recopile la lista de acciones que se van a sincronizar con la instancia. * Definir una lista de acciones permitidas a nivel de organización que se utilizan. Esta lista de acciones es una lista completa de las acciones que puede que los equipos de seguridad o cumplimiento deban revisar. #### Tareas manuales La sección "Tareas manuales" contiene información general sobre las tareas que GitHub Actions Importer no se pueden completar automáticamente y que debe completar manualmente. A continuación se incluyen algunos términos clave que pueden aparecer en la sección "Tareas manuales": * Un **secreto** es un secreto a nivel de repositorio o de organización que se utiliza en las canalizaciones convertidas. Estos secretos se deben crear manualmente en GitHub Actions para que estas canalizaciones funcionen correctamente. Para más información, consulta [Uso de secretos en Acciones de GitHub](/es/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets). * Un **ejecutor autohospedado** hace referencia a una etiqueta de un ejecutor al que se hace referencia en una canalización convertida que no es un GitHubejecutor hospedado. Tendrás que definir manualmente estos runners para que las canalizaciones funcionen correctamente. #### Archivos La sección final del informe de auditoría proporciona un manifiesto de todos los archivos que se escribieron en el disco durante la auditoría. Cada archivo de canalización tiene varios archivos incluidos en la auditoría, entre los que se incluyen: * La canalización original tal como se definió en GitHub. * Cualquier respuesta de red utilizada para convertir el flujo de procesamiento. * El archivo del flujo de trabajo convertido. * Trazas de pila que se pueden usar para resolver problemas de una conversión de canalización fallida. Además, el archivo `workflow_usage.csv` contiene una lista separada por comas de todas las acciones, los secretos y los ejecutores que usa cada una de las canalizaciones convertidas correctamente. Esto puede ser útil para determinar qué flujos de trabajo usan qué acciones, secretos o ejecutores, así como para realizar revisiones de seguridad. ## Previsión del posible uso del ejecutor de compilación Puede usar el comando para predecir el `forecast` uso potencial GitHub Actions mediante la computación de métricas de ejecuciones de canalización completadas en el servidor de CI de Travis. ### Ejecución del comando de previsión Para realizar una previsión del uso potencial GitHub Actions , ejecute el siguiente comando en el terminal. De forma predeterminada, GitHub Actions Importer incluye los siete días anteriores en el informe de previsión. ```shell gh actions-importer forecast travis-ci --output-dir tmp/forecast ``` ### Inspección del informe de previsión El archivo `forecast_report.md` del directorio de salida especificado contiene los resultados de la previsión. A continuación se incluyen algunos términos clave que pueden aparecer en el informe de previsión: * El **recuento de trabajos** es el número total de trabajos completados. * El **recuento de canalizaciones** es el número de canalizaciones distintas empleadas. * El **tiempo de ejecución** describe la cantidad de tiempo que un corredor empleó en una tarea. Esta métrica se puede usar para ayudar a planear el costo de GitHublos ejecutores hospedados. * Esta métrica está correlacionada con la cantidad que debe esperar gastar en GitHub Actions. Esto variará en función del hardware usado durante estos minutos. Puede usar la [GitHub Actions calculadora de precios](https://github.com/pricing/calculator) para calcular los costos. * ``` Las métricas de **tiempo de cola** describen la cantidad de tiempo que un trabajo ha esperado a que un ejecutor esté disponible para ejecutarlo. ``` * Las métricas de **trabajos simultáneos** describen la cantidad de trabajos que se ejecutan en un momento dado. Esta métrica se puede usar para definir el número de ejecutores que debes configurar. Además, estas métricas se definen para cada cola de ejecutores de Travis CI. Esto es especialmente útil si hay una combinación de ejecutores hospedados o autohospedados, o máquinas de especificación alta o baja, por lo que puedes ver métricas específicas de los diferentes tipos de ejecutores. ## Realización de un simulacro de migración de una canalización de Travis CI Puede usar el `dry-run` comando para convertir una canalización de CI de Travis en un flujo de trabajo equivalente GitHub Actions . Un simulacro crea los archivos de salida en un directorio especificado, pero no abre una solicitud de incorporación de cambios para migrar la canalización. Para realizar una ejecución seca de migrar las canalizaciones de CI de Travis a GitHub Actions, ejecute el siguiente comando en el terminal y reemplace por `my-travis-ci-repository` el nombre del repositorio de CI de Travis. ```shell gh actions-importer dry-run travis-ci --travis-ci-repository my-travis-ci-repository --output-dir tmp/dry-run ``` Puedes ver los registros del simulacro y los archivos de flujo de trabajo convertidos en el directorio de salida especificado. Si hay algo que GitHub Actions Importer no pudo convertir automáticamente, como pasos de compilación desconocidos o una canalización parcialmente correcta, es posible que desee crear transformadores personalizados para personalizar aún más el proceso de conversión. Para más información, consulta [Extensión de Acciones de GitHub Importer con transformadores personalizados](/es/actions/reference/github-actions-importer/custom-transformers). ## Realización de una migración de producción de una canalización de Travis CI Puede usar el `migrate` comando para convertir una canalización de CI de Travis y abrir una solicitud de incorporación de cambios con el flujo de trabajo equivalente GitHub Actions . ### Ejecución del comando migrate Para migrar una canalización de CI de Travis a GitHub Actions, ejecute el siguiente comando en el terminal, reemplazando el `target-url` valor por la dirección URL del GitHub repositorio y `my-travis-ci-repository` por el nombre del repositorio de CI de Travis. ```shell gh actions-importer migrate travis-ci --target-url https://github.com/octo-org/octo-repo --output-dir tmp/migrate --travis-ci-repository my-travis-ci-repository ``` La salida del comando incluye la dirección URL de la solicitud de incorporación de cambios que agrega el flujo de trabajo convertido al repositorio. Un ejemplo de una salida correcta es similar al siguiente: ```shell $ gh actions-importer migrate travis-ci --target-url https://github.com/octo-org/octo-repo --output-dir tmp/migrate --travis-ci-repository my-travis-ci-repository [2022-08-20 22:08:20] Logs: 'tmp/migrate/log/actions-importer-20220916-014033.log' [2022-08-20 22:08:20] Pull request: 'https://github.com/octo-org/octo-repo/pull/1' ``` ### Inspección de la solicitud de incorporación de cambios La salida de una ejecución correcta del comando `migrate` contiene un vínculo a la nueva solicitud de incorporación de cambios que agrega el flujo de trabajo convertido al repositorio. Entre algunos elementos importantes de la solicitud de incorporación de cambios se incluyen los siguientes: * En la descripción de la solicitud de incorporación de cambios, una sección denominada **Pasos manuales**, que enumera los pasos que debes completar manualmente para poder finalizar la migración de las canalizaciones a GitHub Actions. Por ejemplo, esta sección puede indicarte que crees los secretos usados en los flujos de trabajo. * El archivo de flujos de trabajo convertidos. Selecciona la pestaña **Archivos cambiados** de la solicitud de incorporación de cambios para ver el archivo de flujo de trabajo que se agregará al repositorio de GitHub. Cuando hayas terminado de inspeccionar la solicitud de incorporación de cambios, puedes combinarla para agregar el flujo de trabajo al repositorio de GitHub. ## Referencia Esta sección contiene información de referencia sobre variables de entorno, argumentos opcionales y sintaxis admitida al usar GitHub Actions Importer para migrar desde Travis CI. ### Uso de variables de entorno GitHub Actions Importer usa variables de entorno para su configuración de autenticación. Estas variables se establecen al seguir el proceso de configuración mediante el comando `configure`. Para más información, consulta la sección [Configuración de credenciales](#configuring-credentials). GitHub Actions Importer usa las siguientes variables de entorno para conectarse a la instancia de CI de Travis: * `GITHUB_ACCESS_TOKEN`: El personal access token (classic) que se usa para crear solicitudes de extracción con un flujo de trabajo convertido (requiere el alcance `workflow`). * `GITHUB_INSTANCE_URL`: la dirección URL de la instancia de destino GitHub (por ejemplo, `https://github.com`). * `TRAVIS_CI_ACCESS_TOKEN`: el token de acceso de API de Travis CI que se usa para ver los recursos de Travis CI. * `TRAVIS_CI_ORGANIZATION`: el nombre de la organización de la instancia de Travis CI. * `TRAVIS_CI_INSTANCE_URL`: la dirección URL de la instancia de Travis CI. * `TRAVIS_CI_SOURCE_GITHUB_ACCESS_TOKEN`: (Opcional) que personal access token se usa para autenticarse con la instancia de GitHub de origen. Si no se proporciona, se usará `GITHUB_ACCESS_TOKEN` en su lugar. * `TRAVIS_CI_SOURCE_GITHUB_INSTANCE_URL`: (Opcional) Dirección URL de la instancia de GitHub de origen, como . Si no se proporciona, se usará `GITHUB_INSTANCE_URL` en su lugar. Estas variables de entorno se pueden especificar en un `.env.local` archivo cargado por GitHub Actions Importer cuando se ejecuta. ### Uso de argumentos opcionales Hay argumentos opcionales que puedes usar con los subcomandos de GitHub Actions Importer para personalizar la migración. #### `--source-file-path` Puedes usar el argumento `--source-file-path` con los subcomandos `forecast`, `dry-run` o `migrate`. De forma predeterminada, GitHub Actions Importer obtiene el contenido de la canalización desde el control de código fuente. El `--source-file-path` argumento indica GitHub Actions Importer que use la ruta de acceso del archivo de origen especificada en su lugar. Por ejemplo: ```shell gh actions-importer dry-run travis-ci --output-dir ./path/to/output/ --travis-ci-repository my-travis-ci-repository --source-file-path ./path/to/.travis.yml ``` #### `--allow-inactive-repositories` Puede usar este argumento para especificar si GitHub Actions Importer debe incluir repositorios inactivos en una auditoría. Si no se establece esta opción, los repositorios inactivos no se incluyen en las auditorías. ```shell gh actions-importer dry-run travis-ci --output-dir ./path/to/output/ --travis-ci-repository my-travis-ci-repository --allow-inactive-repositories ``` #### `--config-file-path` Puedes usar el argumento `--config-file-path` con los subcomandos `audit`, `dry-run` y `migrate`. De forma predeterminada, GitHub Actions Importer obtiene el contenido de la canalización desde el control de código fuente. El `--config-file-path` argumento indica GitHub Actions Importer que use los archivos de origen especificados en su lugar. ##### Ejemplo de audit En este ejemplo, GitHub Actions Importer usa el archivo de configuración YAML especificado para realizar una auditoría. ```shell gh actions-importer audit travis-ci --output-dir ./path/to/output/ --config-file-path ./path/to/travis-ci/config.yml ``` Para auditar una instancia de Travis CI mediante un archivo de configuración, el archivo debe tener el formato siguiente y cada valor `repository_slug` debe ser único: ```yaml source_files: - repository_slug: travis-org-name/travis-repo-name path: path/to/.travis.yml - repository_slug: travis-org-name/some-other-travis-repo-name path: path/to/.travis.yml ``` ##### Ejemplo de simulacro En este ejemplo, GitHub Actions Importer usa el archivo de configuración YAML especificado como archivo de origen para realizar una ejecución en seco. Para seleccionar la canalización, se hace coincidir el elemento `repository_slug` del archivo de configuración con el valor de la opción `--travis-ci-repository`. A continuación, se usa `path` para extraer el archivo de origen especificado. ```shell gh actions-importer dry-run travis-ci --travis-ci-repository travis-org-name/travis-repo-name --output-dir ./output/ --config-file-path ./path/to/travis-ci/config.yml ``` ### Lenguajes de proyecto admitidos GitHub Actions Importer admite la migración de proyectos de CI de Travis en los lenguajes siguientes. ### Sintaxis admitida para las canalizaciones de Travis CI En la tabla siguiente se muestra el tipo de propiedades GitHub Actions Importer que se puede convertir actualmente. Para obtener más información sobre cómo la sintaxis de canalización de CI de Travis se alinea con GitHub Actions, consulte [Migración de Travis CI a Acciones de GitHub](/es/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci). | Travis CI | Acciones de GitHub | Estado | | :----------------------------------- | :----------------------------------------------------------------------------------------------------------------------- | ---------------------: | | ramas |