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 CI | GitHub 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-Variablen | Repository-, Organisations- oder Environment-Secrets und -Variablen |
rules: / only / except | on:-Trigger und if:-Ausdrücke |
needs: (DAG) | needs: |
parallel: matrix | strategy.matrix |
cache: mit key:files | actions/cache mit hashFiles() |
artifacts: | actions/upload-artifact |
artifacts: reports: junit | Test-Reporter-Action oder Upload |
dependencies: (Artefakt-Weitergabe) | actions/download-artifact |
extends: / include: / Templates | Composite Actions, wiederverwendbare Workflows (workflow_call) |
environment: | environment: |
when: manual | Environment mit erforderlichen Prüfern oder workflow_dispatch |
schedule-Pipelines | on.schedule; siehe Cron-Zeitpläne |
| GitLab Runner (Tags) | Runner-Labels |
| Container-Registry | GitHub 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 mitsetup-*. Verwenden Siecontainer:, 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 eslocalhostmit einem zugeordneten Port; mitcontainer:ist es der Service-Schlüssel. Fügen Sie einen Health-Check hinzu. cache: key: files: [poetry.lock]wird zucache: poetryinsetup-python, daspoetry.lockhasht. Siehe Poetry-Caching, pip-Caching und den allgemeinen Caching-Leitfaden.rules: if: $CI_COMMIT_BRANCH == "main"wird zumon-Trigger plus einemif.artifacts: reports: junithat 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_callsowieinputs/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
- Audit und Forecast mit dem Importer durchführen.
- Die wichtigste Test-Pipeline portieren und auf einem Branch ausführen.
- 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.
- Secrets, Environments und Deploy-Jobs umziehen. Gegen Staging testen.
- Branch Protection aktualisieren, sodass GitHub-Checks vorausgesetzt werden.
- 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.
Verwandt
- CircleCI zu GitHub Actions migrieren: Schritt für SchrittCircleCI zu GitHub Actions migrieren: mit Konzept-Zuordnungstabelle, Gegenüberstellung der Konfiguration, Secrets, Caching, Importer und Umstellungsplan.
- Von Jenkins zu GitHub Actions migrieren: Schritt für SchrittJenkins zu GitHub Actions migrieren: Jenkinsfile-Zuordnungstabelle, Übersetzung nebeneinander, Credentials, Caching, Agents, Importer und Umstellungsplan.
- GitLab CI vs. GitHub Actions mit compiler.dev-RunnernGitLab CI vs. GitHub Actions auf compiler.dev-Runnern: Preise pro Platz, Rechenminuten, All-in-one-DevOps und Migration der .gitlab-ci.yml.
- Die besten GitLab-CI-Alternativen 2026Die besten GitLab-CI-Alternativen 2026: GitHub Actions, CircleCI, Buildkite, Semaphore, Jenkins und compiler.dev, mit Preisen und Hinweisen zur Migration.