Ansible role to manage Zuul

Go to file

Paul Belanger 24422999ee Rework tox -edocs This allows us to drop setup.cfg / setup.py files. Change-Id: I80243d7d619f8d724fab7c44dc6c1164f3aa5fb3 Signed-off-by: Paul Belanger <pabelanger@redhat.com>		2019-03-30 20:36:32 -04:00
defaults	Allow user to optionally manage config files	2019-01-07 14:39:51 -05:00
doc	Rework tox -edocs	2019-03-30 20:36:32 -04:00
handlers	Fix truthy value should be true or false warnings	2018-08-19 12:33:51 -04:00
meta	Bump minimal version of ansible to 2.4.0	2018-04-19 16:13:58 -04:00
tasks	Create zuul_pip_virtualenv_symlink variable	2019-03-23 23:20:26 -04:00
templates/etc	Define zookeeper hosts for zuul configuration	2019-03-22 20:14:19 -04:00
tests	Clean up ansible-lint 4.0.0 errors	2018-12-18 11:52:22 -05:00
vars	Add new build dependencies	2018-04-19 16:12:27 -04:00
.gitignore	Import ansible-role-zuul into OpenStack workflow	2015-11-24 11:38:17 -05:00
.gitreview	Import ansible-role-zuul into OpenStack workflow	2015-11-24 11:38:17 -05:00
.zuul.yaml	Stop gating on ubuntu-xenial	2018-12-05 16:48:56 -05:00
bindep.txt	Move ansible dependency to bindep.txt	2018-03-08 20:57:47 -05:00
LICENSE	Initial commit	2015-09-10 16:50:05 -04:00
README.rst	Default zuul_pip_executable to pip3	2018-04-13 13:00:49 -04:00
requirements.txt	Bump minimal version of ansible to 2.4.0	2018-04-19 16:13:58 -04:00
test-requirements.txt	Rework tox -edocs	2019-03-30 20:36:32 -04:00
tox.ini	Rework tox -edocs	2019-03-30 20:36:32 -04:00

README.rst

ansible-role-zuul

Ansible role to manage Zuul

License: Apache License, Version 2.0
Documentation: https://ansible-role-zuul.readthedocs.org
Source: https://git.openstack.org/cgit/openstack/ansible-role-zuul
Bugs: https://bugs.launchpad.net/ansible-role-zuul

Description

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.

Requirements

pip3 to be installed if using zuul_install_method: (git|pip)

See bindep.txt for role dependencies.

Packages

Package repository index files should be up to date before using this role, we do not manage them.

SSH

An SSH private key will need to be installed before you can use zuul. The contents of the private key will be used by zuul_config_gerrit_user and should be copied to zuul_config_gerrit_sshkey.

Role Variables

# Method used to install zuul. Valid values are git and pip.
# Default: git
zuul_install_method: git

# Git, SSH, or HTTP(s) protocol address of the git repository.
# Default: https://git.openstack.org/openstack-infra/zuul
zuul_git_uri: https://git.openstack.org/openstack-infra/zuul

# What version of the repository to check out.
# Default: master
zuul_git_version: master

# Absolute path of where the repository should be checked out to.
# Default: /opt/ansible-role-zuul/git/openstack-infra/zuul
zuul_git_dest: /opt/ansible-role-zuul/git/openstack-infra/zuul

# The version number to install from the Python Package Index.
# Default: None
zuul_pip_version:

# Name of the user to be created.
# Default: zuul
zuul_user_name: zuul

# Name of the group to be created.
# Default: zuul
zuul_user_group: zuul

# Path of home directory to be created.
# Default: /var/lib/zuul
zuul_user_home: /var/lib/zuul

Zuul Merger Configuration

# Value to pass to git config user.email.
# Default: Empty
zuul_config_merger_git_user_email: ""

# Value to pass to git config user.name.
# Default: Empty
zuul_config_merger_git_user_name: ""

Dependencies

Example Playbook

- name: Install zuul
  hosts: zuul
  roles:
    - ansible-role-zuul