github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/docs/commands/deployment/pause.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: deployment pause'
     4  sidebar_title: pause
     5  description: >
     6    The deployment pause command is used to pause a deployment and disallow new
     7    placements.
     8  ---
     9  
    10  # Command: deployment pause
    11  
    12  The `deployment pause` command is used to pause a deployment. Pausing a
    13  deployment will pause the placement of new allocations as part of rolling
    14  deployment.
    15  
    16  ## Usage
    17  
    18  ```plaintext
    19  nomad deployment pause [options] <deployment id>
    20  ```
    21  
    22  The `deployment pause` command requires a single argument, a deployment ID or
    23  prefix.
    24  
    25  When ACLs are enabled, this command requires a token with the `submit-job`
    26  and `read-job` capabilities for the deployment's namespace.
    27  
    28  ## General Options
    29  
    30  @include 'general_options.mdx'
    31  
    32  ## Pause Options
    33  
    34  - `-verbose`: Show full information.
    35  
    36  ## Examples
    37  
    38  Manually pause a deployment:
    39  
    40  ```shell-session
    41  $ nomad deployment pause 2f14ba55
    42  Deployment "2f14ba55-acfb-cb31-821c-facf1b9b0830" paused
    43  ```