759 Commits

Author SHA1 Message Date
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
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
Zuul
c9d73b0bb0 Merge "Update of codeblock for adding a new list" 2018-05-30 23:50:14 +00:00
Amy Marrich (spotz)
0adfe1b7c7 Update of codeblock for adding a new list
The code block for adding a new list to Mailman was out of date.
Updated the codeblock to match format in the lists.pp file.

Change-Id: I76c844c051e8c51a4c76fd774f6af038c647b819
2018-05-30 18:13:28 -05:00
Ian Wienand
1b8a1018fe Add some rationale for reprepro
An interesting discussion this morning brought up some details of
reprepro that maybe aren't widely understood.  Add some rationale to
the docs.

Change-Id: I371cc67a10d29881b8df03f09830776bf5639ac8
2018-05-31 08:01:47 +10:00
Vu Cong Tuan
07ccb8444f Update Zuul Status Page to correct URL
Current URL of Zuul Status Page in doc is:
http://status.openstack.org/zuul/

The correct URL must be:
https://zuul.openstack.org/

Change-Id: I042c53ee49b9ac08504a56ca56adaacd3d9a4548
2018-05-25 08:22:58 +07:00
Zuul
cbd054c930 Merge "Add docs on mailman lock files" 2018-04-24 15:02:38 +00:00
James E. Blair
534f5f6e99 Add docs on mailman lock files
Change-Id: I3451e1061270f56774119bc6eb80c4da78ccb6da
2018-04-19 08:09:56 -07:00
Matthew Treinish
0d799489ce
Re-enable the websockets tls port
Since we re-enabled the websockets port in change
Id9bb77ef9a2ac70eec74db4ea64423b5d6351a06 things having quite stable.
Connections to mosquitto over websockets hasn't crashed. Since things
have been stable this commit unblocks the tls websockets port for
firehose.o.o and switches it to the standard 443 for https instead of
the default 8080 we were using before. This should enable websites
trying to use the firehose over websockets from https server.

Change-Id: I1b08eabf22f5345a9b4ebfae5d3dab08270efbf9
2018-04-13 19:36:42 -04:00
Jeremy Stanley
113d455c70 Note missing AAAA records for AFS servers
Document why we don't maintain AAAA resource records in DNS for our
OpenAFS servers.

Change-Id: Ib295e79b32af43f26782e4277464bd130f4318e4
2018-04-09 21:56:05 +00:00
James E. Blair
b1fff1d2eb Add haproxy maintenance instructions
Change-Id: I236d55a0bbc44d29ef4290972dc30d68f683c040
2018-04-04 07:58:44 -07:00
Zuul
dca7c88e7b Merge "Update signing docs for Zuul v3" 2018-04-03 17:07:54 +00:00
Zuul
c3466f398c Merge "Add NO_TIMEOUT flag for reprepro" 2018-03-23 00:24:33 +00:00
Zuul
051cbe4bcb Merge "Add a note on the shared infra root mail account" 2018-03-22 23:36:42 +00:00
Zuul
5e448096b3 Merge "Properly deprecate stackforge" 2018-03-22 00:14:16 +00:00
Clark Boylan
dae5b29ec4 Properly deprecate stackforge
We still have a stackforge doc. The TC deprecated this term forever ago
so lets stop using it.

https://governance.openstack.org/tc/resolutions/20160119-stackforge-retirement.html
has all the governance details.

Change-Id: I537f239dfd7adde2d6c082cc4ecef59c485d789e
2018-03-21 13:40:57 -07:00
Zuul
1da3d9d2bd Merge "Add notes on reprepro _addreference" 2018-03-20 08:12:13 +00:00
Ian Wienand
8cf4b59796 Update AFS fileserver settings
Jeffrey Altman has pointed out that our settings are not optimal for
our use cases.  Turning up threads and callbacks is a start.  We
should evaluate the other settings too.

Add notes on how to apply settings manually

Change-Id: I1405b21f97c1ac2d3bd99ffbba18e5fd0ff959b1
2018-03-20 10:58:09 +11:00
Jeremy Stanley
cbbceb2330 Update Gerrit project renaming for Zuul v3
With the switch to Zuul v3, we need to resolve some configuration
catch-22s where project names and related in-repository job
definitions can't happen without a complex multi-stage removal and
reintroduction process to get it through speculative testing
successfully. For now, just punt and use monolithic changes
bypassing CI in code review. As an up side, the Ansible automation
of this process coupled with Zuul v3's increased resilience to
on-the-fly configuration changes means we can skip stopping/starting
it now and significantly simplify the process.

Since we're here, correct the section heading level for
"Force-Merging a Change" in the sysadmin document.

Change-Id: I335c23abd0b5706f43bbea2dd8cfffa4280dd5db
2018-03-19 15:26:58 +00:00
Ian Wienand
b8703c3f54 Add notes on reprepro _addreference
I had to figure out this command to restore some of our reprepro
mirrors, add notes on it.

Cleanup some other things I noticed; quotes around REPREPRO command,
clarify the situation with pointing mirrors at the RO/RW volumes and
refactor discussion.

Change-Id: I3e3f763929bf74e0c4faf29b13973dcf1df36975
2018-03-19 13:51:23 +11:00
Zuul
9059e0dfad Merge "Stop embedding (outated) PTL contact info in docs" 2018-03-14 22:30:19 +00:00
Jeremy Stanley
fd75fadee3 Update signing docs for Zuul v3
Update the artifact signing key rotation process documentation for
the new Zuul v3 status quo. Also note that revocation certificates
should use distinct filenames per cycle so that they don't get
overwritten.

Change-Id: Ia7512cc7bd0b1ed52e99271e7d83f05e7bc57918
2018-03-12 13:12:23 +00:00
Ian Wienand
09d080a337 Add NO_TIMEOUT flag for reprepro
During manual runs, you want to do this without a timeout.  Add a
flag; I always end up copying the script and manually editing this
stuff in.  Add a quick note in the AFS docs.

Change-Id: I239bc1a0b5928673b42cc67291bb519d5f5d2471
2018-03-08 15:15:48 +11:00
Matthew Treinish
e12563ae54
Remove note about disabled websockets
Now that we've re-enabled the websockets support we can remove the note
about that now. However, we've disabled the tls websockets port so that
line is removed. Hopefully this doesn't horribly jinx the websockets
interface being reliable.

Change-Id: I500bd69efe13b202199e9741f8cd10f12f78f2af
2018-03-06 16:25:09 -05:00
Jeremy Stanley
e37a44fb2f Stop embedding (outated) PTL contact info in docs
Use a link to the project governance page so readers of the
contributing cloud article can find current PTL details.

Change-Id: Ifc8212c7703e7ac4c6113b866c424e9e9a774a5e
2018-03-06 14:32:09 +00:00
Zuul
e59b6cd4a8 Merge "Add logstash worker to services table" 2018-02-22 20:58:31 +00:00
Ian Wienand
5b2ac45099 Add a note on the shared infra root mail account
Change-Id: Id8ae73f99f46d5f0224c8d9145d5c06ee9ea09da
2018-02-08 12:01:55 +11:00
Zuul
41d276d839 Merge "Fix zuulv3 links" 2018-01-24 20:41:17 +00:00
Jeremy Stanley
a187f1665b Decommission zuulv3.openstack.org server
Now that zuulv3.openstack.org has been replaced by the larger
zuul01.openstack.org server, the former can be cleaned out of our
configuration in preparation for server deletion.

Change-Id: Icc1d545906e5615e2a205b98f364a084e1d22895
2018-01-20 00:57:04 +00:00
Clark Boylan
a17b99c0d0 Update for feature/zuulv3 merging into master
We are merging feature/zuulv3 in Zuul and Nodepool into master. That
means we need to point things that were pointing at feature/zuulv3 back
to master. Make this update.

Change-Id: Id95fcfbf872e0ed5122941c8c14c0dbf8f393ba4
2018-01-18 09:55:30 -08:00
Matthew Treinish
33e23066de
Add logstash worker to services table
When we added the schema documentation for the logstash workers to
firehose docs we neglected to update the services tables. This commit
corrects the oversight and updates the table to include the logstash
workers.

Change-Id: Ie2bda5c56b16b1eec1f7e59c6388865bce22cecc
2018-01-17 16:24:26 -05:00
Zuul
cf62dfd4fa Merge "Remove zuul-dev.o.o" 2018-01-16 19:00:26 +00:00
Jeremy Stanley
2d57c7cfd9 Add a zuul01.openstack.org
In preparation for replacing the zuulv3.openstack.org host with a
larger instance, set up the necessary support in
Puppet/Hiera/Ansible. While we're here, remove or replace old
references to the since-deleted zuul.openstack.org instance, and
where possible update documentation and configuration to refer to
the new zuul.openstack.org CNAME instead of the zuulv3.openstack.org
FQDN so as to smooth the future transition.

Change-Id: Ie51e133afb238dcfdbeff09747cbd2e53093ef84
2018-01-15 20:32:54 +00:00
Zuul
a404b9b37d Merge "Add note on how to talk to zuul's gearman" 2018-01-11 23:11:19 +00:00