summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.openstack.org>2018-07-27 19:37:44 +0000
committerGerrit Code Review <review@openstack.org>2018-07-27 19:37:44 +0000
commit22ad98af4a96b93de3e64a48e3aaca03c4832496 (patch)
tree12543b3f493a18e9011fa083c703e98ecfb12f0a
parent8b85dfd5198888e4b8e2f7327a41f4e83539755f (diff)
parent04fc889b327ee9c00add28c06c15d06bb8ed47da (diff)
Merge "Add instructions for deploying zuul with openSUSE"3.2.0
-rw-r--r--doc/source/admin/nodepool_install.rst11
-rw-r--r--doc/source/admin/opensuse_leap15_setup.rst57
-rw-r--r--doc/source/admin/zuul-from-scratch.rst1
-rw-r--r--doc/source/admin/zuul_install.rst11
4 files changed, 78 insertions, 2 deletions
diff --git a/doc/source/admin/nodepool_install.rst b/doc/source/admin/nodepool_install.rst
index 8a3ec22..17f958b 100644
--- a/doc/source/admin/nodepool_install.rst
+++ b/doc/source/admin/nodepool_install.rst
@@ -29,10 +29,19 @@ are required.
29 29
30.. code-block:: console 30.. code-block:: console
31 31
32 # All:
32 $ git clone https://git.zuul-ci.org/nodepool 33 $ git clone https://git.zuul-ci.org/nodepool
33 $ cd nodepool/ 34 $ pushd nodepool/
35
36 # For Fedora and CentOS:
34 $ sudo yum -y install $(bindep -b) 37 $ sudo yum -y install $(bindep -b)
38
39 # For openSUSE:
40 $ sudo zypper install -y $(bindep -b)
41
42 # All:
35 $ sudo pip3 install . 43 $ sudo pip3 install .
44 $ popd
36 45
37Service File 46Service File
38------------ 47------------
diff --git a/doc/source/admin/opensuse_leap15_setup.rst b/doc/source/admin/opensuse_leap15_setup.rst
new file mode 100644
index 0000000..90131c7
--- /dev/null
+++ b/doc/source/admin/opensuse_leap15_setup.rst
@@ -0,0 +1,57 @@
1:orphan:
2
3openSUSE Leap 15
4================
5
6We're going to be using openSUSE Leap 15 for this installation.
7
8Prerequisites
9-------------
10
11If you are using Zuul with GitHub,
12
13- Port 9000 must be open and accessible from the Internet so that
14 GitHub can communicate with the Zuul web service.
15
16Environment Setup
17-----------------
18
19First, make sure the system packages are up to date, and then install
20some packages which will be required later. Most of Zuul's binary
21dependencies are handled by the bindep program, but a few additional
22dependencies are needed to install bindep, and for other commands
23which we will use in these instructions.
24
25::
26
27 sudo zypper install -y git python3-pip
28
29Then install bindep
30
31::
32 pip3 install --user bindep
33 # Add it to your path
34 PATH=~/.local/bin:$PATH
35
36Install Zookeeper
37-----------------
38
39Nodepool uses Zookeeper to keep track of information about the
40resources it manages, and it's also how Zuul makes requests to
41Nodepool for nodes.
42
43You should follow the `official deployment instructions for zookeeper
44<https://zookeeper.apache.org/doc/current/zookeeperAdmin.html>`_,
45but to get started quickly, just download, unpack and run:
46
47::
48
49 sudo zypper install -y java-1_8_0-openjdk
50 wget http://apache.mirror.amaze.com.au/zookeeper/stable/zookeeper-3.4.12.tar.gz
51 tar -xzf zookeeper-3.4.12.tar.gz
52 cp zookeeper-3.4.12/conf/zoo_sample.cfg zookeeper-3.4.12/conf/zoo.cfg
53 ./zookeeper-3.4.12/bin/zkServer.sh start
54
55.. note:: Don't forget to follow `Apache's checksum instructions
56 <https://www.apache.org/dyn/closer.cgi#verify>`_ before
57 extracting.
diff --git a/doc/source/admin/zuul-from-scratch.rst b/doc/source/admin/zuul-from-scratch.rst
index c9a32fd..4ec5acb 100644
--- a/doc/source/admin/zuul-from-scratch.rst
+++ b/doc/source/admin/zuul-from-scratch.rst
@@ -12,6 +12,7 @@ Follow the instructions below, depending on your server type.
12 12
13 * :doc:`fedora27_setup` 13 * :doc:`fedora27_setup`
14 * :doc:`centos7_setup` 14 * :doc:`centos7_setup`
15 * :doc:`opensuse_leap15_setup`
15 16
16Installation 17Installation
17------------ 18------------
diff --git a/doc/source/admin/zuul_install.rst b/doc/source/admin/zuul_install.rst
index feceebc..5e20d13 100644
--- a/doc/source/admin/zuul_install.rst
+++ b/doc/source/admin/zuul_install.rst
@@ -31,10 +31,19 @@ required.
31 31
32.. code-block:: console 32.. code-block:: console
33 33
34 # All:
34 $ git clone https://git.zuul-ci.org/zuul 35 $ git clone https://git.zuul-ci.org/zuul
35 $ cd zuul/ 36 $ pushd zuul/
37
38 # For Fedora and CentOS:
36 $ sudo yum -y install $(bindep -b) 39 $ sudo yum -y install $(bindep -b)
40
41 # For openSUSE:
42 $ zypper install -y $(bindep -b)
43
44 # All:
37 $ sudo pip3 install . 45 $ sudo pip3 install .
46 $ popd
38 47
39Service Files 48Service Files
40------------- 49-------------