Skip to content

redien/limbus-ci

Repository files navigation

limbus-ci

version Public Domain SemVer development stage

Introduction

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.

Table of contents

Installation

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

Installing limbus-ci

You can install the CLI application through NPM:

npm install -g limbus-ci

Cloning with git

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

Download ZIP

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

Usage

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/

Development

Dependencies devDependencies

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

npm install

Test

limbus-ci performs acceptance testing using Cucumber.js.

Run tests using:

npm test

Code coverage

Coverage Status

Roadmap

Copyright

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

Written in 2016 by Jesper Oskarsson jesosk@gmail.com

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/.

About

A simple CI solution for testing extremely portable applications.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published