Background Job
Hintergrundauftrag
Ein Hintergrundjob ist eine Aufgabe, die der Server getrennt von der Seite oder der API-Antwort ausführt, die ihn möglicherweise gestartet hat. Die Antwort kann beendet sein, bevor der Job abgeschlossen ist.
accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retryGET /jobs/job_482accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retryJOBEin weiteres Beispiel
Eine Berichtsanfrage erstellt den Job `report-204` und antwortet mit einem Statuslink. Ein Kubernetes-Job führt den Bericht aus, bis er erfolgreich ist oder sein Wiederholungs-Limit erreicht wird, zeichnet diesen Endzustand auf und stoppt.
Hauptteile
- 01Job-ID und gespeicherte Eingaben
- 02Akzeptierter oder wartender Status
- 03Ausführer und Versuch
- 04Fortschritt oder Herzschlag
- 05Erfolgs- oder Fehlzustand
- 06Ergebnis- und Wiederherstellungspfad
Verwenden Sie es, wenn
Verwenden Sie einen Hintergrundauftrag, wenn langsame Arbeit fertiggestellt werden kann, nachdem die Person eine Antwort erhalten hat. Speichern Sie deren Eingabe, Identität, Status und Endergebnis.
Nutze es nicht, wenn
Verwenden Sie es nicht, wenn die Antwort das Ergebnis sofort benötigt. Ein Runner kann versuchen, einen fehlgeschlagenen Job erneut auszuführen. Fügen Sie eine Sicherheitsregel hinzu, bevor Sie wiederholte Belastungen, E-Mails oder andere Effekte auslösen.
In Code verwendeter Name
accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retry Vor dem Ausliefern
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with Hintergrundauftrag (Background Job). User context: Eine Berichtsanfrage erstellt den Job `report-204` und antwortet mit einem Statuslink. Ein Kubernetes-Job führt den Bericht aus, bis er erfolgreich ist oder sein Wiederholungs-Limit erreicht wird, zeichnet diesen Endzustand auf und stoppt. Technical concept or control: Hintergrundauftrag (Background Job). Why it fits: Verwenden Sie einen Hintergrundauftrag, wenn langsame Arbeit fertiggestellt werden kann, nachdem die Person eine Antwort erhalten hat. Speichern Sie deren Eingabe, Identität, Status und Endergebnis. Do not use it when: Verwenden Sie es nicht, wenn die Antwort das Ergebnis sofort benötigt. Ein Runner kann versuchen, einen fehlgeschlagenen Job erneut auszuführen. Fügen Sie eine Sicherheitsregel hinzu, bevor Sie wiederholte Belastungen, E-Mails oder andere Effekte auslösen. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): Kein einziger offizieller Standard kontrolliert den gesamten Begriff. Seine Bedeutung kann sich zwischen Teams, Plattformen oder Frameworks ändern. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Diese Anfrage prüfen
Review how Hintergrundauftrag (Background Job) is used now. Definition: Ein Hintergrundjob ist eine Aufgabe, die der Server getrennt von der Seite oder der API-Antwort ausführt, die ihn möglicherweise gestartet hat. Die Antwort kann beendet sein, bevor der Job abgeschlossen ist. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.