We've got some old out of date docs in some places. This isn't even
a full reworking, but at least tries to remove some of the more
egregiously wrong things.
Change-Id: I9033acb9572e1ce1b3e4426564b92706a4385dcb
In sphinx, we have a :cgit_file: directive that makes links to files.
Thing is - we're not using cgit anymore. So just rename it to git_file.
Change-Id: I80aca5fb3cc84281e29843944fea33e6f4d9fe6f
The zuul and zuulv3 docs need to be merged, but that seemed like
too much for this. Also, the 3rd party CI doc is out of date, but
in this patch only removed sections that linked to docs or files
that don't exist anymore.
Change-Id: Ie5497edd762d2146165608f3227b0bac88a913df
There's a lot of these, so doing them in chunks. This fixes
the custom roles.
Remove the git and jjb docs, since we don't use them anymore.
Change-Id: I0c5b74f7b73315dac93bce6be0d920cddb94fb58
The production directory is a relic from the puppet environment concept,
which we do not use. Remove it.
The puppet apply tests run puppet locally, where the production
environment is still needed, so don't update the paths in the
tools/prep-apply.sh.
Depends-On: https://review.openstack.org/592946
Change-Id: I82572cc616e3c994eab38b0de8c3c72cb5ec5413
This modernises the openstack-infra documentation by switching to
openstackdocstheme. Update dependencies as required.
To remove non-relevant stuff from conf.py, I have just taken the demo
file from openstackdocstheme and lightly modified it.
It seems later sphinx has included it's own ":file:" role which now
conflicts. Change it it ":cgit_file:" in our documentation. Remove
the custom header template which no longer applies. Add the
post-2.0-pbr sphinx-based warning-as-error, which fixes the original
problem that I actually noticed that errors could slip through the
gate tests :)
Change-Id: Ic7bec57b971bb4c75fc839e7269d1f69a576b85c
Currently puppetdb and puppetboard have been broken for some time (+1
year) and with ubuntu precise becoming EOL it is prime for deleting.
This leaves openstack-infra with a gap in reporting for non-root
users. As such, as proposal is in the works to maybe use ARA.
Change-Id: Ifc73a2dba3b37ebe790a29c0daa948d6bad0aa33
Signed-off-by: Paul Belanger <pabelanger@redhat.com>
It's not entirely required, but I was confused why copy/paste wouldn't
work the first few times I can this, having set the HOST variable.
Change-Id: I67cb8f27a28befbb15b070004957a78a3b776a59
Running puppet remotely in an ad-hoc manner on disabled hosts is mildly
complex. To facilitate, have a wide open playbook that we always run
with --limit - and a shell script to help us type less.
Change-Id: I629072dcada38d0465d351b1b99828466405372f
At long last, the day of reckoning is here. Run puppet apply and then
copy the log files back and post them to puppetdb.
Change-Id: I919fea64df0fbb8681e91ac9425b4c43760bb3dd
We're not ready to move from puppet inventory to openstack inventory
just yet, so don't actually swap the dynamic inventory plugin. But, add
it to the system so that running manual tests of all of the pieces is
possible.
Add the currently administratively disabled hosts to the disabled group
so that we can verify this works.
Change-Id: I73931332b2917b71a008f9213365f7594f69c41e
The install_puppet.sh script installs several things needed
by new nodes besides puppet (like pip), so making an
'apt-get install puppet' is not sufficient.
This also matches the behavior from launch-node.py, which leverages
install_puppet.sh to install puppet on new nodes.
Change-Id: I90a68b0918dcdaac136bc107ac8a1dd76f00128f
Puppet3 uses a new command line arg for the agent lockfile. Document
this new flag as replacing --puppetdlockfile.
Change-Id: I56f883c69bc9d4a573b591ad160f26e407a6df86
Move the install location of the git checkout of the config repo
to /opt/system-config to make things more consistent for operators.
Actually moving this on the puppetmaster will be a manual step.
Change-Id: Id9297088ae6c76c02e35414433aae2733f9f639c
We are renaming the openstack-infra/config repo to
openstack-infra/system-config. This patch edits the docs files.
Change-Id: Ic594f1b5438a400fb6c1071c3045adb7a0b7e441
We'd like to be able to control sequencing of how and when puppet
runs across our machines. Currently, it's just a set of agents
that run kinda whenever they run. At times they hang and we don't
know about it. Also, cross-server sequencing is impossible to
achieve.
Change the operation away from agents running on the machine as
daemons, and instead ssh from the master to each machine.
Change-Id: I76e41e63c6d0825e8735c484ba4580d545515e43
This allows hiera data to be split into two buckets: sensitive and
non-sensitive. Sensitive data is put where it always has been. Non-
sensitive data, such as users ssh keys and lists of packages can be
put into the data directory contained within the
openstack-infra/config git repository.
This also introduces a more complex hierarchy: data is now split on
osfamily and lsbdistcondename. Operatingsystem is left for
compatibility.
Change-Id: I3b3faeab837aa5732da01e96bbe0c19aa936a58d
Remove link to puppet dashboard since it is down currently.
Reinstate this link when dashboard is up again.
Also remove link to ci-puppetmaster.openstack.org/
in the navigation since it is not a clickable link.
Change-Id: I8db61b1a7b77c7625502acbdb3b7594f94e6530f
Puppetmaster bringup will often have the wrong hostname in a cloud
(e.g. a uuid or the shortname given to nova). But if it's wrong the
puppetmaster CA created by the puppetmaster module will be broken.
Additional nodes can have this handled by automation, but the
puppetmaster is special - this is part of the bootstrap process.
Change-Id: I8e0e2ea4a5d27fb248b88d6be57abb171d81f13f
There is a helpful script we can use that avoids the plumbing
discussion, and neither raring nor F19 can run a Puppet master, so we
should document that to avoid false starts.
Change-Id: I72f8767dc3fc7967207c37911e8e45a6d85c6001
We have a cgit server now, which means we should replace
all references to github with references to git.openstack.org.
Change-Id: I68ad1ce514fb4326c7d9940b5a84999af5b58562
The goal is to re-orient the documentation as an introduction for new
contributors and a reference for all contributors.
Change-Id: I8702a5ace908c7618a6451bbfef7fc79b07429ff
Reviewed-on: https://review.openstack.org/30515
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: Monty Taylor <mordred@inaugust.com>
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Tested-by: Jenkins
The documentation for hiera had the user add the repo and then remove it just
to install hiera, but that's now done in a previous step to use newer versions
of the puppet packages from the puppetlabs repos. The yaml file is also now
installed by puppet. Also collapsed all hiera documentation into the puppet
master section.
Change-Id: I00ab3cd12798295827ae25a623d246f7abf9a8df
Reviewed-on: https://review.openstack.org/20077
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Approved: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
Updated the puppet documentation to reference usage of puppetlabs repos and
basic instructions for bootstrapping the puppetmaster environment so that
puppet apply can be used to complete configuration.
Change-Id: I250e00c9bc128438378558e39f23109f9880386c
Reviewed-on: https://review.openstack.org/20048
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
To /opt/config.
Change-Id: Iab489ba398522dfd8e36dedb92d4d3f8d78df642
Reviewed-on: https://review.openstack.org/18177
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: James E. Blair <corvus@inaugust.com>
Change-Id: I409bd50ae374e0288531f07cfeea34856c5f8067
Reviewed-on: https://review.openstack.org/17319
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: James E. Blair <corvus@inaugust.com>
The existing ci-docs job is a one off job that was configured by hand.
Define the ci-docs job as a Jenkins Job Builder job using the existing
project-docs utilities.
To make the existing utilities work within the puppet repo the doc files
have been moved to doc/source, setup.cfg added to build docs in the new
dir, setup.py builds openstack-ci-puppet (instead of nova), tox now has
a venv virtualenv, and the .gitignore has been updated appropriately.
Change-Id: Ic0f291af181b4ef8eff62c5ec7cf3ccfa5b79800
Reviewed-on: https://review.openstack.org/13729
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
Monty Taylor