Reorganizing docs as recommended in:
https://www.divio.com/blog/documentation/
This is simply a reorganization of the existing documents and changes
no content EXCEPT to correct the location of sphinx doc references.
Expect followup changes to change document names (to reflect the new
structure) and to move content from existing guides (e.g., to move the
pipeline/project/job structure definitions out of the "Project Configuration"
reference guide into their own reference documents for easier locatability).
All documents are now located in either the "overview", "tutorials",
"discussions", or "references" subdirectories to reflect the new structure
presented to the user. Code examples and images are moved to "examples" and
"images" root-level directories.
Developer specific documents are located in the "references/developer"
directory.
Change-Id: I538ffd7409941c53bf42fe64b7acbc146023c1e3
This removes the need for the user to enter an empty passphrase.
Change-Id: Id87ab5476363c77526b6eeb64bd0c83ac66127ef
Signed-off-by: Paul Belanger <pabelanger@redhat.com>
Add the correct libre2 package name for Debian buster, and also
update the quickstart playbook and documentation to deal with
the change in default rsa key encoding format from newer
versions of ssh-keygen.
Change-Id: I6ada88cd896d844c1171f7bcaf4691dea023d51f
This makes a number of changes to the installation/configuration
documentation in the admin manual.
Remove quick-start guide. The process of quick-starting is
covered by the installation and setup tutorial, which is now the
first of the installation sections. The reference material from
quick-start is now in the tutorial.
Rename the tutorial quick-start. It's nice to have something
named quick-start, and the tutorial fits the bill.
Rename the installation section "Installation Reference". This
now has more detailed information about installation and
deployment choices, but has very little procedural documentation.
Make zuul-from-scratch more internally consistent in style (use
code-block:: shell and heredocs wherever possible).
Change-Id: I7e4714ce5e775dc9ac0988c3470eef1f74fb36d6
Use useradd rather than adduser[0] as some distros do not come with adduser
installed.
Additionally some distros do not use a group per user, instead ensure the
zuul and nodepool groups are created and assigned to their respective
users.
[0] https://askubuntu.com/questions/345974/what-is-the-difference-between-adduser-and-useradd
Change-Id: Id44a7dbc03896705aed576a05a2fe8db62d76272
This change adds the additional steps to follow while installing Nodepool
on CentOS 7. The included steps are
- creation of /etc/systemd/system/nodepool-launcher.service.d to place
provided drop-in file
- copying provided drop-in file to the appropriate location so ExecStart
command 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.
Also some, of the nodepool configuration steps like creation of the
directories and ssh key generation are moved into nodepool_install.rst
similar to how zuul_install.rst lists some of these steps.
SSH key nodepool_rsa is needed in zuul_install.rst but it gets created later
in nodepool_openstack.rst so moving the key generation to nodepool_install.rst
prevents possible confusion as well.
Depends-On: https://review.openstack.org/#/c/564872/
Change-Id: If073ba5559d3ad055c0c8a1f2f4213ce6ed8af9f
Also modify the Zuul From Scratch doc to reference these new files
in the service installation documents.
Depends-On: https://review.openstack.org/560993
Change-Id: Ifa0d1cd48ec5e1ef3358ada55b1b2769f392dfe9
In preparation for adding instructions for Gerrit and other
Linux derivatives, reorganize the "Zuul From Scratch" doc to
more easily incorporate those changes.
Also, just use the default Zookeeper config. That bit is
moved to be with the Zookeeper installation portion.
Change-Id: I206a2acf09eb8a2871ec61a00226654c798bb3eb
David Shrewsbury