Files
devstack-gate/doc/tarmac.rst
Monty Taylor 33b008a965 Added initial docs for Jenkins.
Change-Id: I79046c3d87fed2c2b78ee9c5731db151c1ad1a33
2011-07-22 10:35:30 -04:00

1.3 KiB

title

Tarmac Configuration

Tarmac

Overview

Tarmac is a Patch Queue Manager written to manage and land merge requests in Launchpad. It is not integrated in to Jenkins, and therefore does not trigger Jenkins jobs to determine if a branch is good. Rather, Jenkins triggers tarmac on a periodic basis and tarmac checks the merge queue, performs its own tests on the branch, and either passes and merges the branch in question, or fails the branch, reports the error to the merge request and sets the status back to Work In Progress.

Installation

Tarmac is installed from packages in the Tarmac PPA. It currently is installed and runs only on the Jenkins master.

Install Tarmac PPA

add-apt-repository ppa:tarmac/ppa

Install Tarmac

apt-get install tarmac

Configuration

Tarmac keeps its config file in .config/tarmac/tarmac.conf in standard ini format. That config file is, in turn, stored in git://github.com/openstack/openstack-ci.git

Authentication

Tarmac authenticates to launchpad via oauth as the hudson-openstack user.

Operation

Tarmac is a command line program, which takes a subcommand and then a branch to land as arguments.

tarmac land lp:nova