github.com/quite/nomad@v0.8.6/website/source/docs/commands/job/eval.html.md.erb (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: job eval"
     4  sidebar_current: "docs-commands-job-eval"
     5  description: >
     6    The job eval command is used to force an evaluation of a job
     7  ---
     8  
     9  # Command: job eval
    10  
    11  The `job eval` command is used to force an evaluation of a job, given the job ID.
    12  
    13  ## Usage
    14  
    15  ```
    16  nomad job eval [options] <job_id>
    17  ```
    18  
    19  The `job eval` command requires a single argument, specifying the job ID to evaluate.
    20  If there is an exact match based on the provided job ID, then
    21  the job will be evaluated, forcing a scheduler run.
    22  
    23  ## General Options
    24  
    25  <%= partial "docs/commands/_general_options" %>
    26  
    27  ## Eval Options
    28  
    29  * `-force-reschedule`: `force-reschedule` is used to force placement of failed allocations.
    30  If this is set, failed allocations that are past their reschedule limit, and those that are
    31  scheduled to be replaced at a future time are placed immediately. This option only places failed
    32  allocations if the task group has rescheduling enabled.
    33  
    34  * `-detach`: Return immediately instead of monitoring. A new evaluation ID
    35    will be output, which can be used to examine the evaluation using the
    36    [eval status](/docs/commands/eval-status.html) command
    37  
    38  * `-verbose`: Show full information.
    39  
    40  ## Examples
    41  
    42  Evaluate the job with ID "job1":
    43  
    44  ```
    45  $ nomad job eval job1
    46  ==> Monitoring evaluation "0f3bc0f3"
    47      Evaluation triggered by job "test"
    48      Evaluation within deployment: "51baf5c8"
    49      Evaluation status changed: "pending" -> "complete"
    50  ==> Evaluation "0f3bc0f3" finished with status "complete"
    51  ```
    52  
    53  Evaluate the job with ID "job1" and return immediately:
    54  
    55  ```
    56  $ nomad job eval -detach job1
    57  Created eval ID: "4947e728"
    58  ```
    59  
    60  Evaluate the job with ID "job1", and reschedule any eligible failed allocations:
    61  
    62  ```
    63  $ nomad job eval -force-reschedule job1
    64  ==> Monitoring evaluation "0f3bc0f3"
    65      Evaluation triggered by job "test"
    66      Evaluation within deployment: "51baf5c8"
    67      Evaluation status changed: "pending" -> "complete"
    68  ==> Evaluation "0f3bc0f3" finished with status "complete"
    69  ```