# Migración de Jenkins a Acciones de GitHub

GitHub Actions y Jenkins tienen mucho en común, lo que hace que la migración a GitHub Actions sea relativamente sencilla.

## Introducción

Jenkins y GitHub Actions ambos le permiten crear flujos de trabajo que compilen, prueben, publiquen, publiquen e implementen código automáticamente. Jenkins y GitHub Actions comparten algunas similitudes en la configuración del flujo de trabajo:

* Jenkins crea flujos de trabajo mediante *canalizaciones declarativas*, que son similares a los GitHub Actions archivos de flujo de trabajo.
* Jenkins usa *fases* para ejecutar una colección de pasos, mientras que GitHub Actions usa trabajos para agrupar uno o varios pasos o comandos individuales.
* Jenkins y GitHub Actions admite compilaciones basadas en contenedores. Para más información, consulta [Creación de una acción de contenedor de Docker](/es/actions/tutorials/use-containerized-services/create-a-docker-container-action).
* Los pasos o tareas pueden reutilizarse y compartirse con la comunidad.

Para más información, consulta [Descripción de Acciones de GitHub](/es/actions/get-started/understand-github-actions).

## Diferencias clave

* Jenkins tiene dos tipos de sintaxis para crear mapas: Mapa Declarativo y Mapa de Script.
  GitHub Actions usa YAML para crear flujos de trabajo y archivos de configuración. Para más información, consulta [Sintaxis del flujo de trabajo para Acciones de GitHub](/es/actions/reference/workflows-and-actions/workflow-syntax).
* 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 enfoque de nube híbrida hospedando sus propios ejecutores que puede usar para ejecutar trabajos, al tiempo que admite ejecutores autohospedados. Para más información, consulta [Ejecutores autohospedados](/es/actions/concepts/runners/self-hosted-runners).

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

Del mismo modo, GitHub Actions puede enviar trabajos a ejecutores hospedados en GitHub o autoalojados, y puedes usar etiquetas para clasificar los ejecutores en función de distintos atributos. Para más información, consulta [Descripción de Acciones de GitHub](/es/actions/get-started/understand-github-actions#runners) y [Ejecutores autohospedados](/es/actions/concepts/runners/self-hosted-runners).

### Utilizar secciones para organizar tuberías

Jenkins divide sus Pipelines Declarativos en varias secciones. Del mismo modo, GitHub Actions organiza sus flujos de trabajo en secciones independientes. La tabla siguiente compara las secciones de Jenkins con el flujo de trabajo GitHub Actions.

| Directivas de Jenkins                                           | GitHub Actions                                                                                                                                                                                                             |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent)   | [`jobs.<job_id>.runs-on`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idruns-on) <br> [`jobs.<job_id>.container`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idcontainer) |
| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post)     | Ninguno                                                                                                                                                                                                                    |
| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobs)                                                                                                                                                 |
| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps)   | [`jobs.<job_id>.steps`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps)                                                                                                                       |

## Directivas de Uso

Jenkins usa directivas para administrar *Canalizaciones declarativas*. Estas directivas definen las características de tu flujo de trabajo y la manera en que se ejecuta. En la tabla siguiente se muestra cómo estas directivas se asignan a conceptos dentro de GitHub Actions.

| Directivas de Jenkins                                                                                                                                 | GitHub Actions                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment)                                                                             | [`jobs.<job_id>.env`](/es/actions/reference/workflows-and-actions/workflow-syntax#env) <br> [`jobs.<job_id>.steps[*].env`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsenv)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                                                     | [`jobs.<job_id>.strategy`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategy) <br> [`jobs.<job_id>.strategy.fail-fast`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategyfail-fast) <br> [`jobs.<job_id>.timeout-minutes`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idtimeout-minutes)                                                                                                                                                                                                                                                                                                                       |
| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                                                  | [`inputs`](/es/actions/reference/workflows-and-actions/metadata-syntax#inputs) <br> [`outputs`](/es/actions/reference/workflows-and-actions/metadata-syntax#outputs-for-docker-container-and-javascript-actions)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers)                                                                                   | [`on`](/es/actions/reference/workflows-and-actions/workflow-syntax#on) <br> [`on.<event_name>.types`](/es/actions/reference/workflows-and-actions/workflow-syntax#onevent_nametypes) <br> [<code>on.\<push>.\<branches\|tags></code>](/es/actions/reference/workflows-and-actions/workflow-syntax#onpushbranchestagsbranches-ignoretags-ignore) <br> [<code>on.\<pull\_request>.\<branches></code>](/es/actions/reference/workflows-and-actions/workflow-syntax#onpull_requestpull_request_targetbranchesbranches-ignore) <br> [<code>on.\<push\|pull\_request>.paths</code>](/es/actions/reference/workflows-and-actions/workflow-syntax#onpushpull_requestpull_request_targetpathspaths-ignore) |
| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers)                                                            | [`jobs.<job_id>.needs`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idneeds)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| [Sintaxis cron de Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax)                                                                  | [`on.schedule`](/es/actions/reference/workflows-and-actions/workflow-syntax#onschedule)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage)                                                                                         | [`jobs.<job_id>`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_id) <br> [`jobs.<job_id>.name`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idname)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools)                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [Especificaciones para GitHubejecutores hospedados](/es/actions/concepts/runners/github-hosted-runners#preinstalled-software-for-github-owned-images) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input)                                                                                         | [`inputs`](/es/actions/reference/workflows-and-actions/metadata-syntax#inputs)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when)                                                                                           | [`jobs.<job_id>.if`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idif)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Utilizar etapas secuenciales

### Procesamiento paralelo de tareas

Jenkins puede ejecutar `stages` y `steps` en paralelo.
GitHub Actions ejecuta trabajos en paralelo y también puede ejecutar pasos de forma simultánea dentro de un trabajo mediante sintaxis a nivel de paso. Para obtener más información, consulte [Sintaxis del flujo de trabajo para Acciones de GitHub](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsbackground).

| Jenkins en Paralelo                                                 | GitHub Actions                                                                                                                      |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs.<job_id>.strategy.max-parallel`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategymax-parallel) |

### Matriz

Tanto GitHub Actions como Jenkins permiten utilizar una matriz para definir distintas combinaciones del sistema.

| Jenkins                                                                  | GitHub Actions                                                                                                                                                                                      |
| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes)       | [`strategy/matrix`](/es/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations#about-matrix-strategies) <br> [`context`](/es/actions/reference/workflows-and-actions/contexts) |
| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages)   | [`steps-context`](/es/actions/reference/workflows-and-actions/contexts#steps-context)                                                                                                               |
| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | Ninguno                                                                                                                                                                                             |

### Utilizar pasos para ejecutar tareas

Jenkins agrupa `steps` en `stages`. Cada uno de estos pasos puede ser un script, función, o comando, entre otros. Del mismo modo, GitHub Actions usa `jobs` para ejecutar grupos específicos de `steps`.

| Jenkins                                                       | GitHub Actions                                                                                       |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs.<job_id>.steps`](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps) |

## Ejemplos de tareas comunes

### Programación de una canalización para ejecutar con `cron`

#### Canalización de Jenkins con `cron`

```yaml
pipeline {
  agent any
  triggers {
    cron('H/15 * * * 1-5')
  }
}
```

#### GitHub Actions flujo de trabajo con `cron`

```yaml
on:
  schedule:
    - cron: '*/15 * * * 1-5'
```

Para más información sobre los eventos `schedule`y la sintaxis de cron aceptada, consulta [Eventos que desencadenan flujos de trabajo](/es/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule).

### Configurar variables de entorno en una canalización

#### Canalización de Jenkins con una variable de entorno

```yaml
pipeline {
  agent any
  environment {
    MAVEN_PATH = '/usr/local/maven'
  }
}
```

#### GitHub Actions flujo de trabajo con una variable de entorno

```yaml
jobs:
  maven-build:
    env:
      MAVEN_PATH: '/usr/local/maven'
```

### Compilar desde proyectos ascendentes

#### Canalización de Jenkins que se compila a partir de un proyecto ascendente

```yaml
pipeline {
  triggers {
    upstream(
      upstreamProjects: 'job1,job2',
      threshold: hudson.model.Result.SUCCESS
    )
  }
}
```

#### GitHub Actions flujo de trabajo que se genera a partir de un proyecto de origen

```yaml
jobs:
  job1:
  job2:
    needs: job1
  job3:
    needs: [job1, job2]
```

### Construir con múltiples sistemas operativos

#### Canalización de Jenkins que se compila con varios sistemas operativos

```yaml
pipeline {
  agent none
  stages {
    stage('Run Tests') {
      matrix {
        axes {
          axis {
            name: 'PLATFORM'
            values: 'macos', 'linux'
          }
        }
        agent { label "${PLATFORM}" }
        stages {
          stage('test') {
            tools { nodejs "node-20" }
            steps {
              dir("scripts/myapp") {
                sh(script: "npm install -g bats")
                sh(script: "bats tests")
              }
            }
          }
        }
      }
    }
  }
}
```

#### GitHub Actions flujo de trabajo que se compila con varios sistemas operativos

```yaml
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@v6
      - uses: actions/setup-node@v7
        with:
          node-version: 20
      - run: npm install -g bats
      - run: bats tests
        working-directory: ./scripts/myapp
```