diff options
Diffstat (limited to 'doc/source/howtos')
-rw-r--r-- | doc/source/howtos/nodepool_install.rst | 3 | ||||
-rw-r--r-- | doc/source/howtos/ubuntu_setup.rst | 54 | ||||
-rw-r--r-- | doc/source/howtos/zuul-from-scratch.rst | 1 | ||||
-rw-r--r-- | doc/source/howtos/zuul_install.rst | 3 |
4 files changed, 61 insertions, 0 deletions
diff --git a/doc/source/howtos/nodepool_install.rst b/doc/source/howtos/nodepool_install.rst index 7a4c6dd02..015ebbde1 100644 --- a/doc/source/howtos/nodepool_install.rst +++ b/doc/source/howtos/nodepool_install.rst @@ -39,6 +39,9 @@ are required. # For openSUSE: sudo zypper install -y $(bindep -b compile) + # For Ubuntu: + sudo apt-get install -y $(bindep -b compile) + # All: sudo pip3 install . popd diff --git a/doc/source/howtos/ubuntu_setup.rst b/doc/source/howtos/ubuntu_setup.rst new file mode 100644 index 000000000..bd9b68378 --- /dev/null +++ b/doc/source/howtos/ubuntu_setup.rst @@ -0,0 +1,54 @@ +:orphan: + +Ubuntu +====== + +We're going to be using Ubuntu on a cloud server for this installation. + +Prerequisites +------------- + +- Port 9000 must be open and accessible from the Internet so that + GitHub can communicate with the Zuul web service. + +Login to your environment +------------------------- + +Since we'll be using a cloud image for Ubuntu, our login user will +be ``ubuntu`` which will also be the staging user for installation of +Zuul and Nodepool. + +To get started, ssh to your machine as the ``ubuntu`` user. + +.. code-block:: shell + + ssh ubuntu@<ip_address> + +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. + +.. code-block:: shell + + sudo apt-get update + sudo apt-get install python3-pip git + + # install bindep, the --user setting will install bindep only in + # the user profile not global. + pip3 install --user bindep + +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. + +.. code-block:: console + + sudo apt-get install -y zookeeper zookeeperd diff --git a/doc/source/howtos/zuul-from-scratch.rst b/doc/source/howtos/zuul-from-scratch.rst index 7e77e94ff..2c0965c6f 100644 --- a/doc/source/howtos/zuul-from-scratch.rst +++ b/doc/source/howtos/zuul-from-scratch.rst @@ -18,6 +18,7 @@ Follow the instructions below, depending on your server type. * :doc:`fedora27_setup` * :doc:`centos7_setup` * :doc:`opensuse_leap15_setup` + * :doc:`ubuntu_setup` Installation ------------ diff --git a/doc/source/howtos/zuul_install.rst b/doc/source/howtos/zuul_install.rst index 09ded9d15..8f61651ac 100644 --- a/doc/source/howtos/zuul_install.rst +++ b/doc/source/howtos/zuul_install.rst @@ -41,6 +41,9 @@ required. # For openSUSE: $ zypper install -y $(bindep -b compile) + # For Ubuntu: + $ apt-get install -y $(bindep -b compile) + # All: $ tools/install-js-tools.sh |