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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: deployment unblock'
     4  sidebar_title: unblock
     5  description: |
     6    The deployment unblock command is used to manually unblock a deployment.
     7  ---
     8  
     9  # Command: deployment unblock
    10  
    11  The `deployment unblock` command is used to manually mark a blocked
    12  multiregion deployment as successful. A blocked deployment is a multiregion
    13  deployment within a region that has completed within a region but is waiting
    14  on the other [federated regions]. The `deployment unblock` command can be used
    15  in cases where a failed peer region is unable to communicate its failed
    16  deployment status to other regions to force a deployment to complete.
    17  
    18  ## Usage
    19  
    20  ```plaintext
    21  nomad deployment unblock [options] <deployment id>
    22  ```
    23  
    24  The `deployment unblock` command requires a single argument, a deployment ID or
    25  prefix.
    26  
    27  When ACLs are enabled, this command requires a token with the `submit-job`
    28  and `read-job` capabilities for the deployment's namespace.
    29  
    30  ## General Options
    31  
    32  @include 'general_options.mdx'
    33  
    34  ## Unblock Options
    35  
    36  - `-detach`: Return immediately instead of monitoring. A new evaluation ID
    37    will be output, which can be used to examine the evaluation using the
    38    [eval status] command.
    39  
    40  - `-verbose`: Show full information.
    41  
    42  ## Examples
    43  
    44  Manually mark an ongoing deployment as unblocked. The deployment status shows
    45  an error on the unreachable "east" region.
    46  
    47  ```shell-session
    48  $ nomad deployment unblock 8990cfbc
    49  Deployment "8990cfbc-28c0-cb28-ca31-856cf691b987" unblocked
    50  
    51  ==> Monitoring evaluation "a2d97ad5"
    52      Evaluation triggered by job "example"
    53      Evaluation within deployment: "8990cfbc"
    54      Evaluation status changed: "pending" -> "complete"
    55  ==> Evaluation "a2d97ad5" finished with status "complete"
    56  
    57  $ nomad deployment status 8990cfbc
    58  ID          = 8990cfbc
    59  Job ID      = example
    60  Job Version = 2
    61  Status      = successful
    62  Description = Deployment successful
    63  
    64  Multi-region Deployment
    65  Region        ID        Status
    66  west          8990cfbc  successful
    67  south         085787e3  blocked
    68  east (error)  <none>    <none>
    69  
    70  Deployed
    71  Task Group  Desired  Placed  Healthy  Unhealthy
    72  cache       3        2       1        0
    73  ```
    74  
    75  [eval status]: /docs/commands/eval-status
    76  [federated regions]: https://learn.hashicorp.com/tutorials/nomad/federation