aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/introduction/testing_in_vagrant.md
diff options
context:
space:
mode:
authorpmikus <peter.mikus@protonmail.ch>2023-03-09 13:32:33 +0000
committerPeter Mikus <peter.mikus@protonmail.ch>2023-03-15 10:06:55 +0000
commitb928e56347c682fdb9762ccbe2f368329d4037e4 (patch)
tree9c0f6a02efc1704821229b8e18a23468fdf8674a /docs/content/introduction/testing_in_vagrant.md
parentddcdf45806d0efa9e89dd4446b4c7da39cfb27a8 (diff)
feat(docs): Hugo
Signed-off-by: pmikus <peter.mikus@protonmail.ch> Change-Id: Id8b43ef1f31f39b19a0629c52581514fda278f3b
Diffstat (limited to 'docs/content/introduction/testing_in_vagrant.md')
-rw-r--r--docs/content/introduction/testing_in_vagrant.md85
1 files changed, 85 insertions, 0 deletions
diff --git a/docs/content/introduction/testing_in_vagrant.md b/docs/content/introduction/testing_in_vagrant.md
new file mode 100644
index 0000000000..ef1e231393
--- /dev/null
+++ b/docs/content/introduction/testing_in_vagrant.md
@@ -0,0 +1,85 @@
+---
+bookHidden: true
+title: "Running CSIT locally in Vagrant"
+---
+
+# Running CSIT locally in Vagrant
+
+## Install prerequisites
+
+Run all commands from command line.
+
+1. Download and install virtualbox from
+ [official page](https://www.virtualbox.org/wiki/Downloads).
+ 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](https://www.vagrantup.com/downloads.html).
+ 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
+
+