# Migrieren von Jenkins zu GitHub Actions

GitHub Actions und Jenkins weisen mehrere Gemeinsamkeiten auf, was die Migration zu GitHub Actions relativ einfach macht.

## Einführung

Jenkins und GitHub Actions ermöglichen Ihnen beide, Workflows zu erstellen, mit denen Code automatisch kompiliert, getestet, veröffentlicht, freigegeben und bereitgestellt wird. Jenkins und GitHub Actions teilen einige Ähnlichkeiten in der Workflowkonfiguration:

* Jenkins erstellt Workflows mit *deklarativen Pipelines*, die GitHub Actions Workflow-Dateien ähneln.
* Jenkins verwendet *Phasen*, um eine Reihe von Schritten auszuführen, während GitHub Actions Jobs verwendet, um einen oder mehrere Schritte oder einzelne Befehle zu gruppieren.
* Jenkins und GitHub Actions unterstützen containerbasierte Builds. Weitere Informationen finden Sie unter [Creating a Docker container action (Erstellen einer Docker-Containeraktion)](/de/actions/tutorials/use-containerized-services/create-a-docker-container-action).
* Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden.

Weitere Informationen finden Sie unter [Grundlegendes zu GitHub Actions](/de/actions/get-started/understand-github-actions).

## Wichtige Unterschiede

* Jenkins hat zwei Arten von Syntax zur Erzeugung von Pipelines: Deklarative Pipeline und „Scripted“ (Skript-basierte) Pipeline.
  GitHub Actions verwendet YAML zum Erstellen von Workflows und Konfigurationsdateien. Weitere Informationen finden Sie unter [Workflowsyntax für GitHub Actions](/de/actions/reference/workflows-and-actions/workflow-syntax).
* Die Jenkins-Deployments sind üblicherweise selbstgehostet, wobei die Benutzer:innen die Server in ihren eigenen Rechenzentren verwalten.
  GitHub Actions bietet einen Hybrid-Cloud-Ansatz, indem es eigene Runner hostet, die Sie zum Ausführen von Jobs verwenden können, und gleichzeitig selbstgehostete Runner unterstützt. Weitere Informationen finden Sie unter [Selbstgehosteten Runnern](/de/actions/concepts/runners/self-hosted-runners).

## Funktionaltäten im Vergleich

### Deine Builds verteilen

Mit Jenkins kannst Du Builds an einen einzelnen Build-Agenten senden oder sie über mehrere Agenten verteilen. Du kannst diese Agenten auch nach verschiedenen Attributen klassifizieren, wie zum Beispiel Arten von Betriebssystemen.

Ebenso kann GitHub Actions Jobs an von GitHub gehostete oder selbstgehostete Runner senden, und Sie können Labels verwenden, um Runner anhand verschiedener Attribute zu klassifizieren. Weitere Informationen findest du unter [Grundlegendes zu GitHub Actions](/de/actions/get-started/understand-github-actions#runners) und [Selbstgehosteten Runnern](/de/actions/concepts/runners/self-hosted-runners).

### Sektionen verwenden, um Pipelines zu organisieren

Jenkins teilt seine deklarativen Pipelines in mehrere Abschnitte auf. Ebenso organisiert GitHub Actions seine Workflows in verschiedene Abschnitte. In der folgenden Tabelle werden die Abschnitte Von Jenkins mit dem GitHub Actions Workflow verglichen.

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

## using-Direktiven

Jenkins verwendet Anweisungen, um *deklarative Pipelines* zu verwalten. Diese Anweisungen definieren die Merkmale Deines Workflows und die Art und weise, wie dieser ausgeführt wird. In der folgenden Tabelle wird veranschaulicht, wie diese Direktiven Konzepten zugeordnet werden GitHub Actions.

| Anweisungen in Jenkins                                                                                                                              | GitHub Actions                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment)                                                                           | [`jobs.<job_id>.env`](/de/actions/reference/workflows-and-actions/workflow-syntax#env) <br> [`jobs.<job_id>.steps[*].env`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsenv)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                                                   | [`jobs.<job_id>.strategy`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategy) <br> [`jobs.<job_id>.strategy.fail-fast`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategyfail-fast) <br> [`jobs.<job_id>.timeout-minutes`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idtimeout-minutes)                                                                                                                                                                                                                                                                                                                       |
| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                                                | [`inputs`](/de/actions/reference/workflows-and-actions/metadata-syntax#inputs) <br> [`outputs`](/de/actions/reference/workflows-and-actions/metadata-syntax#outputs-for-docker-container-and-javascript-actions)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers)                                                                                 | [`on`](/de/actions/reference/workflows-and-actions/workflow-syntax#on) <br> [`on.<event_name>.types`](/de/actions/reference/workflows-and-actions/workflow-syntax#onevent_nametypes) <br> [<code>on.\<push>.\<branches\|tags></code>](/de/actions/reference/workflows-and-actions/workflow-syntax#onpushbranchestagsbranches-ignoretags-ignore) <br> [<code>on.\<pull\_request>.\<branches></code>](/de/actions/reference/workflows-and-actions/workflow-syntax#onpull_requestpull_request_targetbranchesbranches-ignore) <br> [<code>on.\<push\|pull\_request>.paths</code>](/de/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`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idneeds)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| [Jenkins-Cron-Syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax)                                                                     | [`on.schedule`](/de/actions/reference/workflows-and-actions/workflow-syntax#onschedule)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage)                                                                                       | [`jobs.<job_id>`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_id) <br> [`jobs.<job_id>.name`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idname)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools)                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [Spezifikationen für von GitHub gehostete Runner](/de/actions/concepts/runners/github-hosted-runners#preinstalled-software-for-github-owned-images) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input)                                                                                       | [`inputs`](/de/actions/reference/workflows-and-actions/metadata-syntax#inputs)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when)                                                                                         | [`jobs.<job_id>.if`](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idif)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Sequenzielle „Stages“ (Phasen) verwenden

### Parallele Verarbeitung von Aufträgen

Jenkins kann die `stages` und `steps` parallel ausführen.
GitHub Actions führt Jobs parallel aus und kann mithilfe einer Syntax auf Schrittebene auch Schritte innerhalb eines Jobs gleichzeitig ausführen. Weitere Informationen finden Sie unter [Workflowsyntax für GitHub Actions](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsbackground).

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

### Matrix

Sowohl GitHub Actions als auch Jenkins ermöglichen Ihnen, eine Matrix zu verwenden, um verschiedene Systemkombinationen zu definieren.

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

### Schritte verwenden, um Aufgaben auszuführen

Jenkins gruppiert Schritte (`steps`) in Phasen (`stages`). Jeder dieser Schritte kann unter anderem ein Skript, eine Funktion oder ein Befehl sein. Ebenso verwendet GitHub Actions`jobs`, um bestimmte Gruppen von `steps` auszuführen.

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

## Beispiele für häufige Aufgaben

### Auszuführende Pipeline mit `cron` planen

#### Jenkins-Pipeline mit `cron`

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

#### GitHub Actions Workflow mit `cron`

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

Weitere Informationen zu `schedule`-Ereignissen und zur akzeptierter Cron-Syntax findest du unter [Ereignisse zum Auslösen von Workflows](/de/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule).

### Umgebungsvariablen in einer Pipeline konfigurieren

#### Jenkins-Pipeline mit einer Umgebungsvariablen

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

#### GitHub Actions Workflow mit einer Umgebungsvariable

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

### Von Upstream-Projekten ausgehend bauen

#### Jenkins-Pipeline, die aus einem Upstream-Projekt erstellt wird

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

#### GitHub Actions Workflow, der aus einem upstream-Projekt erstellt wird

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

### Mit mehreren Betriebssystemen bauen

#### Jenkins-Pipeline, die mit mehreren Betriebssystemen erstellt wird

```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 Workflow, der mit mehreren Betriebssystemen erstellt wird

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