Skip to content
This repository has been archived by the owner on Feb 7, 2020. It is now read-only.

How to initiate a build on Kochiku

barlow edited this page Sep 3, 2013 · 2 revisions

In addition to performing manual Kochiku builds, you can configure Kochiku to perform automatic builds in response to certain events.

Automatic builds

To configure automatic builds, you need to add a web hook to your Git server.

If you're using Github, see the instructions for Adding a Webhook. Configure the webhook to post to http://YOUR-KOCHIKU-HOST/pull-request-builder.

Build on push to master

If you enable the Build on push option in the settings for a repository, Kochiku starts a build whenever commits are pushed to the repository's master branch.

Build on pull request

If you enable the Build pull requests option in the settings for a repository, Kochiku starts a build whenever a pull request is created or a branch with an open pull request is updated.

Manual builds

Run the kochiku-build script

You can run the kochiku-build shell script to start a build. Copy kochiku-build.sh.sample to somewhere on your path and edit it to use the hostname of your kochiku server. To start a build, run kochiku-build from any repository on your computer that has been added to Kochiku.

Starting a build with this script creates a "developer" project in Kochiku. These projects are prefixed with the hostname of the computer initiating the build. This separates developer builds from the CI builds of the repository's master branch.

Start a build with the Kochiku web UI

Each Kochiku project page has a Build button in the upper-right corner.

  • From the main project page for a repository, click Build to build the master branch.
  • From any developer project page for a repository, first provide a git revision number in the textbox next to the Build button, then click Build to build that revision.