Add documentation about master

Signed-off-by: Paul Belanger <paul.belanger@polybeacon.com>
This commit is contained in:
Paul Belanger 2013-11-12 17:27:02 -05:00
parent f4ceb7eba4
commit c3d9ca98ca
20 changed files with 3 additions and 408 deletions

3
README.rst Normal file
View File

@ -0,0 +1,3 @@
zuul-packaging
==============
Zuul-packaging is a meta repository which contains packaging files used by the OpenStack Infrastructure team. Each operating system release has a specific branch associated with its specific packaging. For example, Debian Sid packaging files would live in the debian/sid branch.

5
debian/changelog vendored
View File

@ -1,5 +0,0 @@
zuul (1.3.0-1) UNRELEASED; urgency=low
* Initial release (Closes: #705844)
-- Paul Belanger <paul.belanger@polybeacon.com> Thu, 31 Oct 2013 16:57:26 +0000

1
debian/compat vendored
View File

@ -1 +0,0 @@
8

54
debian/control vendored
View File

@ -1,54 +0,0 @@
Source: zuul
Maintainer: Paul Belanger <paul.belanger@polybeacon.com>
Section: python
Priority: optional
Build-Depends: debhelper (>= 8.0.0),
openstack-pkg-tools,
python (>= 2.6)
Build-Depends-Indep:
python-extras,
python-git (>= 0.3.2~RC1),
python-jenkins,
python-lockfile,
python-nose,
python-paramiko,
python-paste,
python-setuptools,
python-sphinx (>= 1.0.7+dfsg),
python-statsd,
python-voluptuous (<< 0.7),
python-webob,
python-yaml
Standards-Version: 3.9.3
X-Python-Version: >= 2.6
Homepage: https://launchpad.net/zuul
Vcs-Git: git://github.com/pabelanger/zuul-deb.git
Vcs-Browser: https://github.com/pabelanger/zuul-deb
Package: zuul
Architecture: all
Depends: adduser,
libjs-jquery,
libjs-underscore,
python-daemon,
python-extras,
python-git (>= 0.3.2~RC1),
python-jenkins,
python-lockfile,
python-paramiko,
python-paste,
python-voluptuous (<< 0.7),
python-webob,
python-yaml,
${misc:Depends},
${python:Depends}
Suggests:
jenkins (>= 1.426),
python-statsd
Description: Trunk gating system
Zuul is a program that is used to gate the source code repository of a project
so that changes are only merged if they pass tests.
.
The main component of Zuul is the scheduler. It receives events related to
proposed changes (currently from Gerrit), triggers tests based on those events
(currently on Jenkins), and reports back.

32
debian/copyright vendored
View File

@ -1,32 +0,0 @@
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: Zuul
Upstream-Contact: OpenStack Continuous Integration Administrators <openstack-ci-admins@lists.launchpad.net>
Source: http://launchpad.net/zuul
Files: *
Copyright: 2011-2013, OpenStack, LLC.
2012, Hewlett-Packard Development Company, L.P.
2013, Antoine "hashar" Musso
2013, OpenStack Foundation
2013, Timo "Krinkle" Tijhof
2013, Wikimedia Foundation Inc.
License: Apache
Files: debian/*
Copyright: 2012-2013 Paul Belanger <paul.belanger@polybeacon.com>
2013 Antoine Musso <hashar@free.fr>
2013 Wikimedia Foundation Inc.
License: Apache
License: Apache
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
.
http://www.apache.org/licenses/LICENSE-2.0
.
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.

4
debian/dirs vendored
View File

@ -1,4 +0,0 @@
/etc/zuul
/var/lib/zuul
/var/lib/zuul/git
/var/log/zuul

1
debian/docs vendored
View File

@ -1 +0,0 @@
build/docs/html

4
debian/examples vendored
View File

@ -1,4 +0,0 @@
etc/layout.yaml-sample
etc/logging.conf-sample
etc/zuul.conf-sample

6
debian/gbp.conf vendored
View File

@ -1,6 +0,0 @@
[git-buildpackage]
export-dir = ../build-area/
tarball-dir = ../tarballs/
overlay = True
pristine-tar = False
compression = gzip

158
debian/init vendored
View File

@ -1,158 +0,0 @@
#! /bin/sh
### BEGIN INIT INFO
# Provides: zuul
# Required-Start: $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Zuul
# Description: Trunk gating system
### END INIT INFO
# Do NOT "set -e"
# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Zuul"
NAME=zuul
DAEMON=/usr/bin/zuul-server
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
USER=zuul
# Exit if the package is not installed
[ -x "$DAEMON" ] || exit 0
# Read configuration variable file if it is present
[ -r /etc/default/$NAME ] && . /etc/default/$NAME
# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh
# Define LSB log_* functions.
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
. /lib/lsb/init-functions
#
# Function that starts the daemon/service
#
do_start()
{
# Return
# 0 if daemon has been started
# 1 if daemon was already running
# 2 if daemon could not be started
mkdir -p /var/run/$NAME
chown $USER /var/run/$NAME
start-stop-daemon --start --quiet --pidfile $PIDFILE -c $USER --exec $DAEMON --test > /dev/null \
|| return 1
start-stop-daemon --start --quiet --pidfile $PIDFILE -c $USER --exec $DAEMON -- \
$DAEMON_ARGS \
|| return 2
# Add code here, if necessary, that waits for the process to be ready
# to handle requests from services started subsequently which depend
# on this one. As a last resort, sleep for some time.
}
#
# Function that stops the daemon/service
#
do_stop()
{
# Return
# 0 if daemon has been stopped
# 1 if daemon was already stopped
# 2 if daemon could not be stopped
# other if a failure occurred
start-stop-daemon --stop --signal 9 --pidfile $PIDFILE
RETVAL="$?"
[ "$RETVAL" = 2 ] && return 2
rm -f /var/run/$NAME/*
return "$RETVAL"
}
#
# Function that stops the daemon/service
#
do_graceful_stop()
{
PID=`cat $PIDFILE`
kill -USR1 $PID
# wait until really stopped
if [ -n "${PID:-}" ]; then
i=0
while kill -0 "${PID:-}" 2> /dev/null; do
if [ $i -eq '0' ]; then
echo -n " ... waiting "
else
echo -n "."
fi
i=$(($i+1))
sleep 1
done
fi
rm -f /var/run/$NAME/*
}
#
# Function that sends a SIGHUP to the daemon/service
#
do_reload() {
#
# If the daemon can reload its configuration without
# restarting (for example, when it is sent a SIGHUP),
# then implement that here.
#
start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name zuul-server
return 0
}
case "$1" in
start)
[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
do_start
case "$?" in
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
esac
;;
stop)
[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
do_stop
case "$?" in
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
esac
;;
status)
status_of_proc "$DAEMON" "$NAME" && exit 0 || exit $?
;;
reload|force-reload)
#
# If do_reload() is not implemented then leave this commented out
# and leave 'force-reload' as an alias for 'restart'.
#
log_daemon_msg "Reloading $DESC" "$NAME"
do_reload
log_end_msg $?
;;
restart)
#
# If the "reload" option is implemented then remove the
# 'force-reload' alias
#
log_daemon_msg "Restarting $DESC" "$NAME"
do_graceful_stop
do_start
;;
*)
#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}" >&2
exit 3
;;
esac
:

1
debian/install vendored
View File

@ -1 +0,0 @@
debian/etc/zuul/* etc/zuul/

7
debian/links vendored
View File

@ -1,7 +0,0 @@
# Overwrite jquery.js from upstream tarball with a link to jquery.js
# provided by jQuery Debian package
/usr/share/javascript/jquery/jquery.js usr/share/doc/zuul/html/_static/jquery.js
# Overwrite underscore.js from upstream tarball with a link to underscore.min.js
# provided by Underscore Debian package
/usr/share/javascript/underscore/underscore.min.js usr/share/doc/zuul/html/_static/underscore.js

1
debian/manpages vendored
View File

@ -1 +0,0 @@
build/docs/man/*

View File

57
debian/postinst vendored
View File

@ -1,57 +0,0 @@
#!/bin/sh
# postinst script for #PACKAGE#
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postinst> `configure' <most-recently-configured-version>
# * <old-postinst> `abort-upgrade' <new version>
# * <conflictor's-postinst> `abort-remove' `in-favour' <package>
# <new-version>
# * <postinst> `abort-remove'
# * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
# <failed-install-package> <version> `removing'
# <conflicting-package> <version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
configure)
# add zuul user
if ! getent passwd zuul > /dev/null ; then
echo 'Adding system user for Zuul' 1>&2
adduser --system --group --quiet \
--home /var/lib/zuul \
--no-create-home --disabled-login \
--gecos "Zuul trunk gating daemon" \
zuul
fi
chown -R zuul:zuul /etc/zuul
chown -R zuul:zuul /var/lib/zuul
chown -R zuul:adm /var/log/zuul
chmod 0640 -R /etc/zuul/*
chmod 0750 /etc/zuul
chmod 0750 /var/lib/zuul
chmod 0750 /var/log/zuul
;;
abort-upgrade|abort-remove|abort-deconfigure)
;;
*)
echo "postinst called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

40
debian/postrm vendored
View File

@ -1,40 +0,0 @@
#!/bin/sh
# postrm script for #PACKAGE#
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postrm> `remove'
# * <postrm> `purge'
# * <old-postrm> `upgrade' <new-version>
# * <new-postrm> `failed-upgrade' <old-version>
# * <new-postrm> `abort-install'
# * <new-postrm> `abort-install' <old-version>
# * <new-postrm> `abort-upgrade' <old-version>
# * <disappearer's-postrm> `disappear' <overwriter>
# <overwriter-version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
purge)
userdel -r zuul 2>/dev/null || true
;;
remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
;;
*)
echo "postrm called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

View File

@ -1,2 +0,0 @@
python_daemon python-daemon
statsd python-statsd

32
debian/rules vendored
View File

@ -1,32 +0,0 @@
#!/usr/bin/make -f
# Uncomment this to turn on verbose mode.
#export DH_VERBOSE=1
UPSTREAM_GIT = git://github.com/openstack-infra/zuul.git
include /usr/share/openstack-pkg-tools/pkgos.make
export OSLO_PACKAGE_VERSION=$(VERSION)
%:
dh $@ --with python2,sphinxdoc
override_dh_auto_build:
dh_auto_build
$(MAKE) -C doc html man BUILDDIR=$(CURDIR)/build/docs
override_dh_auto_clean:
dh_auto_clean
rm -rf *.egg*
override_dh_auto_install:
dh_auto_install
install -D -m 0644 $(CURDIR)/etc/layout.yaml-sample $(CURDIR)/debian/etc/zuul/layout.yaml
install -D -m 0644 $(CURDIR)/etc/logging.conf-sample $(CURDIR)/debian/etc/zuul/logging.conf
install -D -m 0644 $(CURDIR)/etc/zuul.conf-sample $(CURDIR)/debian/etc/zuul/zuul.conf
override_dh_auto_test:
ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
nosetests
endif

View File

@ -1 +0,0 @@
3.0 (quilt)

2
debian/watch vendored
View File

@ -1,2 +0,0 @@
version=3
http://tarballs.openstack.org/zuul/zuul-([\d\.]+)\.tar\.gz debian