Tests nach dem Deployment: CI/CD und Deep-Prüfungen

Ein erfolgreiches Deployment bestätigt die Veröffentlichung des Codes. Es beweist noch nicht, dass die Anwendung ihre Nutzer korrekt bedient. Ein Smoke-Test kann ein Produkt öffnen und den Warenkorb prüfen; eine Deep-Prüfung kontrolliert eine Hintergrundaufgabe. Beide sind DockRay-Szenarien für unterschiedliche Anwendungsebenen.

Szenarien aus CI/CD starten

Die Szenarioeinstellungen enthalten Informationen zum externen Aufruf. Verwenden Sie den privaten Schlüssel des Projekts als Bearer-Token. Speichern Sie ihn in geschützten Pipeline-Secrets, nicht im Repository oder öffentlichen Protokoll. Externe Aufrufe setzen die entsprechende Funktion Ihres Kontotarifs voraus.

POST /api/v1/flows/{flow}/run
Authorization: Bearer <PROJECT_PRIVATE_KEY>

Ersetzen Sie {flow} durch die Szenario-ID aus dem Panel. Eine Antwort 202 mit queued bestätigt die Annahme des Auftrags, keinen bestandenen Test. Lesen Sie poll_url und requested_at aus der Antwort.

Keine alten Ergebnisse mit neuen verwechseln

Fragen Sie die zurückgegebene Adresse mit since ab und setzen Sie den Parameter auf den korrekt URL-kodierten Wert von requested_at. So wird ein vorheriger Durchlauf nicht zum Ergebnis des neuen Deployments. Wartezustände wie queued, running und pending erfordern weitere Abfragen. Erst passed bestätigt Erfolg; failed bedeutet Fehlschlag und inconclusive erlaubt kein Urteil. Werten Sie weder den HTTP-Code noch success allein als Testergebnis.

Mit wait kann die Verbindung höchstens zwei Minuten auf ein Ergebnis warten. delay verschiebt den Start um die angegebene Minutenzahl, üblicherweise 1–60, etwa zum Aufwärmen des Caches. Bei Verzögerung erfolgt die Antwort sofort; kombinieren Sie dies nicht mit Warten auf derselben Verbindung. Behandeln Sie Häufigkeitslimits und ausgeschöpfte Kontingente, statt unbegrenzt erneut anzufragen.

Antwortformat eines Deep-Endpunkts

Implementieren Sie einen öffentlichen, per Token geschützten HTTPS-Endpunkt, der JSON zurückgibt. DockRay ruft ihn auf; der Prüfcode läuft in Ihrer Anwendung. Beispiel:

{"status":"pass","message":"Import completed","steps":[{"label":"Import","status":"pass","duration_ms":12}]}

Verwenden Sie pass bei erfüllter Bedingung, fail bei nicht erfüllter Bedingung und skip, wenn kein Urteil möglich ist. Definieren Sie ein messbares Kriterium, beispielsweise das Alter des letzten erfolgreichen Imports. Meldungen dürfen keine Secrets oder Kundendaten enthalten. Das Token dieses Endpunkts und der private DockRay-Projektschlüssel erfüllen verschiedene Aufgaben.

Szenarien über MCP ausführen

flows.list, flows.get und flows.run ermöglichen Lesen und Auslösen von Szenarien. Voraussetzung sind MCP-Zugang und passende Schlüsselberechtigungen. Leserechte allein erlauben keine Ausführung. Tarif- und Ausführungslimits gelten weiterhin.

Wählen Sie die passende Prüfung mit dem Leitfaden zum synthetischen Monitoring und untersuchen Sie Fehlschläge mit der Anleitung zur Fehlerdiagnose.