top
(README.md)
# builder

Very simple CI

## Features
  * Auto builds new pushes and pull requests to Github
  * Run builds with Github hook
  * Display a list of builds
  * Clicking on a build displays the build output, with full colour

## Usage

[Get a Github Auth Token](https://help.github.com/articles/creating-an-access-token-for-command-line-use)

Set the following environment variables:

		GITHUB_CLIENT_ID=
		GITHUB_CLIENT_SECRET=
		HOST=
		PORT=

Host will be the static IP or hostname of the server that builder is running on.

Repositories is a list of repositories you want watched.

Launch builder:

    go build
    ./builder

Add a ``Builderfile`` to your projects that you want to build.
A typical Builderfile looks something like this:

    #!/bin/bash

    make test # or some other sort of test runner thingy

Go to host:port to view a list of builds

## Hooks

NOTE: HOOKS ARE TEMPORARILY DEPRECATED

Hooks get executed whenever a build completes. To add a new hook just save a script in ```data/hooks```.

These are the available environment variables:

      $BUILDER_BUILD_RESULT # pass, fail or incomplete
      $BUILDER_BUILD_URL    # the build url
      $BUILDER_BUILD_ID     # unique build ID
      $BUILDER_BUILD_OWNER  # username of commit owner
      $BUILDER_BUILD_REPO   # repository name
      $BUILDER_BUILD_REF    # branch name
      $BUILDER_BUILD_SHA    # commit SHA

Imports 6 package(s) ΒΆ

  1. github.com/kr/pty
  2. github.com/eaigner/jet
  3. github.com/hoisie/mustache
  4. github.com/drone/routes
  5. github.com/lib/pq
  6. github.com/bitly/go-simplejson