docs/testing_in_vagrant.rst

   1 Running CSIT locally in Vagrant
   2 -------------------------------
   3
   4 1. Download and install latest virtualbox from `official page
   5    <https://www.virtualbox.org/wiki/Downloads>`_
   6    To verify the installation, run VBoxManage:
   7       - on windows:
   8         "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version
   9       - on nix: VBoxManage --version
  10    You should see virtualbox manager version printed, eg: 6.0.0r127566
  11
  12 2. Download and install latest vagrant `from official page
  13    <https://www.vagrantup.com/downloads.html>`_
  14    To verify the installtion, run:
  15       vagrant -v
  16    You should see vagrant version printed, eg: Vagrant 2.2.2
  17
  18 3. Install vagrant plugins
  19    From command line run:
  20       vagrant plugin install vagrant-vbguest
  21       vagrant plugin install vagrant-cachier
  22
  23    If you are behind a proxy, install proxyconf plugin and update proxy
  24    settings in Vagrantfile:
  25       vagrant plugin install vagrant-proxyconf
  26
  27 4. Start the provisioning:
  28       vagrant up --provider virtualbox
  29
  30 Your new VPP Device virtualbox machine will be created and configured.
  31 Master branch of csit project will be cloned inside virtual machine into
  32       /home/vagrant/csit folder.
  33 Once the process is finished, you can login to the box using:
  34       vagrant ssh
  35
  36 From within the box run the tests using:
  37       cd /home/vagrant/csit/resources/libraries/bash/entry
  38       ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu1804-1n-vbox
  39
  40 In case you need to completely rebuild the box and start from scratch,
  41 run these commands:
  42       vagrant destroy -f
  43       vagrant up --provider virtualbox
  44
  45 To run only selected tests based on TAGS, export environment variables before
  46 running the test suite:
  47       export GERRIT_EVENT_TYPE="comment-added"
  48       export GERRIT_EVENT_COMMENT_TEXT="devicetest memif"
  49       ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu1804-1n-vbox