limbus-ci is a simple CI solution for testing applications that need to support a lot of platforms.

By running bare-bones installations of different operating systems limbus-ci can test applications on a wide array of different configurations that the end-user might use.

limbus-ci provisions virtual machines using Vagrant and VirtualBox.

• Installation
• Usage
• Development
• Roadmap
• Copyright

To be able to provision virtual machines you will need Vagrant and VirtualBox installed.

You can install the CLI application through NPM:

npm install -g limbus-ci

Another way to get a hold of limbus-ci is to clone it from the git repository:

git clone https://github.com/redien/limbus-ci.git
cd limbus-ci
npm install
npm link

You can also get the library by manually downloading and extracting the ZIP file at: https://github.com/redien/limbus-ci/archive/master.zip

And then install using:

npm install
npm link

To run a job with a specific VM image use:

limbus-ci run job <image> <script>

limbus-ci creates a folder named .limbusci in the folder it is run. It uses it to store runtime specific things. You should not commit this folder into your revision control so it is useful to exclude it.

For example when using git, add the following line to your .gitignore:

/.limbusci/

For development you need some extra dependencies. Install them using NPM with:

npm install

limbus-ci performs acceptance testing using Cucumber.js.

Run tests using:

npm test

limbus-ci - A simple CI solution for testing extremely portable applications.

Written in 2016 by Jesper Oskarsson [email protected]

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see http://creativecommons.org/publicdomain/zero/1.0/.