Skip to content

Latest commit

 

History

History
50 lines (35 loc) · 1.82 KB

README.md

File metadata and controls

50 lines (35 loc) · 1.82 KB

rudder-tests

Automatic tests repository

Installation

See doc/INSTALL.md for setup

Synopsis

Run the desired test platform:

  • ./rtf platform setup debian

Run a test scenario:

  • ./rtf scenario run debian base

Get the long help:

  • ./rtf --help

Use cases

Every parameter after the platform name in "./rtf platform setup" is an additional parameter to the platform, ie it a key=value that is identical to the ones available in the platform.json file. Examples of such parameters:

  • rudder-version=ci/6.0 (this one can be abbreviated to "6.0")
  • live=true : do not use buffers for output (this make the output more reactive, but produces more fake lines because of progress bars)
  • plugins=all : install all available plugins (you can specify a space separated list of plugins instead)
  • plugins_version=nightly : by default release versions of plugins are installed (ci and ci/nightly are also available)
  • forget_credential=true : to avoid keeping your download credentials on the vm (useful if you are going to export the platform)
  • provider=aws : to instantiate the platform on aws see doc/PROVIDERS.md for more details

Global parameters can be put directly in the Vagrantfile. Examples of such parameters:

  • $NETWORK (default 192.168.40.0/24) : the first network to use for the first platform, next platform will use next available network
  • $SKIP_IP : number of IP to avoid using in this network (because they are used for the gateway for example)
  • $DOWNLOAD_USER and $DOWNLOAD_PASSWORD : credential to download licences and private plugins

Run a platform on AWS (see doc/PROVIDERS.md for details) :

  • you must have the vagrant-aws plugin installed
  • the $AWS... global parameters must be filled
  • use provider=aws in the platform description
  • that's all

See doc/TESTS.md to add new tests ans scenarios