github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/job/deployments.mdx (about)

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