github.com/iqoqo/nomad@v0.11.3-0.20200911112621-d7021c74d101/website/pages/docs/commands/job/eval.mdx (about)

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