2017-07-25 18:18:21 +00:00
|
|
|
---
|
2020-02-06 23:45:31 +00:00
|
|
|
layout: docs
|
|
|
|
|
page_title: 'Commands: deployment list'
|
|
|
|
|
description: |
|
2017-07-25 18:18:21 +00:00
|
|
|
The deployment list command is used to list deployments.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Command: deployment list
|
|
|
|
|
|
|
|
|
|
The `deployment list` command is used list all deployments.
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
```plaintext
|
2017-07-25 18:18:21 +00:00
|
|
|
nomad deployment list [options]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The `deployment list` command requires no arguments.
|
|
|
|
|
|
2020-11-19 21:38:08 +00:00
|
|
|
When ACLs are enabled, this command requires a token with the 'read-job'
|
|
|
|
|
capability for the deployment's namespace.
|
|
|
|
|
|
2017-07-25 18:18:21 +00:00
|
|
|
## General Options
|
|
|
|
|
|
2020-02-06 23:45:31 +00:00
|
|
|
@include 'general_options.mdx'
|
2017-07-25 18:18:21 +00:00
|
|
|
|
|
|
|
|
## List Options
|
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
- `-json` : Output the deployments in their JSON format.
|
2022-02-16 16:40:30 +00:00
|
|
|
- `-filter`: Specifies an expression used to filter query results.
|
2019-10-22 13:44:00 +00:00
|
|
|
- `-t` : Format and display the deployments using a Go template.
|
|
|
|
|
- `-verbose`: Show full information.
|
2017-07-25 18:18:21 +00:00
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
List all tracked deployments:
|
|
|
|
|
|
2020-05-18 20:53:06 +00:00
|
|
|
```shell-session
|
|
|
|
|
$ nomad deployment list
|
2017-07-25 18:18:21 +00:00
|
|
|
ID Job ID Job Version Status Description
|
|
|
|
|
8990cfbc example 2 failed Deployment marked as failed
|
|
|
|
|
62eb607c example 1 successful Deployment completed successfully
|
|
|
|
|
5f271fe2 example 0 successful Deployment completed successfully
|
|
|
|
|
```
|
