csit/README.md

   1 ## Continuous System and Integration Testing (CSIT) for DCAEGEN2 PM-Mapper
   2
   3 The directory structure:
   4
   5 - **plans/** contains testing plans, each sub-folder represents a separate test plan with contents processed subsequently:
   6     _startup.sh_ (serves docker containers startup), _testplan.txt_ (lists test suites), _teardown.sh_ (serves docker containers stopping and images removal)
   7 - **scripts/** contains shell scripts used on tests executions
   8 - **tests/** contains test suites that are processed by folder name (relative to _tests_ folder) taken from _testplan.txt_
   9
  10 Test suites are executed using Robot framework.
  11
  12 ### Running on local environment
  13
  14 Prerequisites:
  15 - maven
  16 - docker
  17 - docker-compose
  18 - settings.xml corresponding to the one under oparent repository
  19
  20 ```bash
  21
  22 Navigate to project directory
  23 ```bash
  24 cd ~/<your_git_repo>/pm-mapper
  25 ```
  26
  27 Build a docker image from your pm-mapper directory:
  28
  29 ```bash
  30 mvn clean install docker:build
  31 ```
  32
  33 Execute tests from pm-mapper/csit folder:
  34 ```bash
  35 cd csit
  36 ./run-project-csit.sh
  37 ```
  38
  39 To run any individual suite, use run-csit.sh with appropriate plans subdirectory, for example:
  40
  41 ```bash
  42 ./run-csit.sh plans/pmmapper
  43 ```
  44