Zum Inhalt springen

GitLab CI zu GitHub Actions migrieren: Schritt für Schritt

Zuletzt aktualisiert am

Die Migration von GitLab CI zu GitHub Actions ist eine ziemlich direkte Übersetzung. Stages werden zu needs, rules werden zu on plus if, cache und artifacts werden auf actions/cache und upload-artifact abgebildet, und services entsprechen services. Die kniffligen Stellen sind include und extends (verwenden Sie wiederverwendbare Workflows und Composite Actions), CI/CD-Variablen (Secrets werden nicht exportiert) sowie GitLab-spezifische Funktionen wie die integrierte Container-Registry und Review Apps.

Verwandte Seiten: GitLab CI vs. GitHub Actions und Alternativen zu GitLab CI.

Zuordnung der Konzepte

GitLab CIGitHub Actions
.gitlab-ci.yml.github/workflows/*.yml
stages:Job-Reihenfolge mit needs:
job:jobs.<id>
image:container: am Job oder setup-*-Actions verwenden
services:services:
script:steps: - run:
before_script: / after_script:Vorherige Schritte oder Schritte mit if: always()
variables:env:
Projekt-/Gruppen-CI/CD-VariablenRepository-, Organisations- oder Environment-Secrets und -Variablen
rules: / only / excepton:-Trigger und if:-Ausdrücke
needs: (DAG)needs:
parallel: matrixstrategy.matrix
cache: mit key:filesactions/cache mit hashFiles()
artifacts:actions/upload-artifact
artifacts: reports: junitTest-Reporter-Action oder Upload
dependencies: (Artefakt-Weitergabe)actions/download-artifact
extends: / include: / TemplatesComposite Actions, wiederverwendbare Workflows (workflow_call)
environment:environment:
when: manualEnvironment mit erforderlichen Prüfern oder workflow_dispatch
schedule-Pipelineson.schedule; siehe Cron-Zeitpläne
GitLab Runner (Tags)Runner-Labels
Container-RegistryGitHub Packages (ghcr.io) oder eine andere Registry
$CI_COMMIT_SHA, $CI_COMMIT_BRANCH${{ github.sha }}, ${{ github.ref_name }}

Eine realistische Pipeline im direkten Vergleich

GitLab:

# .gitlab-ci.yml
stages: [build, test, deploy]

default:
  image: python:3.13
  cache:
    key:
      files: [poetry.lock]
    paths: [.cache/pip]

variables:
  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"

build:
  stage: build
  script:
    - pip install poetry
    - poetry build
  artifacts:
    paths: [dist/]
    expire_in: 1 week

test:
  stage: test
  parallel:
    matrix:
      - PYVER: ["3.12", "3.13"]
  image: python:$PYVER
  services:
    - postgres:16
  variables:
    POSTGRES_PASSWORD: postgres
    DATABASE_URL: postgres://postgres:postgres@postgres:5432/postgres
  script:
    - pip install -r requirements.txt
    - pytest --junitxml=report.xml
  artifacts:
    when: always
    reports:
      junit: report.xml

deploy:
  stage: deploy
  script: ./scripts/deploy.sh
  environment: production
  rules:
    - if: $CI_COMMIT_BRANCH == "main"
  needs: [test]

GitHub Actions:

# .github/workflows/ci.yml
name: CI
on:
  push:
    branches: [main]
  pull_request:

jobs:
  build:
    runs-on: ubuntu-latest        # or [self-hosted, Linux, compiler-ci]
    steps:
      - uses: actions/checkout@v6
      - run: pipx install poetry
      - uses: actions/setup-python@v7
        with:
          python-version: "3.13"
          cache: poetry
      - run: poetry build
      - uses: actions/upload-artifact@v4
        with:
          name: dist
          path: dist/
          retention-days: 7

  test:
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        python: ["3.12", "3.13"]
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_PASSWORD: postgres
        ports: ["5432:5432"]
        options: >-
          --health-cmd "pg_isready -U postgres"
          --health-interval 5s --health-retries 10
    env:
      DATABASE_URL: postgres://postgres:postgres@localhost:5432/postgres
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v7
        with:
          python-version: ${{ matrix.python }}
          cache: pip
      - run: pip install -r requirements.txt
      - run: pytest --junitxml=report.xml
      - uses: actions/upload-artifact@v4
        if: always()
        with:
          name: junit-${{ matrix.python }}
          path: report.xml

  deploy:
    needs: [build, test]
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    runs-on: ubuntu-latest
    environment: production
    steps:
      - uses: actions/checkout@v6
      - run: ./scripts/deploy.sh

Worauf Sie achten sollten:

  • GitLab führt jeden Job in image: aus. In Actions läuft der Job auf der Runner-VM, und Sie installieren die Sprache mit setup-*. Verwenden Sie container:, wenn Sie ein bestimmtes Image benötigen.
  • Services: In GitLab ist der Service-Host der Image-Name (postgres). In Actions mit einem Job auf dem Runner ist es localhost mit einem zugeordneten Port; mit container: ist es der Service-Schlüssel. Fügen Sie einen Health-Check hinzu.
  • cache: key: files: [poetry.lock] wird zu cache: poetry in setup-python, das poetry.lock hasht. Siehe Poetry-Caching, pip-Caching und den allgemeinen Caching-Leitfaden.
  • rules: if: $CI_COMMIT_BRANCH == "main" wird zum on-Trigger plus einem if.
  • artifacts: reports: junit hat kein direktes Gegenstück; laden Sie die Datei hoch oder verwenden Sie eine JUnit-Reporter-Action.

Variablen, Secrets und Environments

GitLab variables marked masked or protected become GitHub secrets. Protected variables, available only on protected branches, map to environment secrets with branch protection rules on the environment. You must copy values manually; there is no export of secret values. File-type variables become secrets you write to a file in a step. Predefined CI_ variables map to GitHub contexts (github., runner.*).

Für Cloud-Zugangsdaten ersetzt OIDC gespeicherte Schlüssel: GitHub Actions OIDC mit AWS. Weitere Härtungsmaßnahmen finden Sie unter GitHub Actions absichern.

Include, Extends und Templates

GitLab-Pipelines teilen YAML-Code oft über include: und extends:. Wählen Sie den Actions-Mechanismus nach Umfang:

  • Eine gemeinsame Schrittfolge: eine Composite Action in einem gemeinsamen Repository.
  • Ein ganzer gemeinsam genutzter Job oder eine Pipeline: ein wiederverwendbarer Workflow mit on: workflow_call sowie inputs/secrets.
  • Vorlagen mit vielen Überschreibungen: wiederverwendbare Workflows mit Inputs oder ein Ansatz mit generierten YAML-Dateien.

Wiederverwendbare Workflows können nicht alles, was extends kann (zum Beispiel das tiefe Zusammenführen beliebiger Schlüssel). Planen Sie daher eher eine Umstrukturierung als eine reine Übersetzung ein.

Was GitLab mitbringt, GitHub aber nicht

  • Container-Registry: Nutzen Sie GitHub Packages (ghcr.io) oder eine externe Registry.
  • Review Apps und Environments-Dashboard: GitHub Environments und Deployments decken einen Teil davon ab; Preview-Umgebungen müssen Sie selbst einrichten.
  • Integrierte Vorlagen für Sicherheitsscans: GitHub bietet Code Scanning und Dependabot; siehe Dependabot-Einrichtung.
  • Merge Trains: Das GitHub-Pendant ist die Merge Queue.
  • Child Pipelines und dynamische Pipelines: Verwenden Sie Workflow-Aufrufe und Matrix-Strategien.

Automatisierte Konvertierung: GitHub Actions Importer

Der Importer von GitHub ist eine gh-Erweiterung. Laut der GitHub-Dokumentation (geprüft im Oktober 2026) unterstützt er GitLab (Cloud und selbst gehostet), Jenkins, CircleCI, Azure DevOps, Bamboo, Bitbucket Pipelines und Travis CI und setzt Docker sowie die GitHub CLI voraus.

gh extension install github/gh-actions-importer
gh actions-importer configure
gh actions-importer audit gitlab --output-dir audit --namespace my-group

Die dokumentierten Befehle sind audit, forecast, dry-run und migrate. Führen Sie audit aus, um eine Übersicht zu erhalten, welche Teile sich konvertieren lassen, und forecast, um Ihre Actions-Minuten anhand des bisherigen GitLab-Pipeline-Verlaufs abzuschätzen. Danach erzeugt dry-run Workflows lokal. Die Dokumentation des GitHub Importers nennt die Flags, die Ihre GitLab-Konfiguration benötigt. Behandeln Sie die Ausgabe als Entwurf: include/extends-Strukturen müssen insbesondere geprüft werden.

Umstellungsplan

  1. Audit und Forecast mit dem Importer durchführen.
  2. Die wichtigste Test-Pipeline portieren und auf einem Branch ausführen.
  3. Eine Zeit lang parallel betreiben: Lassen Sie GitLab CI weiterlaufen und vergleichen Sie die Ergebnisse. Wenn Sie den Code während dieser Phase noch auf GitLab belassen, beachten Sie, dass Actions das Repository auf GitHub benötigt; planen Sie den Umzug des Repositorys als eigenen Schritt.
  4. Secrets, Environments und Deploy-Jobs umziehen. Gegen Staging testen.
  5. Branch Protection aktualisieren, sodass GitHub-Checks vorausgesetzt werden.
  6. GitLab CI abschalten und die alte Konfiguration archivieren.

Geschwindigkeit nach dem Umzug

GitLab-Shared-Runner und die standardmäßigen 2-vCPU-Runner von GitHub unterscheiden sich in der Größe; vergleichen Sie beides, bevor Sie urteilen. Größere GitHub-Runner kosten mehr; siehe Preise von GitHub Actions. compiler.dev führt dieselben Workflows auf Maschinen mit 8 vCPU / 16 GB aus, zu $0.008 pro Minute, über runs-on: [self-hosted, Linux, compiler-ci], mit automatischem Rückfall auf Ihre ursprünglichen Runner; siehe Preise und schnellere Runner.

FAQ

Muss ich mein Repository von GitLab zu GitHub verschieben?

Ja, denn GitHub Actions läuft nur auf Repositorys, die auf GitHub gehostet werden. Planen Sie die Code-Migration zusammen mit der CI-Migration.

Wie ersetze ich include und extends von GitLab?

Composite Actions für gemeinsam genutzte Schritte, wiederverwendbare Workflows für gemeinsam genutzte Jobs.

Werden GitLab-CI-Variablen automatisch übernommen?

Nein. Geheimnis-Werte lassen sich nicht exportieren; tragen Sie sie als GitHub-Secrets erneut ein.

Was ersetzt die Weitergabe von Artefakten zwischen Stages in GitLab?

upload-artifact in einem Job und download-artifact im nächsten, zusammen mit needs.

Kann ich während des Umzugs beide CI-Systeme betreiben?

Ja, auf einem gespiegelten oder duplizierten Repository. Vergleichen Sie die Ergebnisse, bevor Sie die erforderlichen Checks umstellen.

Diesen Workflow auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen