diff --git a/api/jobs.go b/api/jobs.go index 9278f41a3..254322977 100644 --- a/api/jobs.go +++ b/api/jobs.go @@ -233,7 +233,8 @@ func (j *Jobs) ForceEvaluate(jobID string, q *WriteOptions) (string, *WriteMeta, return resp.EvalID, wm, nil } -// ForceEvaluate is used to force-evaluate an existing job. +// EvaluateWithOpts is used to force-evaluate an existing job and takes additional options +// for whether to force reschedule failed allocations func (j *Jobs) EvaluateWithOpts(jobID string, opts EvalOptions, q *WriteOptions) (string, *WriteMeta, error) { req := &JobEvaluateRequest{ JobID: jobID, diff --git a/website/source/docs/commands/job/eval.html.md.erb b/website/source/docs/commands/job/eval.html.md.erb index c3fcbe721..8ede561c1 100644 --- a/website/source/docs/commands/job/eval.html.md.erb +++ b/website/source/docs/commands/job/eval.html.md.erb @@ -43,12 +43,27 @@ Evaluate the job with ID "job1": ``` $ nomad job eval job1 -Created eval ID: "6754c2e3-9abb-e7e9-dc92-76aab01751c8" +==> Monitoring evaluation "0f3bc0f3" + Evaluation triggered by job "test" + Evaluation within deployment: "51baf5c8" + Evaluation status changed: "pending" -> "complete" +==> Evaluation "0f3bc0f3" finished with status "complete" +``` + +Evaluate the job with ID "job1" and return immediately: + +``` +$ nomad job eval -detach job1 +Created eval ID: "4947e728" ``` Evaluate the job with ID "job1", and reschedule any eligible failed allocations: ``` $ nomad job eval -force-reschedule job1 -Created eval ID: "6754c2e3-9abb-e7e9-dc92-76aab01751c8" +==> Monitoring evaluation "0f3bc0f3" + Evaluation triggered by job "test" + Evaluation within deployment: "51baf5c8" + Evaluation status changed: "pending" -> "complete" +==> Evaluation "0f3bc0f3" finished with status "complete" ``` \ No newline at end of file