45126882cc
Updating with the docs fixes Updating with fixes from docs CI: SVENNNNNNNNN!!! Signed-off-by: Mary Anthony <mary@docker.com>
2.2 KiB
+++ title = "engine-discovery" keywords= ["engine-discovery, ucp"] description = "description" [menu.main] parent = "ucp_ref" +++
engine-discovery
Manage the Engine discovery configuration on a node.
Usage
docker run --rm -it \
--name ucp \
-v /var/run/docker.sock:/var/run/docker.sock \
docker/ucp \
engine-discovery [options]
Description
Use this command to display and update Engine discovery configuration on a node. The discovery configuration is used by Engine for cluster membership and multi-host networking.
Use one or more '--controller' arguments to specify all of the UCP controllers in this cluster.
The '--host-address' argument specifies the public advertise address for the particular node you are running the command on. This host-address is how other nodes in UCP talk to this node. You may specify an IP or hostname, and the command automatically detects and fills in the port number. If you omit the address, the tool attempts to discover the node's address.
This command uses the exit status of 0 for success. An exit status of 1 is used when run without the '--update' flag and when the configuration needs updating, and 2 is used for any failures.
Options
| Option | Description |
|---|---|
--debug, -D |
Enable debug. |
--jsonlog |
Produce json formatted output for easier parsing. |
--interactive, -i |
Enable interactive mode. You are prompted to enter all required information. |
--update |
Apply engine discovery configuration changes. |
--controller [--controller option --controller option] |
Update discovery with one or more controller's external IP address or hostname. |
--host-address |
Update the external IP address or hostname this node advertises itself as [$UCP_HOST_ADDRESS]. |