Simple CI

The simplest pseudo-Continuous Integration tool I could conceive

This does not have a web UI This does not have error reporting This does not require docker

This is just a script which is intended to be run by cron, or some other mechanism, and it will just check a git repository, update if there's a change, and then run a command within this directory.

This can be a deployment command (making this a CD, not CI) or it can be kicking off a test suite, or it can be whatever you want.

The reason

I have a small VPS, I wanted it to deploy a static site when I pushed a change to a live branch. I could have used a post-receive hook on the server, but the repository is currently within a docker container, something I intend to change at some point. I am sure I could change it, but I just wanted a solution. I couldn't find anything that just did the bare minimum I wanted without bells and whistles, so I wrote one.

Configuration

Within simpleci.sh there are two variables: * JOB_DIR - sets the location for jobs * WORKSPACE_DIR - sets the location that simpleci will use for local copies

These default to being 'jobs' and 'workspaces' within the simpleci directory, but can be changed.

Jobs

Jobs are names of projects which can be run. These are stored within JOB_DIR. These are a simple file with up to three pieces of information: * REPO - the repository to monitor * BRANCH - the branch to monitor [live] * COMMAND - the command to run within the directory [make publish]

Running

It is possible to run simpleci manually /path/to/simpleci.sh - this will check for any updates in any of the jobs, and run them where required /path/to/simpleci.sh JOB1 [JOB1 [JOB3 ..]]. - this will force-run specific jobs, regardless if there is an update or not.

The job names are the filenames within JOB_DIR. eg /path/to/simpleci.sh example

It is also possible to add to cron to run it periodically. eg */30 * * * * /path/to/simpleci.sh >> /path/to/simpleci.log 2>&1