github.com/iqoqo/nomad@v0.11.3-0.20200911112621-d7021c74d101/website/pages/docs/commands/deployment/fail.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: deployment fail'
     4  sidebar_title: fail
     5  description: |
     6    The deployment fail command is used to manually fail a deployment.
     7  ---
     8  
     9  # Command: deployment fail
    10  
    11  The `deployment fail` command is used to mark a deployment as failed. Failing a
    12  deployment will stop the placement of new allocations as part of rolling
    13  deployment and if the job is configured to auto revert, the job will attempt to
    14  roll back to a stable version.
    15  
    16  ## Usage
    17  
    18  ```plaintext
    19  nomad deployment fail [options] <deployment id>
    20  ```
    21  
    22  The `deployment fail` command requires a single argument, a deployment ID or
    23  prefix.
    24  
    25  ## General Options
    26  
    27  @include 'general_options.mdx'
    28  
    29  ## Fail Options
    30  
    31  - `-detach`: Return immediately instead of monitoring. A new evaluation ID
    32    will be output, which can be used to examine the evaluation using the
    33    [eval status] command.
    34  
    35  - `-verbose`: Show full information.
    36  
    37  ## Examples
    38  
    39  Manually mark an ongoing deployment as failed:
    40  
    41  ```shell-sessionnomad deployment fail 8990cfbc
    42  Deployment "8990cfbc-28c0-cb28-ca31-856cf691b987" failed
    43  
    44  ==> Monitoring evaluation "a2d97ad5"
    45      Evaluation triggered by job "example"
    46      Evaluation within deployment: "8990cfbc"
    47      Evaluation status changed: "pending" -> "complete"
    48  ==> Evaluation "a2d97ad5" finished with status "complete"
    49  
    50  $ nomad deployment status 8990cfbc
    51  ID          = 8990cfbc
    52  Job ID      = example
    53  Job Version = 2
    54  Status      = failed
    55  Description = Deployment marked as failed
    56  
    57  Deployed
    58  Task Group  Desired  Placed  Healthy  Unhealthy
    59  cache       3        2       1        0
    60  ```
    61  
    62  [eval status]: /docs/commands/eval-status