Merge "Add instructions for deploying zuul with openSUSE"

doc/source/admin/nodepool_install.rst

@@ -29,10 +29,19 @@ are required.
 
 .. code-block:: console
 
+   # All:
    $ git clone https://git.zuul-ci.org/nodepool
-   $ cd nodepool/
+   $ pushd nodepool/
+
+   # For Fedora and CentOS:
    $ sudo yum -y install $(bindep -b)
+
+   # For openSUSE:
+   $ sudo zypper install -y $(bindep -b)
+
+   # All:
    $ sudo pip3 install .
+   $ popd
 
 Service File
 ------------

doc/source/admin/opensuse_leap15_setup.rst

@@ -0,0 +1,57 @@
+:orphan:
+
+openSUSE Leap 15
+================
+
+We're going to be using openSUSE Leap 15 for this installation.
+
+Prerequisites
+-------------
+
+If you are using Zuul with GitHub,
+
+- Port 9000 must be open and accessible from the Internet so that
+  GitHub can communicate with the Zuul web service.
+
+Environment Setup
+-----------------
+
+First, make sure the system packages are up to date, and then install
+some packages which will be required later.  Most of Zuul's binary
+dependencies are handled by the bindep program, but a few additional
+dependencies are needed to install bindep, and for other commands
+which we will use in these instructions.
+
+::
+
+   sudo zypper install -y git python3-pip
+
+Then install bindep
+
+::
+   pip3 install --user bindep
+   # Add it to your path
+   PATH=~/.local/bin:$PATH
+
+Install Zookeeper
+-----------------
+
+Nodepool uses Zookeeper to keep track of information about the
+resources it manages, and it's also how Zuul makes requests to
+Nodepool for nodes.
+
+You should follow the `official deployment instructions for zookeeper
+<https://zookeeper.apache.org/doc/current/zookeeperAdmin.html>`_,
+but to get started quickly, just download, unpack and run:
+
+::
+
+   sudo zypper install -y java-1_8_0-openjdk
+   wget http://apache.mirror.amaze.com.au/zookeeper/stable/zookeeper-3.4.12.tar.gz
+   tar -xzf zookeeper-3.4.12.tar.gz
+   cp zookeeper-3.4.12/conf/zoo_sample.cfg zookeeper-3.4.12/conf/zoo.cfg
+   ./zookeeper-3.4.12/bin/zkServer.sh start
+
+.. note:: Don't forget to follow `Apache's checksum instructions
+          <https://www.apache.org/dyn/closer.cgi#verify>`_ before
+          extracting.

doc/source/admin/zuul-from-scratch.rst

@@ -12,6 +12,7 @@ Follow the instructions below, depending on your server type.
 
   * :doc:`fedora27_setup`
   * :doc:`centos7_setup`
+  * :doc:`opensuse_leap15_setup`
 
 Installation
 ------------

doc/source/admin/zuul_install.rst

@@ -31,10 +31,19 @@ required.
 
 .. code-block:: console
 
+   # All:
    $ git clone https://git.zuul-ci.org/zuul
-   $ cd zuul/
+   $ pushd zuul/
+
+   # For Fedora and CentOS:
    $ sudo yum -y install $(bindep -b)
+
+   # For openSUSE:
+   $ zypper install -y $(bindep -b)
+
+   # All:
    $ sudo pip3 install .
+   $ popd
 
 Service Files
 -------------