zuul
/
zuul
Code Issues Proposed changes

Add additional steps for configuring Zuul services on CentOS 7 

This change adds the additional steps to follow while installing Zuul on
CentOS 7. The included steps are
- creation of zuul-scheduler.service.d, zuul-executor.service.d, and
zuul-web.service.d folders in /etc/systemd/system to place provided
drop-in files
- copying provided drop-in files to appropriate locations so ExecStart
and ExecStop commands can be overriden by systemd

Apart from the additional steps, the package installation command on Fedora27
is switched to yum to keep the differences between Fedora27 and CentOS 7 at
minimum.

Depends-On: https://review.openstack.org/#/c/565074/
Change-Id: I830be38cbb52c7b8aa95f1ad080341de40250d17
This commit is contained in:
Fatih Degirmenci 2018-04-28 10:27:12 +02:00 committed by Fatih Degirmenci
parent 4b1d92d59b
commit f0beab2e6e
1 changed files with 48 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
doc/source/admin/zuul_install.rst
View File

@ -3,36 +3,60 @@
Install Zuul
============
::
sudo adduser --system zuul --home-dir /var/lib/zuul --create-home
git clone https://git.zuul-ci.org/zuul
cd zuul/
sudo dnf install $(bindep -b) -y
sudo pip3 install .
Initial Setup
-------------
::
.. code-block:: console
sudo mkdir /etc/zuul/
sudo mkdir /var/log/zuul/
sudo chown zuul.zuul /var/log/zuul/
sudo mkdir /var/lib/zuul/.ssh
sudo chmod 0700 /var/lib/zuul/.ssh
sudo mv nodepool_rsa /var/lib/zuul/.ssh
sudo chown -R zuul.zuul /var/lib/zuul/.ssh
$ sudo adduser --system zuul --home-dir /var/lib/zuul --create-home
$ sudo mkdir /etc/zuul/
$ sudo mkdir /var/log/zuul/
$ sudo chown zuul.zuul /var/log/zuul/
$ sudo mkdir /var/lib/zuul/.ssh
$ sudo chmod 0700 /var/lib/zuul/.ssh
$ sudo mv nodepool_rsa /var/lib/zuul/.ssh
$ sudo chown -R zuul.zuul /var/lib/zuul/.ssh
Installation
------------
.. code-block:: console
$ git clone https://git.zuul-ci.org/zuul
$ cd zuul/
$ sudo yum -y install $(bindep -b)
$ sudo pip3 install .
Service Files
-------------
Zuul includes some systemd service files for Zuul in the ``etc`` source
directory. To use them, do the following steps::
Zuul includes systemd service files for Zuul services in the ``etc`` source
directory. To use them, do the following steps.
$ sudo cp etc/zuul-scheduler.service /etc/systemd/system/zuul-scheduler.service
$ sudo cp etc/zuul-executor.service /etc/systemd/system/zuul-executor.service
$ sudo cp etc/zuul-web.service /etc/systemd/system/zuul-web.service
$ sudo chmod 0644 /etc/systemd/system/zuul-scheduler.service
$ sudo chmod 0644 /etc/systemd/system/zuul-executor.service
$ sudo chmod 0644 /etc/systemd/system/zuul-web.service
.. code-block:: console
$ sudo cp etc/zuul-scheduler.service /etc/systemd/system/zuul-scheduler.service
$ sudo cp etc/zuul-executor.service /etc/systemd/system/zuul-executor.service
$ sudo cp etc/zuul-web.service /etc/systemd/system/zuul-web.service
$ sudo chmod 0644 /etc/systemd/system/zuul-scheduler.service
$ sudo chmod 0644 /etc/systemd/system/zuul-executor.service
$ sudo chmod 0644 /etc/systemd/system/zuul-web.service
If you are installing Zuul on ``CentOS 7`` and copied the provided service
files in previous step, please follow the steps below to use corresponding
systemd drop-in files so Zuul services can be managed by systemd.
.. code-block:: console
$ sudo mkdir /etc/systemd/system/zuul-scheduler.service.d
$ sudo cp etc/zuul-scheduler.service.d/centos.conf \
/etc/systemd/system/zuul-scheduler.service.d/centos.conf
$ sudo chmod 0644 /etc/systemd/system/zuul-scheduler.service.d/centos.conf
$ sudo mkdir /etc/systemd/system/zuul-executor.service.d
$ sudo cp etc/zuul-executor.service.d/centos.conf \
/etc/systemd/system/zuul-executor.service.d/centos.conf
$ sudo chmod 0644 /etc/systemd/system/zuul-executor.service.d/centos.conf
$ sudo mkdir /etc/systemd/system/zuul-web.service.d
$ sudo cp etc/zuul-web.service.d/centos.conf \
/etc/systemd/system/zuul-web.service.d/centos.conf
$ sudo chmod 0644 /etc/systemd/system/zuul-web.service.d/centos.conf