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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: deployment list'
     4  description: |
     5    The deployment list command is used to list deployments.
     6  ---
     7  
     8  # Command: deployment list
     9  
    10  The `deployment list` command is used list all deployments.
    11  
    12  ## Usage
    13  
    14  ```plaintext
    15  nomad deployment list [options]
    16  ```
    17  
    18  The `deployment list` command requires no arguments.
    19  
    20  When ACLs are enabled, this command requires a token with the 'read-job'
    21  capability for the deployment's namespace.
    22  
    23  ## General Options
    24  
    25  @include 'general_options.mdx'
    26  
    27  ## List Options
    28  
    29  - `-json` : Output the deployments in their JSON format.
    30  - `-filter`: Specifies an expression used to filter query results.
    31  - `-t` : Format and display the deployments using a Go template.
    32  - `-verbose`: Show full information.
    33  
    34  ## Examples
    35  
    36  List all tracked deployments:
    37  
    38  ```shell-session
    39  $ nomad deployment list
    40  ID        Job ID   Job Version  Status      Description
    41  8990cfbc  example  2            failed      Deployment marked as failed
    42  62eb607c  example  1            successful  Deployment completed successfully
    43  5f271fe2  example  0            successful  Deployment completed successfully
    44  ```