halmhatt / ci-server

A simple CI server that runs tests on your repo

ci-server

A simple CI server that runs tests on your repo. Aims to be very extendable and configurable.

Currently a very early project but the goal is to have:

• Webhook for CI builds from e.g. Github or Bitbucket
• Docker containers that the tests run in. Instead of checking out into a subdir a docker container will be started that runs all tests. This will keep the code isolated and sandboxed. (opt in, checkin to subdir should still be possible)
• Fetch script that fetches repo and checks for any updates. Runs a new build for each new commit (opt in)
• Work with Github Pull requests (opt in)
• Push status of builds to Slack (opt in)
• Simple web frontend with Node where it is possible to see output from user-script.sh (opt in, run server and provide domain name, open ports etc to make it public)

Usage

1. Configure

Add a new file user.cfg at the root of this project, it will overwrite the defaults. Add your repo url as repo_url in this file. (you can check the defaults.cfg for all available options)

// user.cfg
repo_url="https://github.com/halmhatt/ci-server.git"

If the server that you run this on is able to checkout with ssh then you could also use a ssh url.

2. User script

There is a file called user-script.sample.sh, rename this file to user-script.sh. This will be run in the repo after checkout. Add anything you want into this file and make it return a none zero exit code if tests fail.

This file looks something like this as default

npm install
npm test

This will install all npm dependencies and then run the tests. But you could do anything, bower install, make test, pip install...

3. Run

Execute the file run.sh

$ ./run.sh

This should create a build directory build/0001 and checkout your code to build/0001/repo.

ci-server's Issues

Check code with shellcheck

https://github.com/koalaman/shellcheck

Code should follow style guide

https://github.com/bahamas10/bash-style-guide