855 Commits

Author SHA1 Message Date
Jeremy Stanley
8641302459 Mention new mailing lists
The OpenDev community is moving its discussions off the old
openstack-infra mailing list, so make sure to refer to the correct
new address(es).

Change-Id: I558b60ea0aa3421285d46be449f04198441cf285
2020-04-06 18:19:28 +00:00
Zuul
b474879c03 Merge "Correct launch readme link" 2020-04-04 19:46:53 +00:00
James E. Blair
06d5ce1423 Correct launch readme link
This has a .rst extension now.

Change-Id: Icafdb12f91315f5c37f95755034d216bc4a5c837
2020-03-27 09:45:42 -07:00
Jeremy Stanley
8da233817b Re-add secret decrypting docs
These are useful for the times when a secret needs to be decrypted
for debugging but seem to have been deleted when we did the zuulv3
migration removal.

Change-Id: Ib1544d9032df9bd25c50eeca032f643e40f035b0
2020-03-23 13:16:05 -05:00
Zuul
2c89ce1807 Merge "Split gitea and gerrit services from manage-projects" 2020-03-23 14:28:40 +00:00
Andreas Jaeger
62e76b5177 Docs: Update main page for OpenDev
Update conf.py and index.rst for OpenDev.

Use newer openstackdocstheme and update conf.py for this.

Change-Id: I62312ca1d3fda9221660b7bb664c8ea55dac68a4
2020-03-22 19:14:51 +01:00
Monty Taylor
86542eb9ba Split gitea and gerrit services from manage-projects
There are two different concerns here. One is configuring the gitea
and gerrit services. This is independent from the management of
projects running inside them.

Make a manage-projects playbook which currently runs gitea-git-repos
but will also get a gerrit-git-repos role in a bit. Make a
service-gitea playbook for deploying gitea itself and update
run_all to take all of that into account. This should make our
future world of turning these into zuul jobs easier.

Add several missing files to the files matchers for run-gitea
and run-review.

Also - nothing about this has anything to do with puppet.

Change-Id: I5eaf75129d76138c61013a3a7ed7c381d567bb8b
2020-03-21 11:34:19 -05:00
Andreas Jaeger
2c0b82e5e8 Update infra-manual location
The infra-manual now lives on docs.opendev.org, update links.

New location is: https://docs.opendev.org/opendev/infra-manual/latest

Change-Id: I7716c68cbff4f3a640d7161f59cfc034a7ccca52
2020-03-20 22:03:09 +01:00
Zuul
a54baada30 Merge "Make Advisory Board a proper noun" 2020-03-19 01:02:19 +00:00
Zuul
e3f7c8cee8 Merge "Update references to IRC channels" 2020-03-18 18:55:57 +00:00
Dr. Jens Harbott
c86525ccd3 Update references to IRC channels
With the move from OpenStack governance to our own OpenDev team, we
should also move to use the #opendev IRC channel in preference to
the #openstack-infra channel which will remain in use for OpenStack
specific discussions.

Update the references in our docs accordingly.

Change-Id: I448704f5d2664fd233a69a2ad12578ca24d9878a
2020-03-18 17:33:08 +01:00
Zuul
8e45f95748 Merge "Update project doc to reflect OpenDev changes" 2020-03-17 20:22:45 +00:00
Clark Boylan
08e2418e58 Make Advisory Board a proper noun
This fixes a small nit on the prior docs change.

Change-Id: Id408cf410e7fc50d418cc701d3b195ebcffd1b85
2020-03-17 13:03:37 -07:00
Ian Wienand
288e516ace letsencrypt: add note on manual refresh of certificates
Add a note on how to manually refresh the certificates if required.

Change-Id: Ie5f494e3769b7b878c2d1b03836d436dd845e5d9
2020-03-05 21:50:29 +00:00
Sorin Sbarnea
f861cda57c Improve 3rd-party logging guidelines
Based on #openstack-infra talks from Feb 17th, I am proposing some clarifications regarding how logging should
be done by 3rd party CI.

These should help 3rd party integrators create a better
experience for developers, making logs more accessible.

Change-Id: I2ebc788505ba1319afc038d0aa1406da3823a911
2020-02-18 09:29:24 +00:00
Zuul
1f67b8ed37 Merge "Add docs for deleting an AFS volume" 2020-02-10 17:09:04 +00:00
Clark Boylan
95e8c8edde Update project doc to reflect OpenDev changes
This change effectively converts the OpenStack Infra project description
into an OpenDev project description in our documentation. Since OpenDev
is largely an evolution of the preexisting infra team much of the
content remains the same. I have added a section on governance as we'll
not be able to run off of the OpenStack governance any longer.

Note this leaves what becomes the OpenStack Infra project without a
project document. However, the remaining scope of that OpenStack project
will be small and I don't think it will need to same level of team
organization. I think we can get by with OpenStack's default governance
for its teams there. Then should we need something more explicit or
different we can write that up within openstack itself.

Depends-On: https://review.opendev.org/#/c/703134/
Change-Id: I56aab771510768211386325e6466d2f94fe298fb
2020-02-05 14:59:39 +00:00
James E. Blair
cfc1841c06 Add warning about kerberos key rotation
Change-Id: I9e4caf8feeb775c02208a5e5f1627f03a90e4211
2020-01-31 16:22:52 -08:00
James E. Blair
255f996916 Add docs for deleting an AFS volume
Change-Id: I1763eb2bf580591b68bf4e2853378331b8261293
2020-01-20 09:43:34 -08:00
Zuul
44935bca39 Merge "Add notes on manual host configuration runs" 2020-01-16 22:53:05 +00:00
Ian Wienand
4bb7746347 Update gitea docs
Give the location of the database backups, and update the replication
section.

Change-Id: Ic687ab3bab1a1534cdd26d357f729db054e8b60e
2019-11-15 10:21:51 +11:00
James E. Blair
87fccc8e9b Add docs for recovering an OpenAFS fileserver
This should be a smooth recovery process.

Change-Id: I3c68b077e38a88160286d94e71676c0c4dbb6a51
2019-09-13 10:42:17 -07:00
Zuul
1b14855a45 Merge "AFS server restart and audit logging : helper script" 2019-08-29 21:03:09 +00:00
Andreas Jaeger
13ce6ffd69 Zuul docs: Remove obsolete note
This note is not needed anymore, remove it.

Change-Id: I708fc3653833f794a448d40e3df72626f282b747
2019-08-28 06:51:58 +02:00
Andreas Jaeger
a6aaaed6a3 Docs: Zuul v2 is dead
Update the Zuul v3 page with correct links and description of promote
pipeline and remove the now obsolete note - and follow it with renaming
the document to zuul.

Change-Id: I9c89cb56d4a318f3a234e7f2f08dabb46d0dfab6
2019-08-27 08:39:57 +02:00
Ian Wienand
814e4be128 Ansible roles for backup
This introduces two new roles for managing the backup-server and hosts
that we wish to back up.

Firstly the "backup" role runs on hosts we wish to backup.  This
generates and configures a separate ssh key for running bup and
installs the appropriate cron job to run the backup daily.

The "backup-server" job runs on the backup server (or, indeed
servers).  It creates users for each backup host, accepts the remote
keys mentioned above and initalises bup.  It is then ready to receive
backups from the remote hosts.

This eliminates a fairly long-standing requirement for manual setup of
the backup server users and keys; this section is removed from the
documentation.

testinfra coverage is added.

Change-Id: I9bf74df351e056791ed817180436617048224d2c
2019-08-05 16:59:57 +10:00
Ian Wienand
35f1321e14 AFS server restart and audit logging : helper script
This script helps restart the AFS servers, which is useful when
updating parameters.  It can also enable audit logging.

It can also stop and start the servers, although it's unlikely we'd
want all the servers offline at the same time so stopping has a
warning included.

Documentation is updated to refer to the helper script

Change-Id: Idcb3e43a3f6e614cdb787d4334e692a98bffdd15
2019-08-02 16:37:00 +10:00
Zuul
b0ea150b89 Merge "Correct emergency file reference in launch script" 2019-07-31 23:22:38 +00:00
James E. Blair
48cafd19f8 Add LE cert for logs.opendev.org to static
This can be used in an apache vhost later, but should be fine to
merge now.

Depends-On: https://review.opendev.org/673902
Change-Id: Ic2cb7585433351ec1bdabd88915fa1ca07da44e7
2019-07-31 13:00:50 -07:00
Jeremy Stanley
4c04ad5436 Correct emergency file reference in launch script
The launch script is referring to the wrong path for the emergency
inventory. Also correct the references in the sysadmin guide and
update the example for using it.

Change-Id: I80bdbd440ec451bcd6fb1a3eb552ffda32407c44
2019-07-26 14:55:32 +00:00
Ian Wienand
667e0dffa0 Add some pointers on the OpenDev PPA
The OpenStack/OpenDev PPA repositories are currently undocumented.
Add some information on where to find things.

Change-Id: Iea03c5d558b3dd6af9f7c860dfcc75a71dc59d9f
2019-07-22 10:58:54 +10:00
Zuul
40c53a796a Merge "mirror-update: update docs for mirror-update.opendev.org" 2019-07-18 20:54:03 +00:00
Zuul
876e7b0dbd Merge "Streamline documented bup setup process" 2019-07-18 13:33:08 +00:00
Ian Wienand
6b22833765 Add letsencrypt documentation
Add an overview of Let's Encrypt operation, and details of requesting
a certificate for hosts.

Change-Id: I636dbeb60383edd79f8d852c52272f6a79043154
2019-07-08 15:21:44 +10:00
Ian Wienand
23f4f3989d mirror-update: update docs for mirror-update.opendev.org
Update AFS docs to refer to the new host

Change-Id: Ib6b54729e0b186ceb7d0beffbbd68bcab0e2e1ba
2019-07-04 09:11:40 +10:00
Ian Wienand
abf11982ce Raise callbacks for AFS server
As documented in [1]

 If the number next to "GotSomeSpaces" or any of the "GSS*" fields is
 greater than 0, then the fileserver ran out of callback space and had
 to prematurely revoke callback promises from clients in order to free
 up space.

Here's our stats on afs01:

  $ xstat_fs_test localhost -collID 3 -onceonly

  Starting up the xstat_fs service, no debugging, one-shot operation

  ------------------------------------------------------------
            13547865 DeleteFiles
          1849223729 DeleteCallBacks
            45049055 BreakCallBacks
          2098382037 AddCallBack
                 174 GotSomeSpaces
                7800 DeleteAllCallBacks
               20778 nFEs
               21184 nCBs
             1500000 nblks
            43425561 CBsTimedOut
                   0 nbreakers
                   8 GSS1
                   4 GSS2
                   5 GSS3
                 169 GSS4
                   4 GSS5

So as noted, the server ran out of callback spaces a few times.
Raising it takes only a little memory, but will help performance.

Thanks to Jeffrey Altman (auristor) for pointing this out.

[1] https://www.openafs.org/pages/newsletter/newsletter-2013-03-volume004-issue05.html

Change-Id: I2ad33dd8918cb559634d2c5b8c4e4e7f2d6d4051
2019-06-28 12:14:47 +10:00
Clark Boylan
4aac4b990a Add docs for deploying a new gitea server
We have gitea state now so deploying a new server requires a bit of
process. Document that process.

Change-Id: I946f9880b66efdfb39bc9894950cd02058ed987a
2019-06-27 12:31:48 -07:00
David Pursehouse
c32fd879b7 Remove dead link from 'paste' documentation
Change-Id: If47bb344d9e0dbea26a45bf8d0353c53449f89a1
Signed-off-by: David Pursehouse <dpursehouse@collab.net>
2019-06-20 11:24:30 +09:00
Jeremy Stanley
861f5e893f Streamline documented bup setup process
Reorder some of the commands used to set up and configure the bup
user on backup servers so the process is more straightforward and
requires fewer mental context switches.

Change-Id: I73cb80a04b8b5a74bb0857b4c8b6fb09030d6306
2019-06-18 23:57:19 +00:00
Andreas Jaeger
15a5806bce Follow opendev renames
The sandbox repos moved from openstack-dev to opendev, the
zone-opendev.org and zone-zuul-ci.org as well.

Follow the rename in this repo.

Depends-On: https://review.opendev.org/657277
Change-Id: I31097568e8791cc49c623fc751bcc575268ad148
2019-05-30 16:00:30 +02:00
James E. Blair
860652fedf Add gitea docs
This is based on the recently removed cgit document, but updated
for gitea.

Change-Id: I4bb1f4b9485d15c412e4882ccc0baf031aeba87b
2019-05-29 08:06:29 -07:00
Monty Taylor
40e3cf3c5e Update references to OpenDev Zuul
The GitHub app has been updated to be called OpenDev Zuul. Update
the docs accordingly.

Change-Id: I384f84d2d291e82c2062b116c77f1b062a009907
2019-05-22 11:16:23 -05:00
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