github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/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  When ACLs are enabled, this command requires a token with the `submit-job`
    25  capability for the job's namespace.
    26  
    27  ## General Options
    28  
    29  @include 'general_options.mdx'
    30  
    31  ## Eval Options
    32  
    33  - `-force-reschedule`: `force-reschedule` is used to force placement of failed
    34    allocations. If this is set, failed allocations that are past their reschedule
    35    limit, and those that are scheduled to be replaced at a future time are placed
    36    immediately. This option only places failed allocations if the task group has
    37    rescheduling enabled.
    38  
    39  - `-detach`: Return immediately instead of monitoring. A new evaluation ID
    40    will be output, which can be used to examine the evaluation using the
    41    [eval status] command.
    42  
    43  - `-verbose`: Show full information.
    44  
    45  ## Examples
    46  
    47  Evaluate the job with ID "job1":
    48  
    49  ```shell-session
    50  $ nomad job eval job1
    51  ==> Monitoring evaluation "0f3bc0f3"
    52      Evaluation triggered by job "test"
    53      Evaluation within deployment: "51baf5c8"
    54      Evaluation status changed: "pending" -> "complete"
    55  ==> Evaluation "0f3bc0f3" finished with status "complete"
    56  ```
    57  
    58  Evaluate the job with ID "job1" and return immediately:
    59  
    60  ```shell-session
    61  $ nomad job eval -detach job1
    62  Created eval ID: "4947e728"
    63  ```
    64  
    65  Evaluate the job with ID "job1", and reschedule any eligible failed allocations:
    66  
    67  ```shell-session
    68  $ nomad job eval -force-reschedule job1
    69  ==> Monitoring evaluation "0f3bc0f3"
    70      Evaluation triggered by job "test"
    71      Evaluation within deployment: "51baf5c8"
    72      Evaluation status changed: "pending" -> "complete"
    73  ==> Evaluation "0f3bc0f3" finished with status "complete"
    74  ```
    75  
    76  [eval status]: /docs/commands/eval-status