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

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