812 Commits

Author SHA1 Message Date
Ian Wienand
2acfc176b0 Remove graphite.openstack.org
The server has been removed, remove it from inventory.

While we're here, s/graphite.openstack.org/graphite.opendev.org/'
... it's a CNAME redirect but we might as well clean up.

Change-Id: I36c951c85316cd65dde748b1e50ffa2e058c9a88
2019-05-08 05:55:33 +10:00
Monty Taylor
e7722f8c6b Fix cgit references in docstrings
Change-Id: Ia332bc350882d3948ee30a5569304b43a9487b82
2019-05-03 16:00:02 +00:00
Monty Taylor
d500651367 Rename cgit_file to git_file
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
2019-04-22 11:47:11 +00:00
Monty Taylor
eaa74543de Finish updating docs for opendev
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
2019-04-20 18:25:37 +00:00
Monty Taylor
06353bdb5d Remove running your own doc
This is just so massively out of date fixing it isn't worth it.

Change-Id: Ica122f4579de90c05f4b9327aa04945bbc381daf
2019-04-20 18:25:36 +00:00
Monty Taylor
e01ed4f066 Update some docs for opendev
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
2019-04-20 09:41:45 -07:00
Clark Boylan
90e867b0e3 Remove no longer used logstash config
This created confusion when updating configs to handle journald. Remove
the unused files and update docs to point at the proper config location.

Change-Id: Ifd8d8868b124b72a86cf7b5acb30480e72b903ed
2019-04-05 17:29:24 -07:00
Ian Wienand
d4a6f1269a Backup rotation procedure
Add a backup rotation procedure to the sysadmin documentation

Change-Id: I366198c635c7fd7f8e1876296bf9357dd577bf56
2019-03-19 12:12:16 +11:00
Zuul
b735f2d478 Merge "Document kerberos stash file requirement" 2019-03-01 18:15:25 +00:00
Zuul
7a712ec6e2 Merge "Docs addition on decrypting Zuul secrets" 2019-02-27 16:53:51 +00:00
Clark Boylan
9c465131db Make kdc03 the master kerberos kdc and admin server
This change will convert kdc03 to a master from a hot standby and will
remove kdc01 from management.

Cutover plan:
  Disable kdc01 in ansible emergeny file
  Stop run-kprop cron on kdc01
  Stop kadmind on kdc01
  Execute run-kprop.sh on kdc01
  Merge this change
  Wait for puppet to convert kdc03 to the master
  Confirm that run-kprop works from kdc03 to kdc04
  Update dns records as documented in our kerberos docs
  Test kadmin works
  Delete old kdc01 server

Change-Id: Ib14b11fa1f0a6bc11b0f615ce5b6f6be214b5629
2019-02-22 15:47:49 -08:00
Clark Boylan
b1b4c1e70d Document kerberos stash file requirement
This adds a piece of missing documentation for running kerberos KDC
servers.

Change-Id: Iac1ffec96ec459ac5856dcdf0fbb2c83224acdb4
2019-02-22 14:28:21 -08:00
Clark Boylan
452760a49c Add kdc03.openstack.org
This new Xenial server is being added as a kerberos standby node but
will be used to replace kdc01 as the master once fully configured and
happy as a standby. This replaces the old trusty server.

Note that the server wasn't added to opendev.org as we don't have a
kerberos realm for that domain so that would be a separate activity for
the future.

Change-Id: I4cc5fcd7504c98a7bcd9dc4f2ad57bb5bf8b54bd
2019-02-22 10:30:57 -08:00
Jeremy Stanley
7323108d4a Docs addition on decrypting Zuul secrets
As this does come up from time to time, record an example command
for decrypting a Zuul secret.

Change-Id: I056bb808ecf0f44cfa5b448521e3f28d04eeffcf
2019-02-19 18:43:26 +00:00
Clark Boylan
4d3ba10e46 pbx.openstack.org cleanup
Update the docs, test flags, cacti entries, and inventory for our new
pbx server. We have replaced the old Trusty node with a Xenial node.

Change-Id: Ifb1e156afbcb38474cbc9f0bc78ae45fdd74444b
2019-02-18 09:19:20 -08:00
James E. Blair
06f322b629 Update DNS documentation
This reflects the new ansible-only opendev dns servers.

Change-Id: I26bda9f6618f8af49a7dfb61981af8640582b7cf
2019-01-28 09:58:02 -08:00
Zuul
c132c0fe25 Merge "Update doc for ptgbot to match current behavior" 2019-01-11 19:49:33 +00:00
Zuul
1eac3674f9 Merge "Update Zuul service documentation" 2019-01-04 10:29:16 +00:00
Thierry Carrez
77b58a8f62 Update doc for ptgbot to match current behavior
PTGbot no longer updates an ethercalc document.

Change-Id: If29ca58a5dd3e4933a111fa143a376151335f32f
2018-12-21 11:38:49 +01:00
Zuul
65527237f5 Merge "Enable github shared admin account" 2018-12-19 02:29:12 +00:00
melissaml
54ecfe0ef4 Change openstack-dev to openstack-discuss
Mailinglists have been updated. Openstack-discuss replaces
openstack-dev.

Change-Id: If72585a6d360bac1696fb75ce1583a44c6dbb662
2018-12-17 10:26:01 +11:00
Zuul
d3b9dfb04a Merge "Ectomy some Jenkins out of the docs" 2018-12-12 11:53:39 +00:00
Ian Wienand
1c48bfe327 Enable github shared admin account
This change describes the shared github administrator account.

This is inspired by I0c61f192a6b5164af7babde5c99e5ee2b77a652c.  As
described there, this allows for admins to have private accounts in
the organisation, but requires that 2FA be turned on.  If people wish
to keep this as a single account which they do "real" work with
(commits, etc) that is probably OK, but add a note that you'll end up
with a lot of mostly irrelevant stuff in your feeds.

Change-Id: Ic408250571133796b4b4639715fe8d01f91898f2
2018-12-12 10:48:16 +11:00
Monty Taylor
55ddc7bf88
Ectomy some Jenkins out of the docs
There are a bunch of places where the narrative text say things like
"jenkins runs jobs". This hasn't been true for a while and it's getting
less true.

Left third-party and running-your-own alone because those are
instructions for other people to do things - and we are not yet at the
point where we are suggesting anyone do their things like we do our
things.

The devstack-gate document describes an old deprecated system, but the
system is still in use (sadly) so it was mostly left intact. A warning
was added so that people would be clear that it was deprecated.

Also removed the logstash client config file. It's the only change in
here that actually affects running code and became unnecessary when it
was switched to geard with Ie3f814e6d3278d87f2a20a72e40b6b92217684fc

Change-Id: Iaf2128c3f953976180c71cb599fcbff7bc06c28a
2018-12-10 17:55:04 +00:00
Zuul
e92b81bae2 Merge "Trivial: Update pypi url to new url" 2018-12-10 02:09:48 +00:00
Zuul
69a9ddb463 Merge "fix somes typos in doc file." 2018-12-10 02:04:26 +00:00
Zuul
dad0716592 Merge "Fix enumerated list in gerrit.rst" 2018-12-10 01:47:35 +00:00
liumk
3f8ec46be8 fix somes typos in doc file.
Change-Id: I5a27ddb6fcbcaa21c223d0b76e733063acce4556
2018-12-10 12:26:23 +11:00
melissaml
f8f7b73846 Trivial: Update pypi url to new url
Pypi url changed from [1] to [2]

[1] https://pypi.python.org/pypi/<package>
[2] https://pypi.org/project/<package>

Change-Id: Ie9f62ed7ed9d9732590d7d274feee64eb41818e9
2018-12-10 12:19:25 +11:00
Zuul
5a09af1783 Merge "Fix dead link" 2018-12-10 01:04:26 +00:00
Xing Zhang
2d049f4524 Fix enumerated list in gerrit.rst
Remove incorrect whitespace

Change-Id: I45203210da5288c14f1f273513b20160add73227
Ref: docs.o.o/infra/system-config/gerrit.html#troubleshooting
2018-12-10 11:23:27 +11:00
François Magimel
46260a79ee Fix spelling mistakes and reST typos in the doc
Change-Id: I61d9780f3f1937c6e8d326a670c40fb6a931dbce
2018-12-08 19:13:53 +01:00
Zuul
e5a4407ac7 Merge "docs: add info on generating DS records" 2018-11-29 18:00:54 +00:00
James E. Blair
d9b6be5bad docs: add info on generating DS records
Change-Id: Ie826e2c7b099d4dec5b778b1267f7b5c5a0a6bba
2018-11-21 09:51:20 -08:00
Ian Wienand
85297878f5 Retire bandersnatch mirroring
Bandersnatch mirroring has been disabled since
I88a838cb28fee3bd16b2b0a26e614ac5c2f23241 which is currently almost 6
months ago.  Since then we have been running a reverse caching proxy.

Although bandersnatch served us well, it seems pypi has become
impractical to mirror locally.  This is partially due to 2TB volume
limitations of OpenAFS and partially due to us not having a sane way
to filter large, frequently updating packages.  With the reverse proxy
working there are no plans to restore our local mirror.

Retire the references to it before we clean up the AFS volumes.

Change-Id: Ia23828328dd859bbf26f95735c1c2e99c573d10e
2018-11-16 10:28:11 +11:00
Clark Boylan
0f8e7a91bb Nodepool.o.o is no longer a thing, remove it
We've only been using nodepool.o.o as a zookeeper server for the past
year or so. Last week we transitioned to a three node zookeeper cluster
and stopped using nodepool.o.o. This server has since been deleted.

This is the last bit of cleanup to remove it from config management.

Change-Id: I9d0363393ed20ee59f40b210ea14fb105a492e20
2018-11-01 12:09:08 -07:00
Zuul
84123c60c8 Merge "Add a workflow overview for adding a cloud" 2018-10-20 15:19:45 +00:00
Ian Wienand
8a95c976e9 Add a workflow overview for adding a cloud
Add some details about how we integrate a new cloud into the
ecosystem.  I feel like this is an appropriate level of detail given
we're dealing with clueful admins who just need a rough guide on what
to do and can fill in the gaps.

Fix up the formatting a bit while we're here.

Change-Id: Iba3440e67ab798d5018b9dffb835601bb5c0c6c7
2018-10-19 16:38:00 +00:00
Zuul
015e82e1eb Merge "Add opendev nameservers (1/2)" 2018-10-17 17:41:58 +00:00
Zuul
c7b7801b3b Merge "Add afs client docs for non Debuntu" 2018-10-17 00:22:26 +00:00
Clark Boylan
9a16571f0d Add afs client docs for non Debuntu
Add info on how to kinit and aklog if not using Debuntu deb.conf to set
the correct realm and cell settings.

Change-Id: I80a698649f03863b73399873cf190fda4fa41776
2018-10-16 15:46:44 -07:00
James E. Blair
f5d3ee4b79 Add opendev nameservers (1/2)
This will allow us to create new nameservers in the opendev.org
domain.  We will replace the existing servers once these are
bootstrapped.

Some lines are commented pending server creation.

Change-Id: If71e3f87a9d7a83d80cff053874c84411b248515
2018-10-16 14:40:10 -07:00
Jeremy Stanley
d97ac5e50a Add note about mounting one AFS volume in another
This ate a good chunk of my day before a more AFS-savvy colleague
pointed out that a mountpoint within a volume is just a special kind
of file record and so needed the parent volume released before it
would appear in the read-only path.

Change-Id: Ic3d717d70c8bf2548447550472a52849dd85ffd3
2018-10-05 14:03:30 +00:00
Jeremy Stanley
5e668c952d Update Zuul service documentation
Much of this document was stale since putting Zuul v3 into
production. Attempt to bring it up to our current state.

Change-Id: I1b9d665cbf5ca88917d6e0361a6b16026b2ad6c6
2018-09-26 23:33:54 +00:00
Zuul
62a7f45951 Merge "There are no core developers, only core reviewers" 2018-09-21 20:54:20 +00:00
Sorin Sbarnea
ba48b1dc5c Remove expire-old-reviews from docs
As this feature was disabled we remove it from docs to avoid
confusing users.

Change-Id: Ia5704bcda37b8da43af6e22673a3d3b03605649d
2018-09-18 17:22:43 +01:00
Jeremy Stanley
c7046e7183 Update artifact signing key generation process
Now that we've retired the old puppetmaster server and moved the
master keychain to the new bridge server we're faced with a much
newer release of GnuPG. This change updates various commands to
their modern option equivalents and attempts to adjust the sample
output to more closely resemble what administrators will see when
following the process.

Change-Id: Ic5eaa646786c2b7fa9ade9e42026f9ea5be40c56
2018-09-01 01:19:18 +00:00
Andreas Jaeger
c5a9e3793b Remove obsolete pypi-mirror
We do not use pypi-mirror anymore, there's also no usage of pypimirror
in jeepyb. Remove the now obsolete module.

Related change: https://review.openstack.org/597370/
Change-Id: I13423bf55eac57da18449852e2102c9633d595bb
2018-08-29 09:00:36 +02:00
Andreas Jaeger
1c6b4876eb Cleanup docs formatting
Fix indents of some pages, the wrong indent let to gray bars besides
them.

Also, fix a typo and add some markup.

Change-Id: I6e7126ef7b782b376efcc7c6d69c6de9a504ddb5
2018-08-24 22:13:37 +02:00
Ian Wienand
1939f3e8ec Move exim role to top-level
Move the exim role to be a "generic" role in the top-level roles/
directory, making it available for use as a Zuul role.

Update the linters jobs to look for roles in the top level

Update the Role documentation to explain what the split in roles is
about.

Change-Id: I6b49d2a4b120141b3c99f5f1e28c410da12d9dc3
2018-08-23 21:34:47 +10:00