mirror of https://github.com/hashicorp/consul
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "Commands: Maint"
|
|
sidebar_current: "docs-commands-maint"
|
|
description: >
|
|
The `maint` command provides control of both service and node maintenance mode
|
|
---
|
|
|
|
# Consul Maint
|
|
|
|
Command: `consul maint`
|
|
|
|
The `maint` command provides control of both service and node maintenance mode.
|
|
Using the command, it is possible to mark a service provided by a node or the
|
|
node as a whole as "under maintenance". In this mode of operation, the service
|
|
or node will not appear in DNS query results, or API results. This effectively
|
|
takes the service or node out of the pool of available "healthy" nodes.
|
|
|
|
Under the hood, maintenance mode is activated by registering a health check in
|
|
critical status against a node or service, and deactivated by deregistering the
|
|
health check.
|
|
|
|
## Usage
|
|
|
|
Usage: `consul maint [options]`
|
|
|
|
Exactly one of `-enable` or `-disable` are required. The rest of the command
|
|
line arguments are optional, and some are only usable in combination with
|
|
others.
|
|
|
|
The list of available flags are:
|
|
|
|
* `-enable` - Enable maintenance mode on a given service or node. If
|
|
combined with the `-service` flag, we operate on a specific service ID.
|
|
Otherwise, node maintenance mode is enabled.
|
|
|
|
* `-disable` - Disable maintenance mode on a given service or node. If
|
|
combined with the `-service` flag, we operate on a specific service ID.
|
|
Otherwise, node maintenance mode is disabled.
|
|
|
|
* `-reason` - An optional reason for placing the node or service into
|
|
maintenance mode. If provided, this reason will be visible in the newly-
|
|
registered critical check's "Notes" field.
|
|
|
|
* `-service` - An optional service ID to control node maintenance mode for. By
|
|
providing this flag, the `-enable` and `-disable` flags functionality is
|
|
modified to operate on the given service ID.
|
|
|
|
* `-token` - ACL token to use. Defaults to that of agent.
|
|
|
|
* `-http-addr` - Address to the HTTP server of the agent you want to contact
|
|
to send this command. If this isn't specified, the command will contact
|
|
"127.0.0.1:8500" which is the default HTTP address of a Consul agent.
|