Introducción
Esta guía te ayuda a migrar de Travis CI a GitHub Actions. Aquí se comparan sus conceptos y sintaxis, se describen sus similitudes y se demuestran sus acercamientos distintos para las tareas comunes.
Antes de comenzar
Antes de que comiences tu migración a GitHub Actions, sería útil familiarizarse con la forma en la que funciona:
- Para obtener un ejemplo rápido en el que se muestra un trabajo de GitHub Actions, consulta "Guía de inicio rápido para GitHub Actions".
- Para obtener información sobre los conceptos básicos de GitHub Actions, consulta "Entender las GitHub Actions".
Comparar la ejecución de jobs
Para proporcionarle control sobre cuándo se ejecutan las tareas de CI, un flujo de trabajo de GitHub Actions usa trabajos que se ejecutan en paralelo de forma predeterminada. Cada trabajo contiene pasos que se ejecutan en una secuencia definida por usted. Si necesitas ejecutar acciones de configuración y limpieza para un job, puedes definir pasos en cada job para que esto se lleve a cabo.
Similitudes en las claves
GitHub Actions y Travis CI comparten algunas similitudes y entenderlas con anticipación puede ayudar a agilizar el proceso de migración.
Utilizar la sintaxis de YAML
Tanto Travis CI como GitHub Actions utilizan YAML para crear jobs y flujos de trabajo y estos archivos se almacenan en el repositorio del código. Para más información sobre cómo se usa YAML en GitHub Actions, consulta "Entender las GitHub Actions".
Variables personalizadas
Travis CI te permite configurar variables y compartirlas entre etapas. De forma similar, GitHub Actions te permite definir las variables para un flujo de trabajo. Para obtener más información, vea «Almacenamiento de información en variables».
Variables predeterminadas
Tanto Travis CI como GitHub Actions incluyen variables de ambiente predeterminadas que puedes utilizar en tus archivos de YAML. Puede ver las variables de GitHub Actions enumeradas en "Almacenamiento de información en variables".
Proceso paralelo de jobs
Travis CI puede usar stages para ejecutar trabajos en paralelo. Del mismo modo, GitHub Actions ejecuta jobs en paralelo. Para obtener más información, vea «Acerca de los flujos de trabajo».
Notificaciones de estado
Tanto Travis CI como GitHub Actions son compatibles con las insignias de estado, lo cual te permite indicar si una compilación pasa o falla. Para obtener más información, vea «Adición de un distintivo de estado de flujo de trabajo».
Uso de una matriz
Tanto Travis CI como GitHub Actions son compatibles con matrices, lo cual te permite realizar pruebas mediante combinaciones de sistemas operativos y paquetes de software. Para obtener más información, vea «Ejecución de variaciones de trabajos en un flujo de trabajo».
A continuación, podrás encontrar un ejemplo que compara la sintaxis de cada sistema.
Sintaxis de Travis CI en una matriz
matrix:
include:
- rvm: '2.5'
- rvm: '2.6.3'
Sintaxis de GitHub Actions en una matriz
jobs:
build:
strategy:
matrix:
ruby: ['2.5', '2.6.3']
Apuntar a ramas específicas
Tanto Travis CI como GitHub Actions te permiten apuntar tu IC a una rama específica. Para obtener más información, vea «Sintaxis del flujo de trabajo para Acciones de GitHub».
A continuación encontrarás un ejemplo de la sintaxis para cada sistema.
Sintaxis de Travis CI para dirigirse a ramas específicas
branches:
only:
- main
- 'mona/octocat'
Sintaxis de GitHub Actions para dirigirse a ramas específicas
on:
push:
branches:
- main
- 'mona/octocat'
Verificar submódulos
Tanto Travis CI como GitHub Actions te permiten controlar si los submódulos se incluirán en los clones de los repositorios.
A continuación encontrarás un ejemplo de la sintaxis para cada sistema.
Sintaxis de Travis CI para restaurar submódulos
git:
submodules: false
Sintaxis de GitHub Actions para restaurar submódulos
- uses: actions/checkout@v4
with:
submodules: false
Utilizar variables de ambiente en una matriz
Tanto GitHub Actions como Travis CI pueden agregar variables personalizadas a una matriz de pruebas, lo cual te permite referirte a la variable en un paso subsecuente.
En GitHub Actions, puede usar la clave include para agregar variables de entorno personalizadas a una matriz. En este ejemplo, las entradas de matriz de node-version se configuran a fin de usar otro valores para las variables de entorno site y datacenter. Después, el paso Echo site details usa env: ${{ matrix.env }} para hacer referencia a las variables personalizadas:
name: Node.js CI
on: [push]
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
include:
- node-version: '14.x'
site: "prod"
datacenter: "site-a"
- node-version: '16.x'
site: "dev"
datacenter: "site-b"
steps:
- name: Echo site details
env:
SITE: ${{ matrix.site }}
DATACENTER: ${{ matrix.datacenter }}
run: echo $SITE $DATACENTER
Características clave en GitHub Actions
Cuando te migres de Travis CI, consider las siguientes características clave en GitHub Actions:
Almacenamiento de secretos
GitHub Actions te permite almacenar secretos y referenciarlos en tus jobs. Las organizaciones de GitHub Actions pueden limitar qué repositorios pueden acceder a sus secretos. Las reglas de protección de implementación pueden requerir aprobación manual para que un flujo de trabajo acceda a los secretos del ambiente. Para obtener más información, vea «Uso de secretos en Acciones de GitHub».
Compartir archivos entre jobs y flujos de trabajo
GitHub Actions incluye compatibilidad integrada para almacenamiento de artefactos, lo cual te permite compartir archivos entre jobs en un flujo de trabajo. También puedes guardar los archivos resultantes y compartirlos con otros flujos de trabajo. Para obtener más información, vea «Entender las GitHub Actions».
Alojar tus propios corredores
Si tus jobs requieren de hardware o software específico, GitHub Actions te permite almacenar tus propios ejecutores y enviar tus jobs para que éstos los procesen. GitHub Actions también te permite utilizar políticas para controlar cómo se accede a estos ejecutores, otorgando acceso a nivel de organización o de repositorio. Para obtener más información, vea «Alojar tus propios corredores».
Tiempo de ejecución y jobs simultáneos
Los jobs simultáneos y los tiempos de ejecución de los flujos de trabajo en GitHub Actions pueden variad dependiendo de tu plan de GitHub. Para obtener más información, vea «Límites de uso, facturación y administración».
Utilizar lenguajes diferentes en GitHub Actions
Cuando trabajas con lenguajes diferentes en GitHub Actions, pueeds crear un paso en tu job para configurar tus dependencias de lenguaje. Para obtener más información acerca de cómo trabajar con un lenguaje en particular, consulta la guía específica:
- Crear y probar en Node.js
- Crear y probar en Python
- Compilar y probar PowerShell
- Compilación y prueba de Java con Maven
- Compilación y prueba de Java con Gradle
- Compilación y prueba de Java con Ant
Ejecución de scripts
GitHub Actions puede usar pasos run para ejecutar scripts o comandos de shell. Para usar un shell determinado, puede especificar el tipo de shell al proporcionar la ruta de acceso al script. Para obtener más información, vea «Sintaxis del flujo de trabajo para Acciones de GitHub».
Por ejemplo:
steps:
- name: Run build script
run: ./.github/scripts/build.sh
shell: bash
Manejo de errores en GitHub Actions
Cuando te migras a GitHub Actions, hay varios acercamientos al manejo de errores que puede que necesites tener en mente.
Manejo de errores en scripts
GitHub Actions detiene un job inmediatamente si alguno de los pasos regresa un código de error. Para obtener más información, vea «Sintaxis del flujo de trabajo para Acciones de GitHub».
Manejo de errores en jobs
GitHub Actions usa condicionales if para ejecutar trabajos o pasos en ciertas situaciones. Por ejemplo, puede ejecutar un paso cuando otro paso da como resultado failure(). Para obtener más información, vea «Sintaxis del flujo de trabajo para Acciones de GitHub». También puede usar continue-on-error para evitar que una ejecución de flujo de trabajo se detenga cuando se produce un error en un trabajo.
Sintaxis de migración para condicionales y expresiones
Para ejecutar trabajos con expresiones condicionales, Travis CI y GitHub Actions comparten una sintaxis de condición if similar. GitHub Actions permite usar el condicional if para evitar que un trabajo o un paso se ejecuten a menos que se cumpla una condición. Para obtener más información, vea «Evaluación de expresiones en flujos de trabajo y acciones».
En este ejemplo se muestra cómo un condicional if puede controlar si se ejecuta un paso:
jobs:
conditional:
runs-on: ubuntu-latest
steps:
- run: echo "This step runs with str equals 'ABC' and num equals 123"
if: env.str == 'ABC' && env.num == 123
Migrar las fases a pasos
Donde Travis CI usa fases para ejecutar pasos, GitHub Actions tiene pasos que ejecutan acciones. Puede encontrar acciones precompiladas en GitHub Marketplace, o bien puede crear sus propias acciones. Para obtener más información, vea «Uso compartido de automatizaciones».
A continuación encontrarás un ejemplo de la sintaxis para cada sistema.
Sintaxis de Travis CI para fases y pasos
language: python
python:
- "3.7"
script:
- python script.py
Sintaxis de GitHub Actions para pasos y acciones
jobs:
run_python:
runs-on: ubuntu-latest
steps:
- uses: actions/setup-python@v5
with:
python-version: '3.7'
architecture: 'x64'
- run: python script.py
Almacenar dependencias en caché
Travis CI y GitHub Actions te permiten guardar dependencias en caché manualmente para reutilizarlas posteriormente.
En estos ejemplos se muestra la sintaxis de caché de cada sistema.
Sintaxis de Travis CI para el almacenamiento en caché
language: node_js
cache: npm
Sintaxis de Acciones de GitHub para el almacenamiento en caché
- name: Cache node modules
uses: actions/cache@v3
with:
path: ~/.npm
key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }}
restore-keys: v1-npm-deps-
Ejemplos de tareas comunes
Esta sección compara cómo GitHub Actions y Travis CI realizan tareas en común.
Configurar variables de ambiente
Puedes crear variables de ambiente personalizadas en un job de GitHub Actions.
Sintaxis de Travis CI para una variable de entorno
env:
- MAVEN_PATH="/usr/local/maven"
Flujo de trabajo de GitHub Actions con una variable de entorno
jobs:
maven-build:
env:
MAVEN_PATH: '/usr/local/maven'
Compilar con Node.js
Travis CI para la compilación con Node.js
install:
- npm install
script:
- npm run build
- npm test
Flujo de trabajo de GitHub Actions para la compilación con Node.js
name: Node.js CI
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Use Node.js
uses: actions/setup-node@v4
with:
node-version: '16.x'
- run: npm install
- run: npm run build
- run: npm test
Pasos siguientes
Para continuar el aprendizaje sobre las características principales de GitHub Actions, consulta "Escritura de flujos de trabajo".