Kuryr共享配置和工具
项目描述
团队和存储库标签
kuryr
OpenStack Neutron的Docker
Kuryr是一个使用Neutron为Docker容器提供网络服务的Docker网络插件。它为常见的Neutron插件提供容器化镜像。
自由软件：Apache许可证
功能
TODO
获取代码
$ git clone https://opendev.org/openstack/kuryr.git $ cd kuryr
先决条件
$ sudo pip install -r requirements.txt
安装Kuryr的libnetwork驱动程序
关于kuryr-libnetwork驱动程序的安装，请参阅
https://docs.openstack.org/kuryr-lib-network/latest/readme.html
配置Kuryr
运行以下命令生成示例配置， etc/kuryr.conf.sample
$ tox -e genconfig
重命名并复制到所需路径的配置文件
$ cp etc/kuryr.conf.sample /etc/kuryr/kuryr.conf
在 /etc/kuryr/kuryr.conf 中编辑 Keystone 部分，替换 ADMIN_PASSWORD
auth_type = v3password auth_url = http://127.0.0.1:5000 region_name = regionOne user_doamin_name = Default username = admin project_domain_name = Default project_name = service password = ADMIN_PASSWORD
在同一个文件中取消注释 bindir 参数，指定 Kuryr vif 绑定脚本的路径
bindir = /usr/local/libexec/kuryr
默认情况下，Kuryr 会使用 veth 对进行绑定。然而，Kuryr 库还包含两个其他驱动程序，您可以在 绑定 部分中进行配置
[binding] #driver = kuryr.lib.binding.drivers.ipvlan #driver = kuryr.lib.binding.drivers.macvlan
驱动程序可以使用其他 绑定 选项。上一段中的两个 Kuryr 库驱动程序可以通过设置虚拟设备的作用链接接口进一步配置
link_iface = enp4s0
运行 Kuryr
目前，Kuryr 使用 bash 脚本来启动服务。在执行以下命令之前，请确保已安装 tox。
$ sudo ./scripts/run_kuryr.sh
启动后，请重新启动您的 Docker 服务，例如：
$ sudo service docker restart
bash 脚本会创建以下文件（如果不存在）。
/usr/lib/docker/plugins/kuryr/kuryr.json：libnetwork 的 Json 规范文件。
请注意，运行需要使用 pyroute2 创建和删除 veth 对的 root 权限。
测试 Kuryr
为了快速检查 Kuryr 是否正常工作，请创建一个网络
$ docker network create --driver kuryr test_net 785f8c1b5ae480c4ebcb54c1c48ab875754e4680d915b270279e4f6a1aa52283 $ docker network ls NETWORK ID NAME DRIVER 785f8c1b5ae4 test_net kuryr
使用 tox 进行测试
$ tox
您也可以使用 -e 标志运行特定的测试用例，例如，仅运行 fullstack 测试用例。
$ tox -e fullstack
生成文档
我们使用 Sphinx 维护文档。您可以使用 pip 安装 Sphinx。
$ pip install -U Sphinx
除了 Sphinx 之外，您还需要以下要求（不包括在 requirements.txt 中）
$ pip install openstackdocstheme reno 'reno[sphinx]'
文档的源代码位于 doc 目录下，您可以使用以下命令生成 html 文件。如果生成成功，将在 doc 目录下创建一个 build/html 目录。
$ cd doc $ make html
现在您可以将文档作为简单的网站在 http://localhost:8080 上提供服务。
$ cd build/html $ python -m SimpleHTTPServer 8080
下载文件
下载适合您平台的文件。如果您不确定选择哪个，请了解有关 安装软件包 的更多信息。