openstack/kuryr-kubernetes
Code Issues Proposed changes
8b76509514
kuryr-kubernetes/contrib/vagrant
History
Antoni Segura Puimedon e1580c5310 Vagrant: Document the increased Octavia reqs 
The default vagrant values are insufficient for running Octavia
amphorae. This patch addresses it in documentation.

Change-Id: If0147adb39793b4601f7b00bec34aa9d593ecbc4
Closes-Bug: 1708173
Signed-off-by: Antoni Segura Puimedon <antonisp@celebdor.com>
2018-04-10 14:01:02 +00:00
..
config Removing detected Keystone Port in vagrant kury_rc 2017-06-19 05:03:40 +00:00
devstack.sh Adding vagrant configs to kuryr-kubernetes 2017-03-15 09:37:59 -07:00
README.md Vagrant: Document the increased Octavia reqs 2018-04-10 14:01:02 +00:00
vagrant.sh update rc files 2017-03-22 08:12:56 +08:00
Vagrantfile Fix vagrant ssh issue for virtualbox bento 2017-04-04 16:21:35 -04:00

README.md

vagrant-devstack-Kuryr-Kubernetes

Getting started

A Vagrant based kuryr,neutron,keystone,docker and kubernetes system.

Steps to try vagrant image:

  1. Install Vagrant on your local machine. Install one of the current providers supported: VirtualBox, Libvirt or Vagrant
  2. Git clone kuryr-kubernetes repository.
  3. Run cd kuryr-kubernetes/contrib/vagrant
  4. Run vagrant up It will take from 10 to 60 minutes, depending on your internet speed. Vagrant-cachier can speed up the process [2].
  5. vagrant ssh

At this point you should have experimental kubernetes (etcdv3, k8s-apiserver, k8s-controller-manager, k8s-scheduler, kubelet and kuryr-controller), docker, kuryr, neutron, keystone all up, running and pointing to each other. Pods and services orchestrated by kubernetes will be backed by kuryr+neutron. The architecture of the setup can be seen at [1].

References: [1] https://docs.openstack.org/developer/kuryr-kubernetes/devref/kuryr_kubernetes_design.html [2] http://fgrehm.viewdocs.io/vagrant-cachier/

Vagrant Options available

You can set the following environment variables before running vagrant up to modify the definition of the Virtual Machine spawned:

  • VAGRANT_KURYR_VM_BOX: To change the Vagrant Box used. Should be available in atlas.

    export VAGRANT_KURYR_VM_BOX=centos/7

    Could be an example of a rpm-based option.

  • VAGRANT_KURYR_VM_MEMORY: To modify the RAM of the VM. Defaulted to: 4096 If you configure your local.conf to use Octavia, you should increase the setting to at least 12288.

  • VAGRANT_KURYR_VM_CPU: To modify the cpus of the VM. Defaulted to: 2. If you configure your local.conf to use Octavia, you should increate this setting to at least 4.

  • VAGRANT_KURYR_RUN_DEVSTACK: Whether vagrant up should run devstack to have an environment ready to use. Set it to 'false' if you want to edit local.conf before run ./stack.sh manually in the VM. Defaulted to: true. See below for additional options for editing local.conf.

Additional devstack configuration

To add additional configuration to local.conf before the VM is provisioned, you can create a file called "user_local.conf" in the contrib/vagrant directory of networking-kuryr. This file will be appended to the "local.conf" created during the Vagrant provisioning.

For example, to use OVN as the Neutron plugin with Kuryr, you can create a "user_local.conf" with the following configuration:

enable_plugin networking-ovn https://git.openstack.org/openstack/networking-ovn
enable_service ovn-northd
enable_service ovn-controller
disable_service q-agt
disable_service q-l3
disable_service q-dhcp