Background Job
Trabalho em segundo plano
Um trabalho em segundo plano é uma tarefa que o servidor executa separadamente da página ou da resposta da API que pode iniciá-lo. A resposta pode ser concluída antes que o trabalho termine.
accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retryGET /jobs/job_482accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retryJOBOutro exemplo
Uma solicitação de relatório cria o job `report-204` e responde com um link de status. Um Job do Kubernetes executa o relatório até que ele seja concluído com sucesso ou alcance o limite de tentativas, registra esse estado final e para.
Partes principais
- 01ID do trabalho e entrada salva
- 02Estado aceito ou em fila
- 03Executor e tentativa
- 04Progresso ou sinal de atividade
- 05Estado de sucesso ou falha
- 06Resultado e caminho de recuperação
Use-o quando
Use um trabalho em segundo plano quando um trabalho lento puder ser concluído após a pessoa receber uma resposta. Salve sua entrada, identidade, status e resultado final.
Não o use quando
Não use isso quando a resposta precisar do resultado agora. Um executor pode tentar novamente um trabalho que falhou. Adicione uma regra de segurança antes de repetir cobranças, e-mails ou outros efeitos.
Nome usado no código
accepted request -> persisted job ID -> runner attempt -> terminal result; bounded retry Antes de lançar
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 Trabalho em segundo plano (Background Job). User context: Uma solicitação de relatório cria o job `report-204` e responde com um link de status. Um Job do Kubernetes executa o relatório até que ele seja concluído com sucesso ou alcance o limite de tentativas, registra esse estado final e para. Technical concept or control: Trabalho em segundo plano (Background Job). Why it fits: Use um trabalho em segundo plano quando um trabalho lento puder ser concluído após a pessoa receber uma resposta. Salve sua entrada, identidade, status e resultado final. Do not use it when: Não use isso quando a resposta precisar do resultado agora. Um executor pode tentar novamente um trabalho que falhou. Adicione uma regra de segurança antes de repetir cobranças, e-mails ou outros efeitos. 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): Nenhum padrão oficial único controla todo o termo. Seu significado pode mudar entre equipes, plataformas ou frameworks. 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.
Conferir este pedido
Review how Trabalho em segundo plano (Background Job) is used now. Definition: Um trabalho em segundo plano é uma tarefa que o servidor executa separadamente da página ou da resposta da API que pode iniciá-lo. A resposta pode ser concluída antes que o trabalho 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.