github.com/smintz/nomad@v0.8.3/website/source/docs/commands/deployment/status.html.md.erb (about) 1 --- 2 layout: "docs" 3 page_title: "Commands: deployment status" 4 sidebar_current: "docs-commands-deployment-status" 5 description: > 6 The deployment status command is used to display the status of a deployment. 7 --- 8 9 # Command: deployment status 10 11 The `deployment status` command is used to display the status of a deployment. 12 The status will display the number of desired changes as well as the currently 13 applied changes. 14 15 ## Usage 16 17 ``` 18 nomad deployment status [options] <deployment id> 19 ``` 20 21 The `deployment status` command requires a single argument, a deployment ID or 22 prefix. 23 24 ## General Options 25 26 <%= partial "docs/commands/_general_options" %> 27 28 ## Status Options 29 30 * `-json` : Output the deployment in its JSON format. 31 32 * `-t` : Format and display the deployment using a Go template. 33 34 * `-verbose`: Show full information. 35 36 ## Examples 37 38 Inspect the status of a complete deployment: 39 40 ``` 41 $ nomad deployment status 06ca68a2 42 ID = 06ca68a2 43 Job ID = example 44 Job Version = 0 45 Status = successful 46 Description = Deployment completed successfully 47 48 Deployed 49 Task Group Desired Placed Healthy Unhealthy 50 cache 2 2 2 0 51 web 2 2 2 0 52 ``` 53 54 Inspect the status of a deployment that is waiting for canary promotion: 55 56 ``` 57 $ nomad deployment status 0b 58 ID = 0b23b149 59 Job ID = example 60 Job Version = 1 61 Status = running 62 Description = Deployment is running but requires promotion 63 64 Deployed 65 Task Group Promoted Desired Canaries Placed Healthy Unhealthy 66 cache false 2 1 1 0 0 67 web N/A 2 0 2 2 0 68 ```