Background Job
Trabajo en segundo plano
Un trabajo en segundo plano es una tarea que el servidor ejecuta separadamente de la página o la respuesta API que pueda iniciarlo. La respuesta puede completarse antes de que el trabajo termine.
accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retryGET /jobs/job_482accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retryJOBOtro ejemplo
Una solicitud de informe crea el trabajo `report-204` y responde con un enlace de estado. Un trabajo de Kubernetes ejecuta el informe hasta que tenga éxito o alcance su límite de reintentos, registra ese estado final y se detiene.
Partes principales
- 01ID de trabajo e ingreso guardado
- 02Estado aceptado o en cola
- 03Ejecutante e intento
- 04Progreso o latido
- 05Estado de éxito o fracaso
- 06resultado y ruta de recuperación
Úsalo cuando
Usa un trabajo en segundo plano cuando el trabajo lento pueda finalizar después de que la persona reciba una respuesta. Guarda su entrada, identidad, estado y resultado final.
No lo uses cuando
No lo uses cuando la respuesta necesite el resultado de inmediato. Un ejecutor puede intentar nuevamente un trabajo fallido. Agrega una regla de seguridad antes de repetir cargos, correos electrónicos u otros efectos.
Nombre usado en código
accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retry Antes de lanzarlo
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 Trabajo en segundo plano (Background Job). User context: Una solicitud de informe crea el trabajo `report-204` y responde con un enlace de estado. Un trabajo de Kubernetes ejecuta el informe hasta que tenga éxito o alcance su límite de reintentos, registra ese estado final y se detiene. Technical concept or control: Trabajo en segundo plano (Background Job). Why it fits: Usa un trabajo en segundo plano cuando el trabajo lento pueda finalizar después de que la persona reciba una respuesta. Guarda su entrada, identidad, estado y resultado final. Do not use it when: No lo uses cuando la respuesta necesite el resultado de inmediato. Un ejecutor puede intentar nuevamente un trabajo fallido. Agrega una regla de seguridad antes de repetir cargos, correos electrónicos u otros efectos. 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): Ningún estándar oficial único controla todo el término. Su significado puede cambiar según equipos, plataformas o marcos. 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.
Revisa esta petición
Review how Trabajo en segundo plano (Background Job) is used now. Definition: Un trabajo en segundo plano es una tarea que el servidor ejecuta separadamente de la página o la respuesta API que pueda iniciarlo. La respuesta puede completarse antes de que el trabajo termine. 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.