From 7cbd8a55a1ab14715ba9c99d5189d260506a94ba Mon Sep 17 00:00:00 2001 From: Michal Rostecki Date: Sat, 10 Oct 2015 14:27:05 +0200 Subject: [PATCH] Update Vagrant docs Update and add some minor informations to dev Vagrant docs. Change-Id: I1acd6583b458568c5dc713e09d35e58a2275bc51 Closes-Bug: #1505065 --- doc/devenv-vagrant.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/doc/devenv-vagrant.rst b/doc/devenv-vagrant.rst index c34e5c7f5a..a2835d47f3 100644 --- a/doc/devenv-vagrant.rst +++ b/doc/devenv-vagrant.rst @@ -48,10 +48,13 @@ Next install the hostmanager plugin so all hosts are recorded in /etc/hosts Vagrant supports a wide range of virtualization technologies. This documentation describes libvirt. To install vagrant-libvirt plugin:: - vagrant plugin install vagrant-libvirt + vagrant plugin install --plugin-version ">= 0.0.31" vagrant-libvirt -Setup NFS to permit file sharing between host and VMs. Contrary to rsync -method, NFS allows both way synchronization and offers much better performances +Some Linux distributions offer vagrant-libvirt packages, but the version they +provide tends to be too old to run Kolla. A version of >= 0.0.31 is required. + +Setup NFS to permit file sharing between host and VMs. Contrary to the rsync +method, NFS allows both way synchronization and offers much better performance than VirtualBox shared folders. On Fedora 22:: sudo systemctl start nfs-server @@ -62,12 +65,12 @@ than VirtualBox shared folders. On Fedora 22:: Find a location in the system's home directory and checkout the Kolla repo:: - git clone https://github.com/openstack/kolla.git ~/dev/kolla + git clone https://github.com/openstack/kolla.git Developers can now tweak the Vagrantfile or bring up the default AIO Centos7-based environment:: - cd ~/dev/kolla/vagrant && vagrant up + cd kolla/dev/vagrant && vagrant up The command ``vagrant status`` provides a quick overview of the VMs composing the environment. @@ -100,7 +103,10 @@ Once logged on the *operator* VM call the ``kolla-build`` utility:: kolla-build -``kolla-build`` accept arguments as documented in :doc:`image-building`. +``kolla-build`` accept arguments as documented in :doc:`image-building`. It +builds Docker images and pushes them to the local registry if the *push* +option is enabled (in Vagrant this is the default behaviour). + Deploying OpenStack with Kolla