scality/ci-tengine repository overview

⁠IronMan-Integration

IronMan-Integration is aiming to provide a complete solution for the end-to-end testing of IronMan projects. It is constituted of two components:

• ultron⁠
• nimrod⁠

⁠Ultron

It is a small REST service geared towards GitHub push notifications, sending build requests to circleCI. It is written in nodeJS.

⁠Configuration

ultron looks for a config.json in its root folder, containing the following fields:

{
    "username": "your_robot_github_username",
    "hubtoken": "your_robot_github_token",
    "citoken": "your_circle_ci_token",
}

⁠Install

Just go into the bot directory and do npm install as you would with any node service.

⁠Usage

npm start will do the trick. You will need to ensure that github issue comments are forwarded to ultron via a webhook in the interface of your project.

You will be able to start a new build by invoking @username (as defined in the config file) in a PR comment. You can add on separate lines every environment variable you may want to add using the following format:

ENV_VAR=whateveryouneed

⁠Nimrod

It is a python integration wrapper, meant to be used in circleCI's environment or locally. All IronMan projects are able to be tested in an end-to-end scenario thanks to this.

⁠Install

The usual python setup.py install will do the trick.

⁠Usage

nimrod-build deploys the whole setup using IronMan-Federation. nimrod does all the above by itself.

⁠Add new tests

Tests are automatically picked-up in any path of the repository, as long as they provide the mandatory master.yml describing the aggressor configuration. Adding test is then just a matter of adding this file and whatever you may need to interact with the fully deployed system.