From 08f78ace59ac6bd41c2787a62ed4e4f09fa4ca51 Mon Sep 17 00:00:00 2001 From: Robert Collins Date: Thu, 5 Sep 2013 14:30:36 +1200 Subject: [PATCH] Improve Zuul docs. The list of pipelines (duplicated with the layout.yaml) was incomplete. No node size was described, and the need (or lack thereof) for backups wasn't covered. Change-Id: Ia20b610e7c51184239910d6b6e902390593fcaff --- doc/source/zuul.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/source/zuul.rst b/doc/source/zuul.rst index d6d5114465..e4ad54bc4a 100644 --- a/doc/source/zuul.rst +++ b/doc/source/zuul.rst @@ -56,6 +56,13 @@ The OpenStack project uses a number of pipelines in Zuul: **silent** This pipeline is used for silently testing new jobs. +**experimental** + This pipeline is used for on-demand testing of new jobs. + +**periodic** + This pipeline has jobs triggered on a timer for e.g. testing for + environmental changes daily. + Zuul watches events in Gerrit (using the Gerrit "stream-events" command) and matches those events to the pipelines above. If a match is found, it adds the change to the pipeline and starts running @@ -78,3 +85,17 @@ submitting the change to Gerrit for review. For the full syntax of Zuul's configuration file format, see the `Zuul reference manual`_. + +Sysadmin +======== + +Zuul and gear are lightweight - it should be possible to run both on a +1G instance for small deployments. OpenStack's deployment requires at +least a 2G instance at the time of writing. + +Zuul is stateless, so the server does not need backing up. However +zuul talks through git and ssh so you will need to manually check ssh +host keys as the zuul user. e.g.:: + + sudo su - zuul + ssh -p 29418 review.openstack.org