# Переход с Jenkins на GitHub Actions

GitHub Actions и Дженкинс имеют множество сходств, что делает миграцию относительно GitHub Actions простой.

## Введение

Jenkins и GitHub Actions оба позволяют создавать рабочие процессы, которые автоматически создают, тестируют, публикуются, выпускают и размещают код. Дженкинс и GitHub Actions разделяет некоторые сходства в конфигурации рабочих процессов:

* Jenkins создаёт рабочие процессы с использованием *декларативных конвейеров*, которые похожи на GitHub Actions файлы рабочих процессов.
* Jenkins использует *этапы* для выполнения набора шагов, а GitHub Actions задания — для группировки одного или нескольких шагов или отдельных команд.
* Jenkins и GitHub Actions поддерживают сборки на основе контейнеров. Дополнительные сведения см. в разделе [Создание действия контейнера Docker](/ru/actions/tutorials/use-containerized-services/create-a-docker-container-action).
* Шаги или задачи можно повторно использовать и предоставлять сообществу.

Дополнительные сведения см. в разделе [Понимание GitHub Actions](/ru/actions/get-started/understand-github-actions).

## Основные отличия

* Jenkins имеет два типа синтаксиса для создания конвейеров: декларативный конвейер и конвейер со скриптами.
  GitHub Actions использует YAML для создания рабочих процессов и конфигурационных файлов. Дополнительные сведения см. в разделе [Синтаксис рабочего процесса для GitHub Actions](/ru/actions/reference/workflows-and-actions/workflow-syntax).
* Развертывания Jenkins обычно являются локальными, при этом пользователи обслуживают серверы в своих центрах обработки данных.
  GitHub Actions предлагает гибридный облачный подход, размещая собственные раннеры, которые можно использовать для выполнения задач, а также поддерживая самостоятельные бегунки. Дополнительные сведения см. в разделе [Локальные средства выполнения тестов](/ru/actions/concepts/runners/self-hosted-runners).

## Сравнение возможностей

### Распространение сборок

Jenkins позволяет отправлять сборки одному агенту сборки или распределять их между несколькими агентами. Вы также можете классифицировать эти агенты в соответствии с различными атрибутами, такими как типы операционных систем.

Аналогично, GitHub Actions можно отправлять задания - GitHubhosted или самостоятельно размещенным бегунам, а также использовать метки для классификации бегунов по различным атрибутам. Дополнительные сведения см. в разделе \[AUTOTITLE и [Понимание GitHub Actions](/ru/actions/get-started/understand-github-actions#runners)]\(/actions/concepts/runners/self-hosted-runners).

### Использование разделов для упорядочения конвейеров

Jenkins разделяет свои декларативные конвейеры на несколько разделов. Аналогично, GitHub Actions он организует свои рабочие процессы в отдельные секции. Таблица ниже сравнивает разделы Дженкинса с рабочим GitHub Actions процессом.

| Директивы Jenkins                                               | GitHub Actions                                                                                                                                                                                                             |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent)   | [`jobs.<job_id>.runs-on`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idruns-on) <br> [`jobs.<job_id>.container`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idcontainer) |
| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post)     | нет                                                                                                                                                                                                                        |
| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobs)                                                                                                                                                 |
| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps)   | [`jobs.<job_id>.steps`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps)                                                                                                                       |

## Директивы using

Jenkins использует директивы для управления *декларативными конвейерами*. Эти директивы определяют характеристики рабочего процесса и порядок его выполнения. Таблица ниже демонстрирует, как эти директивы соответствуют понятиям внутри GitHub Actions.

| Директивы Jenkins                                                                                                                                        | GitHub Actions                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment)                                                                                | [`jobs.<job_id>.env`](/ru/actions/reference/workflows-and-actions/workflow-syntax#env) <br> [`jobs.<job_id>.steps[*].env`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsenv)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                                                        | [`jobs.<job_id>.strategy`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategy) <br> [`jobs.<job_id>.strategy.fail-fast`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategyfail-fast) <br> [`jobs.<job_id>.timeout-minutes`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idtimeout-minutes)                                                                                                                                                                                                                                                                                                                       |
| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                                                     | [`inputs`](/ru/actions/reference/workflows-and-actions/metadata-syntax#inputs) <br> [`outputs`](/ru/actions/reference/workflows-and-actions/metadata-syntax#outputs-for-docker-container-and-javascript-actions)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers)                                                                                      | [`on`](/ru/actions/reference/workflows-and-actions/workflow-syntax#on) <br> [`on.<event_name>.types`](/ru/actions/reference/workflows-and-actions/workflow-syntax#onevent_nametypes) <br> [<code>on.\<push>.\<branches\|tags></code>](/ru/actions/reference/workflows-and-actions/workflow-syntax#onpushbranchestagsbranches-ignoretags-ignore) <br> [<code>on.\<pull\_request>.\<branches></code>](/ru/actions/reference/workflows-and-actions/workflow-syntax#onpull_requestpull_request_targetbranchesbranches-ignore) <br> [<code>on.\<push\|pull\_request>.paths</code>](/ru/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`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idneeds)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| [Синтаксис cron в Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax)                                                                     | [`on.schedule`](/ru/actions/reference/workflows-and-actions/workflow-syntax#onschedule)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage)                                                                                            | [`jobs.<job_id>`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_id) <br> [`jobs.<job_id>.name`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idname)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools)                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [Технические характеристики для GitHub-hosted бегунов](/ru/actions/concepts/runners/github-hosted-runners#preinstalled-software-for-github-owned-images) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input)                                                                                            | [`inputs`](/ru/actions/reference/workflows-and-actions/metadata-syntax#inputs)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when)                                                                                              | [`jobs.<job_id>.if`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idif)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Использование последовательных этапов

### Обработка параллельных заданий

Дженкинс может запускать и `stages``steps` параллельно.
GitHub Actions выполняет задачи параллельно, а также может одновременно выполнять шаги внутри задания с использованием синтаксиса на уровне шагов. Для получения дополнительной информации см. [Синтаксис рабочего процесса для GitHub Actions](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsbackground).

| Параллельное выполнение в Jenkins                                   | GitHub Actions                                                                                                                      |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs.<job_id>.strategy.max-parallel`](/ru/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategymax-parallel) |

### «Матрица»

Оба и Jenkins GitHub Actions позволяют использовать матрицу для определения различных комбинаций систем.

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

### Выполнение задач с помощью шагов

Jenkins группирует `steps` в `stages`. Каждый из этих шагов может быть, помимо прочего, скриптом, функцией или командой. Аналогично, GitHub Actions используется `jobs` для выполнения определённых групп `steps`.

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

## Примеры распространенных задач

### Планирование запуска конвейера с помощью `cron`

#### Конвейер Jenkins с `cron`

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

#### GitHub Actions Рабочий процесс с `cron`

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

Дополнительные сведения о `schedule` событиях и принятом синтаксисе cron см. в разделе [События, инициирующие рабочие процессы](/ru/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule).

### Настройка переменных среды в конвейере

#### Конвейер Jenkins с переменной среды

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

#### GitHub Actions Рабочий процесс с переменной среды

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

### Выполнение сборки из вышестоящих проектов

#### Конвейер Jenkins, который строится из вышестоящего проекта

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

#### GitHub Actions Рабочий процесс, который строится на основе upstream-проекта

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

### Выполнение сборки с несколькими операционными системами

#### Конвейер Jenkins, который строится с несколькими операционными системами

```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 Рабочий процесс, который строится на нескольких операционных системах

```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
```