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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: alloc stop'
     4  sidebar_title: stop
     5  description: |
     6    Stop and reschedule a running allocation
     7  ---
     8  
     9  # Command: alloc stop
    10  
    11  The `alloc stop` command allows a user to perform an in-place restart of an
    12  entire allocation or individual task.
    13  
    14  ## Usage
    15  
    16  ```plaintext
    17  nomad alloc stop [options] <allocation>
    18  ```
    19  
    20  The `alloc stop` command requires a single argument, specifying the alloc ID or
    21  prefix to stop. If there is an exact match based on the provided alloc ID or
    22  prefix, then the alloc will be stopped and rescheduled. Otherwise, a list of
    23  matching allocs and information will be displayed.
    24  
    25  Stop will issue a request to stop and reschedule the allocation. An interactive
    26  monitoring session will display log lines as the allocation completes shutting
    27  down. It is safe to exit the monitor early with ctrl-c.
    28  
    29  ## General Options
    30  
    31  @include 'general_options.mdx'
    32  
    33  ## Stop Options
    34  
    35  - `-detach`: Return immediately instead of entering monitor mode. After the
    36    stop command is submitted, a new evaluation ID is printed to the
    37    screen, which can be used to examine the rescheduling evaluation using the
    38    [eval status] command.
    39  
    40  - `-verbose`: Display verbose output.
    41  
    42  ## Examples
    43  
    44  ```shell-sessionnomad alloc stop c1488bb5
    45  ==> Monitoring evaluation "26172081"
    46      Evaluation triggered by job "example"
    47      Allocation "4dcb1c98" created: node "b4dc52b9", group "cache"
    48      Evaluation within deployment: "c0c594d0"
    49      Evaluation status changed: "pending" -> "complete"
    50  ==> Evaluation "26172081" finished with status "complete"
    51  
    52  $ nomad alloc stop -detach eb17e557
    53  8a91f0f3-9d6b-ac83-479a-5aa186ab7795
    54  ```
    55  
    56  [eval status]: /docs/commands/eval-status