Add config network topic, incl. macvlan ui (#203)

* Draft of macvlan topic

* Add topic on config networks

* Incorporate feedback
This commit is contained in:
Jim Galasyn 2017-08-09 08:25:54 -07:00
parent cca5f739c2
commit fa9c3cece6
1 changed files with 52 additions and 0 deletions

View File

@ -0,0 +1,52 @@
---
title: Use a local node network in a swarm
description: Learn how to use a local node network, like MAC VLAN, in a UCP swarm.
keywords: ucp, network, macvlan
---
Docker Universal Control Plane can use your local networking drivers to
orchestrate your swarm. You can create a *config* network, with a driver like
MAC VLAN, and you use it like any other named network in UCP. If it's set up
as attachable, you can attach containers.
> Security
>
> Encrypting communication between containers on different nodes works only on
> overlay networks.
## Use UCP to create node-specific networks
Always use UCP to create node-specific networks. You can use the UCP web UI
or the CLI (with an admin bundle), but don't side-band to the Docker engines
directly, otherwise your networks may be mislabelled and become inaccessible.
When you create a config network *without* UCP, you `ssh` to each node in the
swarm, and `docker network create --config-only ...` for each back-end network.
Then, on a manager node, you create the central network once, with the
`--config-from` option.
Don't do this when you're using UCP. You must create the node-specific networks
through the UCP web UI or CLI. In either case, you should create all of the
config-only networks before you create the config-from network.
## Create a MAC VLAN network
1. Log in as an administrator.
2. Navigate to **Networks** and click **Create Network**.
3. Name the network "macvlan".
4. In the **Driver** dropdown,. select **Macvlan**.
5. In the **Macvlan Configure** section, select the configuration option.
- **Config Only**: Prefix the `config-only` network name with a node hostname
prefix, like `node1/my-cfg-network`, `node2/my-cfg-network`, *etc*. This is
necessary to ensure that the access labels are applied consistently to all of
the back-end config-only networks. UCP routes the config-only network creation
to the appropriate node based on the node hostname prefix. All config-only
networks with the same name must belong in the same collection, or UCP returns
an error. Leaving the access label empty puts the network in the admin's default
collection, which is `/` in a new UCP installation.
- **Config From**: Create the network from a Docker config. Don't set up an
access label for the config-from network. The labels of the network and its
collection placement are inherited from the related config-only networks.
6. Click **Create** to create the network.