Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Migrar de Jenkins a GitHub Actions

GitHub Actions y Jenkins comparten varias similaridades, lo cual hace que migrar a GitHub Actions sea relativamente sencillo.

Nota: GitHub Actions estuvo disponible para GitHub Enterprise Server 2.22 como un beta limitado. El beta terminó. GitHub Actions está ahora disponible habitualmente en GitHub Enterprise Server 3.0 o superior. Para obtener más información, consulta la sección de notas de lanzamiento para GitHub Enterprise Server 3.0.


Nota: Los ejecutores hospedados en GitHub no son compatibles con GitHub Enterprise Server actualmente. Puedes encontrar más información sobre el soporte que se tiene planeado en el futuro en el Itinerario público de GitHub.

Introducción

Tanto Jenkins como GitHub Actions te permiten crear flujos de trabajo que compilan, prueban, publican, lanzan y despliegan código automáticamente. Jenkins y GitHub Actions comparten algunas similaridades en la configuración del flujo de trabajo:

  • Jenkins crea flujos de trabajo utilizando Mapas Declarativos, los cuales son similares a los archivos de flujo de trabajo de GitHub Actions.
  • Jenkins utiliza etapas para ejecutar un conjunto de pasos, mientras que GitHub Actions utiliza jobs para agrupar uno o mas pasos o comandos individuales.
  • Jenkins y GitHub Actions son compatibles con compilaciones basadas en el contenedor. Para obtener más información, consulta "Crear una acción de contenedor Docker".
  • Los pasos o tareas pueden reutilizarse y compartirse con la comunidad.

Para obtener más información, consulta la sección "Conceptos esenciales para GitHub Actions".

Diferencias clave

  • Jenkins tiene dos tipos de sintaxis para crear mapas: Mapa Declarativo y Mapa de Script. GitHub Actions utiliza YAML para crear flujos de trabajo y archivos de configuración. Para obtener más información, consultala sección "Sintaxis de flujo de trabajo para GitHub Actions".
  • Los despliegues de jenkins son típicamente auto-hospedados y los usuarios mantienen los servidores en sus propios centros de datos. GitHub Actions ofrece un acercamiento híbrido en la nube, hospedando sus propios ejecutores que puedes utilizar para ejecutar jobs, mientras que también son compatibles con ejecutores auto-hospedados. Para obtener más información, consulta la sección Acerca de los ejecutores auto-hospedados.

Comparación de capacidades

Distribuir tus compilaciones

Jenkis te permite enviar compilaciones a un agente de compilación sencilla, o puedes distribuirlas a través de varios agentes. También puedes clasificar estos agentes de acuerdo con diversos atributos, tales como los tipos de sistema operativo.

De forma similar, las GitHub Actions pueden enviar jobs a los ejecutores auto-hospedados u hospedados en GitHub, y puedes utilizar etiquetas para clasificar los ejecutores de acuerdo con diversos atributos. Para obtener más información, consulta las secciones "Entender las GitHub Actions" y "Acerca de los ejecutores auto-hospedados".

Utilizar secciones para organizar mapas

Jenkins divide sus Mapas Declarativos en varias secciones. De forma similar, las GitHub Actions organizan sus flujos de trabajo en secciones separadas. En esta tabla se comparan las secciones de Jenkins con el flujo de trabajo de GitHub Actions.

Directivas de JenkinsGitHub Actions
agentjobs.<job_id>.runs-on
jobs.<job_id>.container
publicación
stagesTrabajos
pasosjobs.<job_id>.steps

Utilizar directivas

Jenkins utiliza directivas para administrar los Mapas Declarativos. Estas directivas definen las características de tu flujo de trabajo y la manera en que se ejecuta. La tabla siguiente demuestra cómo dichas directivas mapean los conceptos en GitHub Actions.

Directivas de JenkinsGitHub Actions
environmentjobs.<job_id>.env
jobs.<job_id>.steps[*].env
optionsjobs.<job_id>.strategy
jobs.<job_id>.strategy.fail-fast
jobs.<job_id>.timeout-minutes
parametersinputs
outputs
triggerson
on.<event_name>.types
on.<push|pull_request>.<branches|tags>
on.<push|pull_request>.paths
triggers { upstreamprojects() }jobs.<job_id>.needs
Sintaxis de Jenkins cronon.schedule
etapajobs.<job_id>
jobs.<job_id>.name
tools
Especificaciones para los ejecutores hospedados en GitHub
inputinputs (entrada)
whenjobs.<job_id>.if

Utilizar etapas secuenciales

Proceso paralelo de jobs

Jenkins puede ejecutar las stages y steps en paralelo, mientras que, actualmente, GitHub Actions solo ejecuta jobs en paralelo.

Jenkins en ParaleloGitHub Actions
paralleljobs.<job_id>.strategy.max-parallel

Matriz de compilaciones

Tanto GitHub Actions como Jenkins te permiten utilizar una matriz de compilaciones para definir diversas combinaciones de sistema.

JenkinsGitHub Actions
axisstrategy/matrix
context
stagessteps-context
excludes

Utilizar pasos para ejecutar tareas

Jenkins agrupa los steps en stages. Cada uno de estos pasos puede ser un script, función, o comando, entre otros. De manera similar, GitHub Actions utiliza jobs para ejecutar grupos específicos de steps.

Pasos de JenkinsGitHub Actions
scriptjobs.<job_id>.steps

Ejemplos de tareas comunes

Programar un mapa para ejecutarse con cron

Mapa de Jenkins Flujo de trabajo de GitHub Actions
pipeline {
  agent any
  triggers {
    cron('H/15 * * * 1-5')
  }
}
on:
  schedule:
    - cron: '*/15 * * * 1-5'

Configurar variables de ambiente en un mapa

Mapa de Jenkins Flujo de trabajo de GitHub Actions
pipeline {
  agent any
  environment {
    MAVEN_PATH = '/usr/local/maven'
  }
}
jobs:
  maven-build:
    env:
      MAVEN_PATH: '/usr/local/maven'

Compilar desde proyectos ascendentes

Mapa de Jenkins Flujo de trabajo de GitHub Actions
pipeline {
  triggers {
    upstream(
      upstreamProjects: 'job1,job2',
      threshold: hudson.model.Result.SUCCESS
    )
  }
}
jobs:
  job1:
  job2:
    needs: job1
  job3:
    needs: [job1, job2]

Compilar con sistemas operativos múltiples

Mapa de Jenkins Flujo de trabajo de GitHub Actions
pipeline {
  agent none
  stages {
    stage('Run Tests') {
      matrix {
        axes {
          axis {
            name: 'PLATFORM'
            values: 'macos', 'linux'
          }
        }
        agent { label "${PLATFORM}" }
        stages {
          stage('test') {
            tools { nodejs "node-12" }
            steps {
              dir("scripts/myapp") {
                sh(script: "npm install -g bats")
                sh(script: "bats tests")
              }
            }
          }
        }
      }
    }
  }
}
name: demo-workflow
on:
  push:
jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest]
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: 12
      - run: npm install -g bats
      - run: bats tests
        working-directory: scripts/myapp