113 Commits

Author SHA1 Message Date
Thierry Carrez
2b38255f57 Clarify that statusbot requires public messages
Add a doc clarification about statusbot listening to public messages,
rather than private ones.

Change-Id: I62dcf8b0b04af1850bc18b6f3ff86c07e8a4f52c
2013-09-25 16:39:53 +02:00
Jenkins
2925e7c360 Merge "Phase 3 infra bootstrap docs: gerrit." 2013-09-23 21:44:05 +00:00
Jenkins
594079a951 Merge "Document Jenkin slave management." 2013-09-23 21:43:58 +00:00
Jenkins
257ef42107 Merge "Improve Jenkins documentation." 2013-09-23 21:43:50 +00:00
Jenkins
1ac5643116 Merge "Improve Zuul docs." 2013-09-23 21:43:43 +00:00
Jenkins
a3871ba0cd Merge "Document push key acceptance." 2013-09-23 21:43:36 +00:00
Jenkins
b5a7cf8378 Merge "Explain API projects a little." 2013-09-23 21:43:28 +00:00
Jenkins
c84145a93b Merge "Document basic admin hints for jeepyb." 2013-09-23 21:43:21 +00:00
Robert Collins
d2e2802ae2 Phase 3 infra bootstrap docs: gerrit.
These are still rough, but I'd appreciate an expert eye cast over
them.

Change-Id: If46abecd73456f143544f4507bf98385339a3f2e
2013-09-23 17:27:22 -04:00
Robert Collins
32f42c745f Document Jenkin slave management.
This is correct-but-incomplete as I understand it: nodepool is not yet covered.

Change-Id: Ib45cdb94f876e51bd7c01aecad70f470923d9b52
2013-09-23 17:27:22 -04:00
Robert Collins
7ec707ca4b Improve Jenkins documentation.
The initial setup was not documented at all.

Change-Id: I074eabac958b77ecf3a333c9ea9beabd539b2f9e
2013-09-23 17:27:22 -04:00
Robert Collins
08f78ace59 Improve Zuul docs.
The list of pipelines (duplicated with the layout.yaml) was incomplete.

No node size was described, and the need (or lack thereof) for backups
wasn't covered.

Change-Id: Ia20b610e7c51184239910d6b6e902390593fcaff
2013-09-23 17:27:22 -04:00
Robert Collins
28e1a2cc3d Document push key acceptance.
Gerrit replication calls out to ssh which requires host keys to be
accepted in the relevant user account. Document this to ease initial
deployment.

Change-Id: I03b8f1c39a4562cc480b3ef612cb3306b1445814
2013-09-23 17:27:22 -04:00
Robert Collins
713468b6d1 Explain API projects a little.
I was thoroughly confused, and suspect others without direct
experience may be too.

Change-Id: I9003eeaefc7734ef360ff893cec8c828fd51f254
2013-09-23 17:27:22 -04:00
Robert Collins
e7316e1673 Document basic admin hints for jeepyb.
Somewhat obvious, but would have saved me a debugging round-trip.

Change-Id: I31a69b8ba0413ed09423822b817f0d05517751b0
2013-09-23 17:27:22 -04:00
Robert Collins
1ac5997a82 Gerrit docs improvements - user and groups.
The user and group docs were a bit opaque, and the needed groups for
the project creator account were not well documented.

Change-Id: Iee6d3ea6dd34a687205412174f78cd44e756c953
2013-09-23 17:25:32 -04:00
Robert Collins
1ba7d02a0e Make gerrit DB setup match actual practice.
sudo su - mysql is the actual mechanism used by -infra folk.

Change-Id: I209f0e9e2cb3f4dd7ad012f39b6e6551c05c5e0e
2013-09-23 17:25:32 -04:00
Jenkins
83063e2f4a Merge "Clean up flake8 issues before switch" 2013-09-21 14:57:33 +00:00
Monty Taylor
eef4f76011 Clean up flake8 issues before switch
In anticipation of swtiching to flake8 as part of the removal of
pyflakes jobs, clean up a few flake8 errors so that we don't have to
ignore as many things.

Change-Id: Idb8466bb3194904d84e17dd3f2a7c32aff13788c
2013-09-20 14:37:30 -07:00
Jenkins
2f81032060 Merge "adding staging server for activity board" 2013-09-20 21:20:52 +00:00
Jenkins
266b6541ce Merge "Add cacti documentation" 2013-09-20 21:17:39 +00:00
Elizabeth Krumbach Joseph
9c01216cf3 Add publications link to docs
Now that it's working, add the Infrastructure Publications link
to our project documentation.

Change-Id: I8cea33d1a30905bb3b8ec4e569416ad2e22fb681
2013-09-20 12:23:07 -07:00
Elizabeth Krumbach Joseph
c93ebce891 Add cacti documentation
Initial commit for basic cacti documentation and how to add a
new host to our instance.

Change-Id: I16f3474c5e0355ea10d4bffc94925624ee64328a
2013-09-20 11:54:45 -07:00
Stefano Maffulli
93490ce25d adding staging server for activity board
Change-Id: Ib2b0de6e2cdc59f5c9dca90117d333f70dbab040
2013-09-12 14:40:44 +10:00
James E. Blair
dcef558baf Move running-your-own to the sidebar
It is a HOWTO and it isn't part of the flow of the main docs,
which are focused on how the OpenStack project infrastructure
is used and operated.

Change-Id: I6e783899ab55f952acab81c7c90ca596d9bb1603
2013-09-11 13:02:26 -07:00
Jenkins
43f6a6a96f Merge "Clarify bup server setup directions." 2013-09-11 04:43:04 +00:00
Clark Boylan
1d194f6a79 Clarify bup server setup directions.
* doc/source/sysadmin.rst: Add note about needing to send an EOF to bup
server to close the initial ssh connection used to verify the backup
server's ssh host key.

Change-Id: I9c21513e5c6de771572f1aa9cb10095bff730eac
2013-09-09 16:12:52 -07:00
Khai Do
02076717d0 link to jjb cache documentation in the handbook .
Additional documentation was added for jjb cache in jjb manual.
Instead of documenting it twice, this
patch simply points to the jjb manual.

Depends on I57cf59c8723aa04e20801f32a81b573c9d096b48
Fixes bug 1193450

Change-Id: I1741d9774540d1e6b877533f29238663c2890028
2013-09-09 12:12:26 -07:00
Jenkins
91980ec05d Merge "Add backup restore docs." 2013-09-09 13:02:24 +00:00
Khai Do
6192aea57f update thirdy party testing how to doc
I don't believe openstack has it's own jenkins gerrit trigger plugin
anymore.  The link was returning a 404 Error.  Updated the link
to point to the general gerrit trigger plugin in the jenkins-ci repo.

Change-Id: Id42f2d8371b8c8e4a0f1f57e110637d4a8b14953
2013-09-06 14:21:33 -07:00
Clark Boylan
c6cde7cfe4 Add backup restore docs.
* doc/source/sysadmin.rst: Document how to restore from bup backups.

* modules/bup/files/etc/bup-excludes: Exclude special backup restore
dirs in /root. This prevents backup restores from being backed up
too.

Change-Id: Ide0e69c128be0a8b8774df7acaf9267df097f104
2013-09-06 13:29:04 -07:00
Jenkins
3735479bf0 Merge "Gerrit sysadmin tips for account repairs/renaming" 2013-09-06 00:10:29 +00:00
Jeremy Stanley
ae0c06c1a8 Preserve change creation time on project renames
* doc/source/gerrit.rst: When renaming projects in the changes
table, set created_on to itself so that it won't get updated to the
current time. This column is a timestamp datatype in MySQL and has
the "on update" property set, probably for no good reason but it's
how Gerrit's installer sets the schema.

Change-Id: I5b99d2869e55ab0f8b036fd08f248f406aff41bb
2013-09-05 01:36:43 +00:00
Jeremy Stanley
31bfd240e0 Gerrit sysadmin tips for account repairs/renaming
* doc/source/gerrit.rst: Add sections to the document about
resetting Gerrit SSH usernames and cleaning up duplicate preferred
E-mail addresses. Also a section demonstrating the dreaded account
merge process for posterity, even though we do not offer to perform
this for our users.

Change-Id: I43883ef9558abbdf5051aa617def36d1fc158100
2013-09-04 20:40:22 +00:00
Jenkins
4ce7f1991d Merge "Update references to GerritJenkinsGit wiki" 2013-09-03 17:55:40 +00:00
Robert Collins
2bfb9144f2 Document setting the correct hostname.
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
2013-08-31 09:54:09 +12:00
Robert Collins
4d90f7a50c Document bootstrapping a new infrastructure.
Change-Id: Ic3345ecfe1c093ef68844430ed1c77cadbcf8b94
2013-08-31 08:43:13 +12:00
Robert Collins
0e5baad93f Document hiera setup a bit more comprehensively.
I had to ask, therefore we should record it :).

Change-Id: I321aa77df0037ff52a14e2bee81b147c312d08d6
2013-08-31 08:43:13 +12:00
Robert Collins
d6fd7db432 Make setting up a Puppetmaster easier.
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
2013-08-31 08:43:12 +12:00
Robert Collins
01e19830c3 Start documenting running your own CI infra.
This is incomplete, but as I haven't got a full thing up yet I can't
write it all. It is minimally a useful pointer for other folk trying
to do the same thing.

Change-Id: Iefb62a0ff60e5f46f1f0091beef54bfc4a376a53
2013-08-31 07:55:46 +12:00
Robert Collins
b24e2c4c91 Add a pointer to launch/README for root operators.
Cause it's not discoverable at the moment.

Change-Id: Ib8a4752f9340126e98b342e71ec6ebc11e6809b4
2013-08-31 07:55:43 +12:00
Elizabeth Krumbach Joseph
9f24ee0df1 Update references to GerritJenkinsGit wiki
We've moved the GerritJenkinsGithub wiki page to instead be
at GerritJenkinsGit, update references to it in our configs.

Change-Id: I88d8140a0e5f6e4051ca78415e0152c9cdcb86f6
2013-08-30 10:58:30 -07:00
Robert Collins
09b5460de0 Make root-only information clear in sysadmin.rst.
As we document more fully, it has become clear that the sysadmin page
really has two audiences: openstack-ci contributors and
openstack-ci/cloned-infra root operators.

Change-Id: If82c20a6292048f4212aac293da0b284f3b91436
2013-08-29 22:17:32 +12:00
Robert Collins
bd65ae3971 Fix semantic error in example config.
The user list is meant to be a list, not a literal.

Change-Id: I56fe64660c4a45aacdab7c4b2454d46ce7e80631
2013-08-29 22:17:32 +12:00
Robert Collins
7abc5fc72a Just run the install_puppet/modules scripts.
They have an x bit set and a shebang line, there is no need to specify
bash explicitly.

Change-Id: Ide8d0389c42d4ab256be3c0f6bdfcfcee621982b
2013-08-28 16:11:54 +12:00
Robert Collins
d9286370ff Fix copy-n-paste example to be clearer.
The example for spinning up an etherpad server couldn't just be run,
because the path to install_puppet.sh and the path to local.pp were
inconsistent. So lets document that the commands should be run from
the root of the checkout and fix the path to local.pp.

Change-Id: I34d4768687bd8aea8cd695faa845bddef24fa55f
2013-08-28 00:35:04 +12:00
Elizabeth Krumbach Joseph
dd1bb4a541 Update git documentation with HAProxy details
Update the documentation for our public git servers to reflect that it's now a
pool of servers load balanced with HAProxy.

Change-Id: Ib8bfec5cf8b339f2dfb57aaaf46d988ff32fc261
2013-08-23 10:25:53 -07:00
Jenkins
d78e4e6acc Merge "Use cgit server instead of github for everything" 2013-08-23 17:01:32 +00:00
Jenkins
5915c05a67 Merge "Clean up Static Web Hosting document" 2013-08-23 16:40:02 +00:00
Jeremy Stanley
350b6939a6 Clean up Static Web Hosting document
* doc/source/static.rst: Correctly indent a few preformatted command
example blocks, add a couple internal hyperlinks and clean up some
trailing whitespace on a number of lines.

Change-Id: I57980c21ac2eb08dafb05a4dc669992952b7465f
2013-08-23 16:36:32 +00:00