Dependabot-Einrichtung, die Ihr Team nicht überfordert
Zuletzt aktualisiert am
Dependabot öffnet Pull Requests, sobald für Ihre Abhängigkeiten neue Versionen oder Sicherheitskorrekturen verfügbar sind. Mit den Standardeinstellungen erzeugt er in einem aktiven Repository eine Flut kleiner PRs, die die Beteiligten mit der Zeit ignorieren, und genau das verfehlt den Zweck. Dieser Leitfaden zeigt, wie Sie ihn so einrichten, dass Updates in wenigen gebündelten PRs ankommen, Sicherheitskorrekturen weiterhin schnell umgesetzt werden und risikoarme Updates automatisch zusammengeführt werden.
Zwei Arten von Updates
- Sicherheitsupdates werden geöffnet, wenn für eine Abhängigkeit eine bekannte Schwachstelle vorliegt (aus der GitHub Advisory Database). Sie aktivieren sie in den Repository-Einstellungen unter Advisories und Dependabot alerts. Sie werden nicht durch den Zeitplan in Ihrer Konfigurationsdatei gesteuert.
- Versionsupdates werden für neue Releases geöffnet, unabhängig davon, ob eine Schwachstelle vorliegt, gemäß
dependabot.yml.
Behandeln Sie beide unterschiedlich. Sicherheitsupdates sollten zügig geprüft und zusammengeführt werden. Versionsupdates lassen sich bündeln und verlangsamen.
Eine gute Ausgangskonfiguration
Erstellen Sie .github/dependabot.yml:
version: 2
updates:
- package-ecosystem: "npm"
directory: "/"
schedule:
interval: "weekly"
day: "monday"
time: "06:00"
timezone: "Europe/London"
open-pull-requests-limit: 5
groups:
dev-dependencies:
dependency-type: "development"
update-types: ["minor", "patch"]
production-minor-patch:
dependency-type: "production"
update-types: ["minor", "patch"]
ignore:
- dependency-name: "*"
update-types: ["version-update:semver-major"]
labels: ["dependencies"]
commit-message:
prefix: "chore(deps)"
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "monthly"
groups:
actions:
patterns: ["*"]
Eine Konfiguration für Ihre Technologien erzeugen Sie mit dem Dependabot-Konfigurationsgenerator.
Die fünf Einstellungen, die das Rauschen reduzieren
1. Zeitplan. weekly ist ein guter Standard; für sich langsam entwickelnde Repositories eignet sich monthly. Tägliche Updates lohnen selten. Ein fester Tag und eine feste Uhrzeit sorgen dafür, dass die PRs dann erscheinen, wenn man sie erwartet.
2. Gruppen. Ohne Gruppierung sind 15 Bumps von Dev-Abhängigkeiten 15 PRs, 15 CI-Läufe und 15 Merges. Mit Gruppen ist es ein einziger PR. Gruppieren Sie nach Abhängigkeitstyp, nach Update-Typ oder nach Namensmuster (patterns: ["eslint", "@typescript-eslint/"]). Dependabot gruppiert nur Updates desselben Ökosystems und Verzeichnisses, und der PR einer Gruppe wird für die fälligen Versionsupdates geöffnet.
3. Major-Versionen standardmäßig ignorieren. Major-Releases erfordern meist Codeänderungen. Ignorieren Sie sie in der Konfiguration und führen Sie sie dann gezielt als geplante Arbeit durch. Sie können auch eine bestimmte Abhängigkeit ignorieren, bis Sie bereit sind:
ignore:
- dependency-name: "react"
versions: [">=19"]
4. Cooldown. Die Option cooldown verzögert ein neues Release, bevor Dependabot es vorschlägt. Viele schädliche oder fehlerhafte Releases werden innerhalb weniger Tage entdeckt und zurückgezogen, sodass eine Verzögerung die meisten davon vermeidet:
cooldown:
default-days: 5
semver-major-days: 30
semver-minor-days: 7
semver-patch-days: 3
Welche Ökosysteme Cooldown unterstützen, entnehmen Sie der aktuellen Referenz der Dependabot-Optionen. Beachten Sie, dass Sicherheitsupdates davon nicht verzögert werden.
5. Limit für offene PRs. open-pull-requests-limit ist für Versionsupdates standardmäßig auf 5 gesetzt. Senken Sie den Wert, wenn Ihre CI-Warteschlange überlastet ist. Mit 0 deaktivieren Sie Versionsupdates für diesen Eintrag (Sicherheitsupdates bleiben unberührt).
CI-Kosten im Griff behalten
Jeder Dependabot-PR führt Ihre vollständige CI aus. So begrenzen Sie das:
- Gruppieren Sie Updates (siehe oben), damit ein Lauf viele Bumps abdeckt.
- Verwenden Sie
concurrencymitcancel-in-progress, damit neu basierte PRs keine Läufe stapeln. - Führen Sie auf Abhängigkeits-PRs schlankere Prüfungen aus, etwa nur Unit-Tests, und die umfangreiche Suite in der Merge Queue. Siehe GitHub merge queue.
- Planen Sie Updates in eine Zeit, in der die CI untätig ist.
Nutzen Sie den CI-Minuten-Prognosierer, um zu sehen, was 20 zusätzliche PRs pro Woche kosten.
Die unbedenklichen Updates automatisch zusammenführen
Führen Sie Patch- und Minor-Updates von Dev-Abhängigkeiten automatisch zusammen, sobald die CI erfolgreich ist. Ein Workflow mit dependabot/fetch-metadata liest den Update-Typ aus:
name: dependabot-auto-merge
on: pull_request
permissions:
contents: write
pull-requests: write
jobs:
auto:
if: github.actor == 'dependabot[bot]'
runs-on: ubuntu-latest
steps:
- id: meta
uses: dependabot/fetch-metadata@v2
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
- if: steps.meta.outputs.update-type != 'version-update:semver-major'
run: gh pr merge --auto --squash "$PR_URL"
env:
PR_URL: ${{ github.event.pull_request.html_url }}
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Das Zusammenführen erfolgt erst, wenn die erforderlichen Prüfungen bestanden sind. Branch-Schutz und gute Tests machen es also sicher. Aktivieren Sie "Allow auto-merge" in den Repository-Einstellungen. Fixieren Sie dependabot/fetch-metadata auf einen SHA, wie unter GitHub Actions absichern beschrieben. Führen Sie nie eine automatische Zusammenführung für Produktionsabhängigkeiten aus, für die Sie keine verlässliche Testabdeckung haben.
GitHub Actions fixiert und aktuell halten
Fügen Sie das Ökosystem github-actions wie oben gezeigt hinzu. Dependabot aktualisiert sowohl Referenzen mit Tags als auch mit SHA-Pins; bei SHA-Pins hält er den nachgestellten Kommentar # v3.5.2 aktuell. So können Sie per SHA fixieren, ohne den Wartungsaufwand.
Zuweisung und Verantwortlichkeit
PRs brauchen einen Verantwortlichen, sonst schaut sie niemand an. Verwenden Sie statt der veralteten Optionen reviewers und assignees in dependabot.yml lieber CODEOWNERS, damit ein Team zur Prüfung angefragt wird, und Labels zum Filtern. Übergeben Sie die Rolle des "Verantwortlichen für Abhängigkeiten" wöchentlich weiter und halten Sie eine kurze Regel ein: grüne Patch-Updates am selben Tag zusammenführen, Major-Updates einplanen.
Monorepos und mehrere Verzeichnisse
Dependabot benötigt einen Eintrag updates pro Ökosystem und Verzeichnis. Bei vielen Verzeichnissen verwenden Sie directories (eine Liste oder ein Glob), um den Block nicht zu wiederholen:
- package-ecosystem: "npm"
directories: ["/", "/apps/*", "/packages/*"]
schedule:
interval: "weekly"
Gruppen sammeln dann Updates über diese Verzeichnisse hinweg, wenn dieselbe Abhängigkeit angehoben wird. Prüfen Sie in der Dokumentation Ihrer Dependabot-Version, wie Gruppen über mehrere Verzeichnisse gebildet werden.
FAQ
Wie viele Dependabot-PRs sind zu viele?
Wenn PRs länger als eine Woche offen bleiben, sind es zu viele. Ziehen Sie den Zeitplan an, gruppieren Sie stärker und reduzieren Sie ignorierte Ökosysteme.
Kostet Dependabot Geld?
Dependabot selbst ist kostenlos. Seine PRs führen jedoch Ihre CI aus und verbrauchen daher Actions-Minuten.
Sollte ich stattdessen Renovate verwenden?
Renovate bietet mehr Konfigurationsoptionen und funktioniert plattformübergreifend. Dependabot ist in GitHub integriert und benötigt kein eigenes Hosting. Beide unterstützen Gruppierung und Zeitplanung; wählen Sie nach den Funktionen, die Sie brauchen.
Kann ich ein Update vorübergehend stummschalten?
Ja, kommentieren Sie @dependabot ignore this minor version oder verwenden Sie ignore-Einträge. Oder nutzen Sie cooldown, um alles zu verlangsamen.
Verwandt
Schnellere CI macht Dependency-PRs günstiger in der Verarbeitung: Der Vergleichsmodus von compiler.dev zeigt, was Ihr Test-Workflow auf schnelleren Runnern kostet. Das ist nützlich, wenn Sie viele automatisierte PRs erhalten.
Verwandt
- TypeScript-Monorepo in GitHub Actions beschleunigenTypprüfung und Linting in TypeScript-Monorepos auf GitHub Actions beschleunigen: inkrementelles tsc, Projektreferenzen, Lint-Caches und parallele Jobs.
- Playwright im Monorepo mit GitHub Actions beschleunigenPlaywright-E2E-Tests in einem Node-Monorepo auf GitHub Actions beschleunigen: App einmal bauen, E2E überspringen, wenn sich die Web-App nicht ändert.
- CI-Geschwindigkeits-Badge in Ihre README einfügenZeigen Sie die Geschwindigkeit Ihrer CI mit einem README-Badge: die mediane Laufzeit Ihrer Repository-Workflows auf GitHub Actions, automatisch aktualisiert.
- Die besten Runner-Anbieter für GitHub Actions 2026Die besten GitHub-Actions-Runner-Anbieter nach Anwendungsfall: Preis, macOS, Docker-Builds, ARM, AWS, Flatrate. Preise Stand 22.10.2026.