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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: job deployments'
     4  sidebar_title: deployments
     5  description: |
     6    The deployments command is used to list deployments for a job.
     7  ---
     8  
     9  # Command: job deployments
    10  
    11  The `job deployments` command is used to display the deployments for a
    12  particular job.
    13  
    14  ## Usage
    15  
    16  ```plaintext
    17  nomad job deployments [options] <job>
    18  ```
    19  
    20  The `job deployments` command requires a single argument, the job ID or an ID
    21  prefix of a job to display the list of deployments for.
    22  
    23  When ACLs are enabled, this command requires a token with the `read-job` and
    24  `list-jobs` capabilities for the job's namespace.
    25  
    26  ## General Options
    27  
    28  @include 'general_options.mdx'
    29  
    30  ## Deployment Options
    31  
    32  - `-latest`: Display the latest deployment only.
    33  
    34  - `-json` : Output the deployment in its JSON format.
    35  
    36  - `-t` : Format and display the deployment using a Go template.
    37  
    38  - `-verbose`: Show full information.
    39  
    40  - `-all`: Display all deployments matching the job ID, even those from an
    41    older instance of the job.
    42  
    43  ## Examples
    44  
    45  List the deployment for a particular job:
    46  
    47  ```shell-session
    48  $ nomad job deployments example
    49  ID        Job ID   Job Version  Status      Description
    50  0b23b149  example  1            running     Deployment is running but requires manual promotion
    51  06ca68a2  example  0            successful  Deployment completed successfully
    52  ```