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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: job periodic force'
     4  sidebar_title: periodic force
     5  description: >
     6    The job periodic force command is used to force the evaluation of a periodic
     7    job.
     8  ---
     9  
    10  # Command: job periodic force
    11  
    12  The `job periodic force` command is used to [force the evaluation] of a
    13  [periodic job].
    14  
    15  ## Usage
    16  
    17  ```plaintext
    18  nomad job periodic force [options] <job id>
    19  ```
    20  
    21  The `job periodic force` command requires a single argument, specifying the ID
    22  of the job. This job must be a periodic job. This is used to immediately run a
    23  periodic job, even if it violates the job's `prohibit_overlap` setting.
    24  
    25  By default, on successful job submission the command will enter an interactive
    26  monitor and display log information detailing the scheduling decisions and
    27  placement information for the forced evaluation. The monitor will exit after
    28  scheduling has finished or failed.
    29  
    30  ## General Options
    31  
    32  @include 'general_options.mdx'
    33  
    34  ## Run Options
    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  Force the evaluation of the job `example`, monitoring placement:
    45  
    46  ```shell-sessionnomad job periodic force example
    47  ==> Monitoring evaluation "54b2d6d9"
    48      Evaluation triggered by job "example/periodic-1555094493"
    49      Allocation "637aee17" created: node "a35ab8fc", group "cache"
    50      Allocation "637aee17" status changed: "pending" -> "running" (Tasks are running)
    51      Evaluation status changed: "pending" -> "complete"
    52  ==> Evaluation "54b2d6d9" finished with status "complete"
    53  ```
    54  
    55  Force the evaluation of the job `example` and return immediately:
    56  
    57  ```shell-sessionnomad job periodic force -detach example
    58  Force periodic successful
    59  Evaluation ID: 0865fbf3-30de-5f53-0811-821e73e63178
    60  ```
    61  
    62  [eval status]: /docs/commands/eval-status
    63  [force the evaluation]: /api-docs/jobs#force-new-periodic-instance
    64  [periodic job]: /docs/job-specification/periodic