Open vSwitch是一个虚拟交换软件，主要用于虚拟机VM环境，提供网络的虚拟化。本篇文档重点介绍如何在Docker中使用Open vSwitch。这个文档描述了如何在Docker(大于或等于1.9.0版本)中使用Open vSwitch。我们假设你已经安装好了Open vSwitch和Docker。请没有安装好的读者可以根据INSTALL.md和www.docker.com的说明来进行安装。Docker 1.9.0开始支持多主机网络(multi-host networking)。我们可以通过OVN(Open vSwitch virtual network)来将Docker的网络和Open vSwitch结合起来。

　　简介

　　对于OVN和Docker的多主机网络(multi-host networking)，Docker需要分布式键值对存储的支持。假设我们这里采用consul来提供分布式键值对存储，并且你的主机IP地址为$HOST_IP。用户可以使用下面的命令来启动Docker进程：

　　docker daemon --cluster-store=consul://127.0.0.1:8500 \

　　--cluster-advertise=$HOST_IP:0

　　OVN为容器提供了网络虚拟化技术。OVN和Docker的结合使用存在两种模式：underlay模式和overlay模式。

　　在underlay模式下，OVN要求配置OpenStack来提供容器网络。在这个模式下，用户可以创建逻辑网络，且让运行在虚拟机中的容器、独立的虚拟机(没有容器运行在其中)和物理机器连接到同一个逻辑网络上。这是一种多租户、多主机的解决办法。

　　在overlay模式下，OVN可以为运行跨主机的容器们提供一个逻辑网络。这是一种单租户(是不是能扩展到多租户取决于安全特性)、多主机的解决办法。在这种模式下，你并不需预创建好的OpenStack。

　　值得注意的是，用户必须在他想要运行容器的虚拟机或者主机上安装并运行Open vSwitch。

　　Overlay 模式

　　Overlay模式下，需要Open vSwitch 2.5版本或后续版本的支持。

　　1、启动核心模块

　　OVN架构中会有一个核心的模块来存储网络信息。因此你需在你其中一台主机(IP地址为$CENTRAL_IP，并且已经安装和启动了Open vSwitch)上启动相关的核心服务。

　　首先我们让ovsdb-server监听一个TCP端口：

　　ovs-appctl -t ovsdb-server ovsdb-server/add-remote ptcp:6640

　　接下来，启动ovn-northd后台进程。这个进程负责将来自Docker的网络信息(存储在OVN_Northbound 数据库中)转换成逻辑流存储于OVN_Southbound数据库。

　　/usr/share/openvswitch/scripts/ovn-ctl start_northd

　　2、一次性配置

　　在每一个你打算创建容器的主机(如阿里云主机)上，你需运行以下的命令(如果你的OVS数据库被清空，你需要再次运行这个命令。除此之外，重复运行这个命令都是没有任何影响的)。

　　其他的主机可通过$LOCAL_IP地址来访问到这个主机，它就相当于本地通道的端点。

　　$ENCAP_TYPE是指用户想使用的通道的类型。它可以是”geneve“或者”stt“。(注意，你的内核需要支持以上两个类型，用户可通过运行以下命令来检测内核是不是支持以上类型："llsmod | grep $ENCAP_TYPE")。

　　ovs-vsctl set Open_vSwitch . external_ids:ovn-remote="tcp:$CENTRAL_IP:6640"

　　external_ids:ovn-encap-ip=$LOCAL_IP external_ids:ovn-encap-type="$ENCAP_TYPE"

　　最后，启动ovn-controller(你需要在每一次启动时运行以下命令)：

　　/usr/share/openvswitch/scripts/ovn-ctl start_controller

　　3、启动Open vSwitch网络驱动

　　在默认情况下，Docker使用Linux网桥，但是它支持外扩展。为了替换Linux网桥，我们需先启动Open vSwitch驱动。

　　Open vSwitch驱动使用了Python Flask模块来监听Docker的网络API请求。因此，用户需要先安装Python 的Flask模块。

　　easy_install -U pip

　　pip install Flask

　　在每一个你想要创建容器的主机上启动Open vSwitch驱动：

　　ovn-docker-overlay-driver --detach

　　Docker内部包含了一些模块，这些模块拥有类似于OVN的逻辑交换机和逻辑端口的概念。请读者仔细阅读Docker的文档来查找相关的命令。这里我们给出了一些案例：

　　1)创建用户自己的逻辑交换机

　　下面的命令创建了一个名为”foo“的逻辑交换机，它的网段为”192.168.1.0/24”：

　　NID=`docker network create -d openvswitch --subnet=192.168.1.0/24 foo`

　　2)显示已有逻辑交换机

　　docker network ls

　　你也可通过以下命令从OVN的northbound数据库中查找到这个逻辑交换机：

　　ovn-nbctl --db=tcp:$CENTRAL_IP:6640 lswitch-list

　　3)Docker创建逻辑端口，并且将这个端口附加到逻辑网络上

　　比如说，将一个逻辑端口添加到容器busybox的“foo”网络上：

　　docker run -itd --net=foo --name=busybox busybox

　　4)显示所有的逻辑端口

　　Docker现在并没有一个CLI命令来罗列所有的逻辑端口，但你可从OVN的数据库中找到它们：

　　ovn-nbctl --db=tcp:$CENTRAL_IP:6640 lport-list $NID

　　5)用户也可创建一个逻辑端口，并将它添加到一个运行中的容器上：

　　docker network create -d openvswitch --subnet=192.168.2.0/24 bar

　　docker network connect bar busybox

　　用户可删除逻辑端口，或将它们从运行容器上分离出来：

　　docker network disconnect bar busybox

　　6)用户也可删除逻辑交换机：

　　docker network rm bar

　　Underlay模式

　　在这个模式下，OVN要求用户预安装好OpenStack。

　　1、一次性配置

　　一个OpenStack的租户创建了一个虚拟机，这个虚拟机拥有单张或多张网卡。若租户想要发送虚拟机中容器的网络包，他需获取这些网卡的port-id。Port-id可通过以下命令获得：

　　nova list

　　然后运行：

　　在虚拟机中，下载OpenStack的RC文件，这些文件包含了租户的信息(我们用openrc.sh来指代它)。编辑这个文件，并且将之neutron port-list --device_id=$id

　　前获取到的port-id以 export OS_VIF_ID=$port-id的格式加入到文件中。文件的内容如下：

　　#!/bin/bash

　　export OS_AUTH_URL=http://10.33.75.122:5000/v2.0

　　export OS_TENANT_ID=fab106b215d943c3bad519492278443d

　　export OS_TENANT_NAME="demo"

　　export OS_USERNAME="demo"

　　export OS_VIF_ID=e798c371-85f4-4f2d-ad65-d09dd1d3c1c9

　　2、创建Open vSwitch网桥

　　若用户的虚拟机只有一个以太网接口(比如说eth0)，你需将这个设备作为一个端口加入到Open vSwitch的”breth0”网桥上，并且移除它的IP地址，将其他相关的信息转移到这个网桥上。(若有多个网路接口，用户自己创建Open vSwitch网桥，并且添加接口到网桥上)若你使用DHCP来获取IP地址，你需要关闭监听eth0的DHCP客户端，并且开启一个监听Open vSwitch breth0网桥的DHCP客户端。

　　你可让以上的步骤持久化，比如说你的虚拟机是Debian/Ubuntu，你可以参考 openvswitch-switch.README.Debian，若你的虚拟机基于RHEL，你可阅读 README.RHEL完成持久化。

　　3、开启Open vSwitch网络驱动

　　Open vSwitch驱动使用了Python Flask模块来监听Docker的网络API调用。这个驱动还使用了OpenStack的python-neutronclient库。因此，如果你的主机还没有安装Python Flask或python-neutronclient，你需使用以下命令来安装：

　　easy_install -U pip

　　pip install python-neutronclient

　　pip install Flask

　　运行openrc文件：

　　../openrc.sh

　　开启网络驱动，并且提供OpenStack租户的密码：

　　ovn-docker-underlay-driver --bridge breth0 --detach

　　从现在开始，你可以使用和overlay模式类似的Docker命令了。请阅读“man ovn-architecture”来理解OVN的技术细节。