0. download the 64-bit linux binary
1. put it somewhere in $PATH, e.g. /usr/local/bin/travis-worker

Use the ./bin/travis-worker-install script, or take a look at the packagecloud instructions.

0. clone this down
1. install Go and gvt.
2. make

Travis Worker is configured with environment variables or command line flags via the codegangsta/cli library. A list of the non-dynamic flags and environment variables may be found by invoking the built-in help system:

travis-worker --help

Each provider requires its own configuration, which must be provided via environment variables namespaced by TRAVIS_WORKER_{PROVIDER}_, e.g. for the docker provider:

export TRAVIS_WORKER_DOCKER_ENDPOINT="tcp://localhost:4243"
export TRAVIS_WORKER_DOCKER_PRIVILEGED="false"
export TRAVIS_WORKER_DOCKER_CERT_PATH="/etc/secret-docker-cert-stuff"

To inspect the parsed configuration in a format that can be used as a base environment variable configuration, use the --echo-config flag, which will exit immediately after writing to stdout:

travis-worker --echo-config

0. make
1. ${GOPATH%%:*}/bin/travis-worker

C-c will stop the worker. Note that any VMs for builds that were still running will have to be cleaned up manually.

Travis Worker has two shutdown modes: Graceful and immediate. The graceful shutdown will tell the worker to not start any additional jobs, but finish the jobs it is currently running before it shuts down. The immediate shutdown will make the worker stop the jobs it's working on and requeue them, and clean up any open resources (shut down VMs, cleanly close connections, etc.)

To start a graceful shutdown, send an INT signal to the worker (for example using kill -INT). To start an immediate shutdown, send a TERM signal to the worker (for example using kill -TERM).

Travis Worker is built via the standard go commands (with GO15VENDOREXPERIMENT=1), and dependencies managed by gvt.

To work with the dependencies you need to do the following first

• Have this repository checked out
• Install gvt with github.com/FiloSottile/gvt

To update and existing vendored dependency, do the following in this directory:

• gvt update name/of/dependency e.g. gvt update github.com/pkg/sftp

To add a new dependency, do the following:

• gvt fetch name/of/package e.g. gvt fetch github.com/pkg/sftp

The parts of the release process that haven't yet been automated look like this:

• review the diff since last release for silliness
• decide what the version bump should be
• update ./CHANGELOG.md (in a release prep branch)
• tag accordingly after merge
• update github release tag with relevant section from ./CHANGELOG.md
• attach binaries to github release tag

See LICENSE file.

© 2014-2015 Travis CI GmbH