X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Ftesting_in_vagrant.rst;h=3612ba1e660353dc58e70383e9dceb47d1b4d4cd;hp=b509e3d45291dc358a5a0eb53a6cb2ad833d658e;hb=HEAD;hpb=c6103c8482d1acbc0d1c3bc71ad0de8903b73a3c diff --git a/docs/testing_in_vagrant.rst b/docs/testing_in_vagrant.rst deleted file mode 100644 index b509e3d452..0000000000 --- a/docs/testing_in_vagrant.rst +++ /dev/null @@ -1,88 +0,0 @@ -Running CSIT locally in Vagrant -------------------------------- - -Install prerequisites -===================== - -Run all commands from command line. - -1. Download and install virtualbox from `official page - `_. - To verify the installation, run VBoxManage: - - - on windows:: - - "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version - - - on nix:: - - VBoxManage --version - - Tested version: 6.1.16r140961 - -2. Download and install latest vagrant `from official page - `_. - To verify the installtion, run:: - - vagrant -v - - Tested version: Vagrant 2.2.15 - -3. Install vagrant plugins:: - - vagrant plugin install vagrant-vbguest - vagrant plugin install vagrant-cachier - - If you are behind a proxy, install proxyconf plugin and update proxy - settings in Vagrantfile:: - - vagrant plugin install vagrant-proxyconf - -Set up and run Vagrant virtualbox -====================================== - -Before running following commands change working directory to Vagrant specific directory -(from within root CSIT directory) :: - - cd csit.infra.vagrant - -This allows Vagrant to automatically find Vagrantfile and corresponding Vagrant environment. - -Start the provisioning:: - - vagrant up --provider virtualbox - -Your new VPP Device virtualbox machine will be created and configured. -Master branch of csit project will be cloned inside virtual machine into - - /home/vagrant/csit folder. - -Once the process is finished, you can login to the box using:: - - vagrant ssh - -In case you need to completely rebuild the box and start from scratch, -run these commands:: - - vagrant destroy -f - vagrant up --provider virtualbox - - -Run tests -============================== - -From within the box run the tests using:: - - cd /home/vagrant/csit/resources/libraries/bash/entry - ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox - -To run only selected tests based on TAGS, export environment variables before -running the test suite:: - - export GERRIT_EVENT_TYPE="comment-added" - export GERRIT_EVENT_COMMENT_TEXT="devicetest memif" - - # now it will run tests, selected based on tags - ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox - -