Files
kuryr-kubernetes/doc/source/installation/devstack/nested-macvlan.rst
Luis Tomas Bolivar d47fa2e498 Add DevStack base installation section
Change-Id: Idcc4c70e9b897b2f319b50b555297ae10c6afb39
2017-08-24 11:32:05 +02:00

43 lines
1.4 KiB
ReStructuredText

How to try out nested-pods locally (MACVLAN)
============================================
Following are the instructions for an all-in-one setup, using the
nested MACVLAN driver rather than VLAN and trunk ports.
1. To install OpenStack services run devstack with ``devstack/local.conf.pod-in-vm.undercloud.sample``.
2. Launch a Nova VM with MACVLAN support
.. todo::
Add a list of neutron commands, required to launch a such a VM
3. Log into the VM and set up Kubernetes along with Kuryr using devstack:
- Since undercloud Neutron will be used by pods, Neutron services should be
disabled in localrc.
- Run devstack with ``devstack/local.conf.pod-in-vm.overcloud.sample``.
Fill in the needed information, such as the subnet pool id to use or the
router.
4. Once devstack is done and all services are up inside VM. Next steps are to
configure the missing information at ``/etc/kuryr/kuryr.conf``:
- Configure worker VMs subnet::
[pod_vif_nested]
worker_nodes_subnet = <UNDERCLOUD_SUBNET_WORKER_NODES_UUID>
- Configure "pod_vif_driver" as "nested-macvlan"::
[kubernetes]
pod_vif_driver = nested-macvlan
- Configure binding section::
[binding]
link_iface = <VM interface name eg. eth0>
- Restart kuryr-k8s-controller::
sudo systemctl restart devstack@kuryr-kubernetes.service
Now launch pods using kubectl, Undercloud Neutron will serve the networking.