So verwenden Sie Checksum für kontinuierliche End-to-End-Tests in CI/CD

By Paulo Gardini Miguel on Aug 19, 2026

Dieser Leitfaden richtet sich an technische und QA-Verantwortliche, die End-to-End-Tests benötigen, die innerhalb ihrer bestehenden CI/CD-Pipeline selbstständig erstellt, ausgeführt und repariert werden. Sie erfahren, wie Sie Checksum einrichten, in GitHub Actions oder GitLab CI integrieren und die Testsuite bei Änderungen an Ihrer Anwendung fehlerfrei halten.

TABLE OF CONTENTS Wie Checksum kontinuierliche End-to-End-Tests unterstützt Voraussetzungen für kontinuierliche End-to-End-Tests mit Checksum So führen Sie kontinuierliche End-to-End-Tests mit Checksum durch Woran Sie erfolgreiche kontinuierliche End-to-End-Tests erkennen Häufige Fehler bei kontinuierlichen End-to-End-Tests und Tipps von Experten Fazit

PARTNER-PERSPEKTIVEN

Dies ist gesponserter Inhalt von Checksum. Hier erfahren Sie mehr über unseren transparenten redaktionellen Ansatz.

End-to-End-Tests (E2E) in CI/CD auszuführen funktioniert nur, wenn sich Ihre Testsuite gemeinsam mit Ihrer Anwendung weiterentwickeln kann. Wenn sich Ihr Produkt verändert, kann das manuelle Erstellen neuer Tests und Beheben fehlerhafter Tests schnell zum Engpass werden, der jede Veröffentlichung verlangsamt.

Checksum wurde entwickelt, um einen großen Teil dieses Prozesses zu automatisieren.

Dieser Leitfaden zeigt Ihnen, wie Sie Checksum mit Ihrer Umgebung und Ihrem Repository verbinden, Playwright-Tests in Ihrer CI/CD-Pipeline generieren und ausführen und die autonome Wartung aktivieren, während sich Ihre Anwendung weiterentwickelt.

Wie Checksum kontinuierliche E2E-Tests unterstützt

Checksum unterstützt kontinuierliche E2E-Tests durch einen kontinuierlichen Ablauf:

Einrichten: Verbindet Ihr Repository mit Ihrer Testumgebung.
Erkennen: Analysiert Ihre Anwendung und identifiziert die wichtigsten zu testenden Benutzerabläufe.
Generieren: Erstellt produktionsbereite Playwright-Tests und übermittelt sie als Pull Requests an Ihr Repository.
Ausführen: Führt diese Tests lokal oder in Ihrer CI/CD-Pipeline aus, während die automatische Wiederherstellung versucht, vorübergehende Fehler während der Ausführung zu beheben.
Reparieren: Aktualisiert fehlerhafte Playwright-Tests, wenn sich Ihre Anwendung verändert, und eröffnet einen Pull Request mit der vorgeschlagenen Korrektur.
Überwachen: Verfolgt den Zustand der Tests und benachrichtigt Ihr Team, wenn Probleme Aufmerksamkeit erfordern.

Da jeder Test aus standardmäßigem Playwright-Code besteht, behalten Sie die vollständige Kontrolle und können die Testsuite mit oder ohne Checksum ausführen.

Voraussetzungen für kontinuierliche E2E-Tests in Checksum

Bevor Sie Checksum für kontinuierliche E2E-Tests einrichten, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind.

Eine Staging- oder produktionsähnliche Umgebung

Checksum testet eine laufende Anwendung. Daher benötigen Sie eine zugängliche Staging- oder produktionsähnliche Umgebung mit einer Umgebungs-URL. Wenn Ihre Anwendung eine Authentifizierung erfordert, konfigurieren Sie eine Anmelde-URL und stellen Sie Testbenutzer-Anmeldedaten bereit, die Checksum verwenden kann, um sich anzumelden und die Benutzerabläufe Ihrer Anwendung zu analysieren.

Ein verbundenes Repository und eine CI-Pipeline

Verbinden Sie Ihr GitHub- oder GitLab-Repository, damit Checksum Ihre Codebasis analysieren und Pull Requests mit generierten oder aktualisierten Playwright-Tests erstellen kann. Wenn sich Ihre Tests in einem separaten Repository befinden, verbessert die Verbindung sowohl des Quell- als auch des Test-Repositorys die Genauigkeit der Ablauf-Erkennung.

Außerdem benötigen Sie eine CI-Plattform, um Ihre Tests auszuführen. Checksum bietet integrierte Unterstützung für GitHub Actions und GitLab CI/CD. Andere CI-Plattformen können über die Checksum-Befehlszeilenschnittstelle oder die öffentliche API integriert werden.

Ein Checksum-Projekt und ein API-Schlüssel

Erstellen Sie in der Web-App ein Checksum-Projekt und generieren Sie unter Projekteinstellungen einen Projekt-API-Schlüssel. Der API-Schlüssel authentifiziert die Checksum-Befehlszeilenschnittstelle und ermöglicht es Ihrer CI-Pipeline, die für die Ausführung Ihrer Tests erforderlichen Umgebungsvariablen herunterzuladen.

Wenn Sie eine ausführlichere Anleitung zum anfänglichen Einrichtungsprozess wünschen, können Sie auch {{deeplink:154034:Checksums Einstiegsseite:getting_started}}

So führen Sie kontinuierliche E2E-Tests in Checksum durch

Die folgenden Schritte setzen voraus, dass Sie ein Checksum-Projekt erstellt haben und Ihr API-Schlüssel bereitliegt.

Schritt 1. Verbinden Sie Ihre Umgebung und Ihr Repository

Legen Sie im Einrichtungsassistenten der Web-App Ihre Umgebungs-URL (z. B. https://staging.myapp.com) und die Anmelde-URL fest und fügen Sie die Anmeldedaten des Testbenutzers hinzu, mit denen sich Checksum authentifizieren wird.

Installieren Sie anschließend die Git-App für GitHub oder GitLab, damit Checksum Ihren Code lesen und PRs eröffnen kann. Wenn Ihre Tests zusammen mit Ihrem Quellcode gespeichert werden, verbinden Sie dasselbe Repository für beide.

Schritt 2. Initialisieren Sie Ihr Test-Repository

Erstelle (oder bestimme) ein Repository für deine Tests und initialisiere es über die CLI:

mkdir my-checksum-tests && cd my-checksum-tests
npm init -y
npm install @checksum-ai/runtime playwright
npx checksumai init

Dadurch wird ein checksum/-Ordner mit Konfiguration, einer Playwright-Konfiguration und einem Beispieltest erstellt. Überprüfe die Einrichtung, bevor du fortfährst:

npm install
npx playwright install --with-deps
npx checksumai dotenv --download --api-key=<YOUR_API_KEY>
npx checksumai test -g "example"

Der Beispieltest bestätigt, dass die Anmeldung in deiner Umgebung funktioniert. Ein grünes Ergebnis bedeutet, dass du bereit bist, echte Abläufe zu erkennen.

Schritt 3. Lass den Agenten kritische Benutzerabläufe erkennen

Starte eine Erkennungssitzung und lass den E2E-Agenten deine Anwendung analysieren, um wichtige Benutzerabläufe zu identifizieren. Sobald die Erkennung abgeschlossen ist, überprüfe die vorgeschlagenen Abläufe und priorisiere vor der Testerstellung diejenigen, die für dein Release am relevantesten sind.

Schritt 4. Erstelle für den Produktionseinsatz geeignete Playwright-Tests

Erstelle Playwright-Tests für die von dir ausgewählten Abläufe.

Der Agent plant, implementiert, überprüft und verifiziert jeden Test, bevor er einen Pull Request mit einer für Menschen lesbaren Story-Datei und dem Playwright-Test eröffnet.

Überprüfe den Pull Request wie jede andere Codeänderung und führe anschließend die Tests zusammen, die du in deine Testsuite aufnehmen möchtest.

Schritt 5. Binde die Tests in deine CI/CD-Pipeline ein

Speichere für GitHub Actions deinen API-Schlüssel und die Umgebungswerte als Repository-Geheimnisse und füge anschließend einen Workflow hinzu, der Playwright installiert, die Checksum-Umgebungsdatei herunterlädt und die Testsuite ausführt:

name: Checksum-Tests ausführen
on:
workflow_dispatch:        # manueller Auslöser zum Starten
# schedule:
#   - cron: '0 0 * * *'   # nächtlich, sobald verifiziert
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: NPM-Abhängigkeiten installieren
run: npm install
- name: Playwright mit Abhängigkeiten installieren
run: npx playwright install --with-deps
- name: .env von Checksum herunterladen
run: npx checksumai dotenv --download --api-key="${{ secrets.CHECKSUM_API_KEY }}"
- name: Checksum-Tests ausführen
run: npx checksumai test
env:
CHECKSUM_API_KEY: ${{ secrets.CHECKSUM_API_KEY }}
USERNAME: ${{ secrets.USERNAME }}
PASSWORD: ${{ secrets.PASSWORD }}
LOGIN_URL: ${{ secrets.LOGIN_URL }}
BASE_URL: ${{ secrets.BASE_URL }}
CI: true

GitLab CI/CD folgt in .gitlab-ci.yml demselben Aufbau. Beginne mit einer manuellen Auslösung ( workflow_dispatch / when: manual ), um zu bestätigen, dass der Lauf fehlerfrei ist, und wechsle anschließend zu einem Zeitplan für nächtliche Zustandsprüfungen oder einer Auslösung beim Zusammenführen, um die Funktion nach Bereitstellungen zu verifizieren.

Schritt 6. Füge Läufe pro Pull Request hinzu und aktiviere die autonome Fehlerbehebung

Wenn Checksum Tests für jeden Pull Request ausführen soll, verwende die offizielle GitHub Action, anstatt die CLI auf deinem eigenen Runner auszuführen. Dies ist hilfreich, um die in jedem Pull Request eingeführten Änderungen zu validieren.

name: Checksum-Tests
on: pull_request
permissions:
contents: read
pull-requests: read
jobs:
checksum:
runs-on: ubuntu-latest
steps:
- uses: checksum-ai/test-run-action@v1
with:
api-key: ${{ secrets.CHECKSUM_API_KEY }}
grep: 'checkout'
auto-heal: true

Die grep-Option filtert anhand des Namens, welche Tests ausgeführt werden, während auto-heal: true die automatische Fehlerbehebung aktiviert, wenn ein Test fehlschlägt.

Standardmäßig wird der Workflow nach der Annahme des Laufs beendet und veröffentlicht die Ergebnisse als Kommentar im Pull Request. Wenn der Workflow auf das endgültige Ergebnis warten und entsprechend erfolgreich oder fehlerhaft beendet werden soll, setze wait: true.

Wenn die automatische Selbstheilung aktiviert ist, versucht Checksum während des Testlaufs, Fehler in Echtzeit zu beheben. Falls der Test weiterhin fehlschlägt, aktualisiert Checksum den Playwright-Test, eröffnet einen Pull-Request mit dem vorgeschlagenen Fix und veröffentlicht den Fortschritt als Kommentar im ursprünglichen Pull-Request.

Ihr Team kann die Änderungen dann wie jeden anderen Codebeitrag prüfen und zusammenführen.

So sieht erfolgreiches kontinuierliches E2E-Testen aus

Sobald Checksum in Ihre CI/CD-Pipeline integriert ist, sollten Sie Folgendes erwarten:

Ihre E2E-Testsuite wird automatisch auf Grundlage des von Ihnen konfigurierten Auslösers ausgeführt, einschließlich Pull-Requests, geplanten Ausführungen und Bereitstellungen.
Neue Benutzerabläufe werden erkannt und in Playwright-Tests umgewandelt, ohne dass jeder Test manuell geschrieben werden muss.
Durch Anwendungsänderungen verursachte Testfehler werden durch automatische Wiederherstellung oder automatische Selbstheilung behoben, bevor manuelle Aktualisierungen erforderlich sind.
Ihr Team verbringt weniger Zeit mit der Pflege von Playwright-Tests und mehr Zeit mit der Prüfung sinnvoller Teständerungen, die über Pull-Requests bereitgestellt werden.

Um den Zustand Ihrer Implementierung zu messen, überwachen Sie Ihre Erfolgsquote bei Tests, den Prozentsatz der automatisch geheilten Tests, die durchschnittliche Zeit zur Behebung von Testfehlern und die Rate falsch positiver Ergebnisse.

Diese Kennzahlen helfen Ihnen zu verstehen, wie zuverlässig Ihre E2E-Testsuite ausgeführt wird, während sich Ihre Anwendung weiterentwickelt. Um Ihre Ergebnisse mit Produktionsvergleichswerten zu vergleichen, liefert der QA-Vergleichsbericht von Checksum Daten zu diesen Kennzahlen, die auf mehr als 1 Mio. echten Produktionsausführungen basieren.

Häufige Fehler beim kontinuierlichen E2E-Testen und Tipps von Experten

Selbst bei der richtigen Einrichtung können einige häufige Fehler die Testqualität, Ausführung und Wartung beeinträchtigen. Hier erfahren Sie, worauf Sie achten sollten und wie Sie diese Fehler vermeiden.

Tests in einer instabilen Umgebung ausführen

Wenn Ihre Testergebnisse inkonsistent sind oder fehlschlagen, bevor eine aussagekräftige Testausführung beginnt, ist Ihre Testumgebung möglicherweise noch nicht bereit. Stellen Sie sicher, dass Ihre Bereitstellungs- oder produktionsnahe Umgebung stabil ist, die Zugangsdaten Ihres Testbenutzers ordnungsgemäß funktionieren und der Beispieltest erfolgreich ausgeführt wird, bevor Sie zusätzliche Abdeckung generieren.

Zu viele Benutzerabläufe generieren

Checksum erkennt möglicherweise mehr Benutzerabläufe, als Sie zunächst benötigen. Das Generieren von Tests für jeden möglichen Ablauf erhöht die Ausführungszeit und den Prüfaufwand. Beginnen Sie mit den für Ihre Releases wichtigsten Abläufen und erweitern Sie die Abdeckung im Laufe der Zeit.

Generierte Tests ohne Prüfung zusammenführen

Generierte und geheilte Tests werden als Pull-Requests bereitgestellt, damit Ihr Team jede Änderung prüfen kann, bevor sie Teil der Testsuite wird. Prüfen Sie neue Tests in den frühen Phasen der Einführung sorgfältig und gewinnen Sie im Laufe der Zeit Vertrauen in den Generierungsprozess.

Ihre Pipeline zu früh automatisieren

Bevor Sie Ausführungen planen oder Tests für jeden Pull-Request auslösen, stellen Sie durch manuelle Ausführungen sicher, dass Ihre Pipeline stabil ist. Sobald Sie zuverlässig konsistente Ergebnisse erhalten, können Sie den Workflow mit größerer Sicherheit automatisieren.

Jeden Pull-Request blockieren

Durch die Aktivierung von wait: true wartet der Workflow vor dem Abschluss, bis der Testlauf beendet ist. Verwenden Sie diese Option nur für Workflows, die einen Merge blockieren müssen. Für alle anderen Fälle liefert der standardmäßige Pull-Request-Kommentar Feedback, ohne CI-Runner zu blockieren.

Fazit

Sie haben nun gesehen, wie Checksum in einen kontinuierlichen E2E-Test-Workflow integriert wird – von der Verbindung Ihrer Umgebung und Ihres Repositorys über die Generierung von Playwright-Tests und deren Integration in Ihre CI/CD-Pipeline bis hin zur Aktivierung autonomer Wartung.

Während sich Ihre Anwendung weiterentwickelt, hilft Checksum dabei, Ihre E2E-Testsuite zuverlässig zu halten, ohne denselben Umfang an manueller Wartung hinzuzufügen.

Wenn Sie die Plattform näher kennenlernen möchten, können Sie unsere ausführliche Checksum-Bewertung lesen, um mehr über ihre Funktionen zu erfahren, oder sehen, wie Checksum mit Ihrer eigenen Anwendung funktioniert, indem Sie direkt mit dem Team Kontakt aufnehmen.

Häufig gestellte Fragen

Ja. Checksum generiert standardmäßige Playwright-Tests, die in Ihrem Repository versioniert werden, sodass Sie sie mit oder ohne Checksum lesen, bearbeiten und ausführen können.

Checksum versucht zunächst, den Fehler während der Testausführung automatisch zu beheben. Wenn das Problem nicht behoben werden kann, aktualisiert die automatische Fehlerbehebung den Playwright-Test und erstellt einen Pull-Request zur Prüfung durch Ihr Team.

Beide Optionen werden unterstützt. Sie können die CLI auf Ihrem eigenen CI-Runner ausführen oder die GitHub Action verwenden, damit Checksum die Testausführung übernimmt.

Ein verwalteter Testdienst ist darauf angewiesen, dass Menschen Ihre Tests erstellen und pflegen. Checksum automatisiert einen großen Teil dieser Arbeit, indem es Playwright-Tests direkt in Ihrer eigenen CI/CD-Pipeline generiert und pflegt.

Ja. Checksum funktioniert mit Ihren vorhandenen Playwright-Tests, schließt Lücken in der Testabdeckung und generiert neue Tests, wenn sich Ihre Anwendung weiterentwickelt.