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  ```