792 Commits

Author SHA1 Message Date
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
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
Ian Wienand
b99c4c6fb0 Generate roles documentation
Since we're building out roles in system-config now, generate
documentation.  We look in roles/* and playbook/roles/* (follow-on
changes will split things up between the two).

Correct the reference names in the exim documentation to avoid
warnings and failure.

This also revealed a single unicode character in the exim readme
(which caused prior versions of zuul-sphinx to barf).  For fun, see if
you can find it!

Depends-On: https://review.openstack.org/#/c/579474/
Change-Id: I243a96bbd6d09560f8aa80b6345b90039422547a
2018-08-23 14:49:50 +10:00
Ian Wienand
c3c5cb97af Update to latest docs PTI
We now put the documentation-only requirements in doc/requirements.txt
and call build-sphinx directly [1]; see

[1] https://governance.openstack.org/tc/reference/project-testing-interface.html#documentation

Change-Id: I4ade203f1746409275d213f409603199ecb93878
2018-08-22 07:51:46 +10:00
Monty Taylor
0625c289c8
Remove infracloud references
We don't run a cloud anymore and don't use these. With the cfg
management update effort, it's unlikely we'd use them in the form they
are in even if we did get more hardware and decide to run a cloud again.

Remove them for clarity.

Change-Id: I88f58fc7f2768ad60c5387eb775a340cac2c822a
2018-08-20 11:03:55 -05:00
Monty Taylor
7ed39c17f5
Fix AFS and CA docs references to puppetmaster
Also, update the locations that we're told to hieraedit.

Change-Id: I41824ff9dc52b3e70a5e55ae71ef49f29511e8e3
2018-08-19 10:26:10 -05:00
Monty Taylor
c716240692
Clean up puppetmaster puppet config handled by ansible
We have a bunch of this handled now in ansible, so remove the old stuff.

Remove puppetmaster group management files. It's confusing for there to
be two files. Remove the old one.

Remove mqtt config. This isn't really a thing currently, and we're
eyeing running things from zuul anyway, so no need to port to ansible.

Change-Id: I8b64d21eadcc4a08bd5e5440fc5f756ae5bcd46b
2018-08-17 11:53:52 -05:00
Monty Taylor
1a8c2f66da
Move /opt/system-config/production to /opt/system-config
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
2018-08-17 09:41:02 -05:00
Monty Taylor
bab6fcad3c
Remove base.yaml things from openstack_project::server
Now that we've got base server stuff rewritten in ansible, remove the
old puppet versions.

Depends-On: https://review.openstack.org/588326
Change-Id: I5c82fe6fd25b9ddaa77747db377ffa7e8bf23c7b
2018-08-16 17:25:10 -05:00
Zuul
06602fbdcf Merge "Remove references to stackalytics.o.o" 2018-08-09 08:50:58 +00:00
Colleen Murphy
46ebeeb4fb Remove references to stackalytics.o.o
stackalytics.openstack.org does not resolve and seems very dead. Remove
its node from site.pp and remove it from the docs to avoid confusion
about what servers we're really managing. We can always add it back when
the time comes to try again.

Change-Id: I733130ebe97ae7e06ca57b3c8e3a8708fcfa069c
2018-08-07 22:12:43 +02:00
Zuul
273ff63637 Merge "Remove mention of excercises.sh" 2018-08-07 15:16:22 +00:00
Zuul
04aac06820 Merge "Update Gerrit project renaming for Zuul v3" 2018-08-01 16:45:10 +00:00
Dirk Mueller
6d14615495 Remove mention of excercises.sh
It isn't used for some time anymore and doesn't pass, so lets
remove the mentioning of it.

Change-Id: I9d8e319c9621fa37c1beefe46db4e4d6368acfb9
2018-07-17 10:34:46 +02:00
Jeremy Stanley
cf0da86f03 There are no core developers, only core reviewers
Our community has insisted in the past that "core developers" aren't
a thing, so if we want to avoid continued propagation of that
terminology then we should do our best to eradicate it in official
documents.

Change-Id: I8f97231f7e56548c5ad0925ba2c5bb09e4800438
2018-07-07 14:57:28 +00:00
Ian Wienand
882b730fdf Update to openstackdocstheme
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
2018-06-25 11:19:43 +10:00
Zuul
f332511f82 Merge "Document an example for deleting content from AFS" 2018-06-12 22:14:18 +00:00
Zuul
24fa959586 Merge "Survey Documentation" 2018-06-12 00:35:55 +00:00
Anita Kuno
1f21e135d3 Survey Documentation
This patch creates the documentation for the survey service.

Co-Authored-By: Jeremy Stanley <fungi@yuggoth.org>

Change-Id: Ie602a952b58c5f5200518cb31218097bddd5b747
Story: 2000691
2018-06-08 12:16:01 -04:00
Jeremy Stanley
2e92731929 Document an example for deleting content from AFS
A simple walkthrough of using an AFS superuser to perform write
operations under an AFS read-write path, including authenticating
and unauthenticating.

Change-Id: If27376745b43f94f27f104bca9309035d265ee72
2018-06-08 16:00:41 +00:00
Jeremy Stanley
f4bc2917ef Document Kerberos password reset process
As happens, if you don't use your Kerberos credentials often you may
lose track of your password for them. Document how, as a system
administrator with a shell on one of the KDCs, you can set a new
passwords for your accounts without needing to recreate the
principals.

Change-Id: I843b5be9630c805335a6cca04237477002748242
2018-06-06 16:06:44 +00:00
Zuul
4762cf78c2 Merge "Update Zuul Status Page to correct URL" 2018-06-04 00:46:25 +00:00