csit/README.md

   1 ## Continuous System and Integration Testing (CSIT) for CPS
   2
   3 The directory structure:
   4
   5 - **plans/** contains testing plans, each sub-folder represents a separate test plan, contains processed subsequently:
   6     _startup.sh_ (serves docker containers startup), _testplan.txt_ (lists test-suits), _teardown.sh_ (serves docker containers stopping and images removal)
   7 - **scripts/** contains shell scripts used on tests executions
   8 - **tests/** contains test suits which are processed by folder name (relative to _tests_ folder) taken from _testplan.txt_
   9
  10 Test suits are executed using Robots framework.
  11
  12 ### Running on local environment
  13
  14 Prerequisites:
  15 - docker
  16 - python + pip
  17 - virtualenv
  18
  19 ```bash
  20 sudo apt install python3 python3-pip virtualenv
  21 ```
  22
  23 Add an alias in the ```.bashrc``` file for pip3 to be pip at the end of the file. </br>
  24 This file will be present on the home directory of the Ubuntu system.
  25 ```bash
  26 alias pip=pip3
  27 ```
  28
  29 Now load the ```.bashrc``` file.
  30 ```bash
  31 . .bashrc
  32 ```
  33
  34 The Robot framework and required python packages will be installed on first execution.
  35
  36 Navigate to cps project directory
  37 ```bash
  38 cd ~/<your_git_repo>/cps
  39 ```
  40
  41 Build a docker image (see also [docker-compose readme](../docker-compose/README.md) ) from your cps directory:
  42
  43 ```bash
  44 mvn clean install -Dmaven.test.skip=true -Ddocker.repository.push=
  45 ```
  46
  47 Execute test from current cps folder:
  48 ```bash
  49 ./csit/run-project-csit.sh
  50 ```
  51