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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: deployment list'
     4  sidebar_title: list
     5  description: |
     6    The deployment list command is used to list deployments.
     7  ---
     8  
     9  # Command: deployment list
    10  
    11  The `deployment list` command is used list all deployments.
    12  
    13  ## Usage
    14  
    15  ```plaintext
    16  nomad deployment list [options]
    17  ```
    18  
    19  The `deployment list` command requires no arguments.
    20  
    21  When ACLs are enabled, this command requires a token with the 'read-job'
    22  capability for the deployment's namespace.
    23  
    24  ## General Options
    25  
    26  @include 'general_options.mdx'
    27  
    28  ## List Options
    29  
    30  - `-json` : Output the deployments in their JSON format.
    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  ```