github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/job/eval.mdx (about)

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