Updating with information learned yesterday

Remove image-version flag from install and join
Adding example to uninstall

Signed-off-by: Mary Anthony <mary@docker.com>
This commit is contained in:
Mary Anthony 2016-02-16 20:35:13 -08:00 committed by Joao Fernandes
parent 1386f2c8f6
commit a53633faf7
3 changed files with 32 additions and 17 deletions

View File

@ -9,23 +9,22 @@ parent="mn_ucp"
# Enable container networking with UCP
Along with host and bridge networks, Docker Engine provides for users to create
container overlay networks. These networks span multiple hosts running Docker
Engine. Launching a container on one host, makes the container available to all
hosts in that container network. Another name for this capability is multi-host
network.
Along with host and bridge networks, Docker Engine lets users create container
overlay networks. These networks span multiple hosts running Docker Engine.
Launching a container on one host, makes the container available to all hosts in
that container network. Another name for this capability is multi-host networking.
This page explains how to use the `engine-discovery` command to enable
multi-host networks on your UCP installation. You'll do a complete configuration
on all nodes within your UCP deployment.
multi-host container networks on your UCP installation. You'll do a complete
configuration on all nodes within your UCP deployment.
## About container networks and UCP
You create a mulit-host container network using the Docker Engine client or the
UCP administration console. Container networks are custom networks you create
using the `overlay` network plugin driver. You must configure container networking
explicitly on UCP. Once you have your UCP installation running but
before you start using it, you enable container networks.
You create a container network using the Docker Engine client or the UCP
administration console. Container networks are custom networks you create using
the `overlay` network plugin driver. You must configure container networking
explicitly on UCP. Once you have your UCP installation running but before you
start using it, you enable container networks.
Enabling container networking is a process. First, you run the
`engine-discovery` subcommand on the node. This subcommand configures the Engine
@ -40,7 +39,7 @@ these key nodes. You should enable networking on the controller first and then
the replicas. Once these are configured, you run the subcommand on each worker
node.
Once you've enabled container networks, you can create one through UCP the
After you've configured discovery, you can create a container through UCP the
application or the Engine CLI. To create a network using the Engine CLI, open a
command line on any UCP node and do the following:
@ -112,7 +111,10 @@ To enable the networking feature, do the following.
network. The command installs discovery on a UCP installation
with a two controllers (a primary and a replica).
$ docker run --rm -it --name ucp -v /var/run/docker.sock:/var/run/docker.sock docker/ucp:0.8.0 engine-discovery --controller 192.168.99.106 --controller 192.168.99.116 --host-address 192.168.99.106
$ docker run --rm -it --name ucp \
-v /var/run/docker.sock:/var/run/docker.sock docker/ucp:0.8.0 engine-discovery \
--controller 192.168.99.106 --controller 192.168.99.116 \
--host-address 192.168.99.106
INFO[0000] New configuration established. Signaling the daemon to load it...
INFO[0001] Successfully delivered signal to daemon
@ -208,7 +210,22 @@ configuration and make sure you have properly configured it.
### daemon configuration errors
The `engine-discovery` command works by modifying the start configuration for
the Docker daemon. If you have trouble, try these troubleshooting measures:
the Docker daemon. The tool stores the configuration the
`/etc/docker/daemon.json` file on the node. To view the configuration:
```
$ sudo cat /etc/docker/daemon.json
{
"cluster-advertise": "10.0.11.78:12376",
"cluster-store": "etcd://10.0.11.78:12379,10.0.11.149:12379,10.0.26.238:12379",
"cluster-store-opts": {
"kv.cacertfile": "/var/lib/docker/discovery_certs/ca.pem",
"kv.certfile": "/var/lib/docker/discovery_certs/cert.pem",
"kv.keyfile": "/var/lib/docker/discovery_certs/key.pem"
}
```
If you have trouble with discovery, try these troubleshooting measures:
* Review the daemon logs to ensure the daemon was started.
* Add the `-D` (debug) to the Docker daemon start options.

View File

@ -52,7 +52,6 @@ before running the install.
| `--dns-search` [`--dns-search option --dns-search option`] | Set custom DNS search domains for the UCP infrastructure containers. |
| `--disable-tracking` | Disable anonymous tracking and analytics. |
| `--disable-usage` | Disable anonymous usage reporting. |
| `--image-version "0.7.0"` | Select a specific UCP version. |
| `--external-ucp-ca` | Set up UCP with an external CA. |
| `--preserve-certs` | Don't (re)generate certs on the host if existing ones are found. |
| `--binpack` | Set Swarm scheduler to binpack mode (default spread). |

View File

@ -52,7 +52,6 @@ To enable high-availability, you must join at least one node with the
| `--dns-search` [`--dns-search option --dns-search option`] | Set custom DNS search domains for the UCP infrastructure containers. |
| `--disable-tracking` | Disable anonymous tracking and analytics. |
| `--disable-usage` | Disable anonymous usage reporting. |
| `--image-version "0.7.0"` | Select a specific UCP version. |
| `--url` | The connection URL for the remote UCP controller [`$UCP_URL`] |
| `--fingerprint ` | The fingerprint of the UCP controller you trust [`$UCP_FINGERPRINT`] |
| `--replica` | Configure this node as a full Orca controller replica. |