1003 Commits

Author SHA1 Message Date
Clark Boylan
d435c9fd01 Update example zuul config to remove deprecated syntax
The zuul pipeline reporter for merge-failure has been renamed to
merge-conflict. The old name has been depreacted and will be removed in
a future release. Update our examples to match Zuul's current
expectations.

Change-Id: I1f9effa311163d942171e35ba65fafa25245e9d2
2022-09-02 09:23:15 -07:00
James E. Blair
1ff685488e Combine / reconcile two force-merge docs
The force-merge procedure was documented twice, neither one complete.
Combine them.

Change-Id: If4350a0a90d455b64227befde2f1be7475ac8120
2022-07-28 07:57:21 -07:00
Zuul
d46e4c2308 Merge "gerrit docs: add note that duplicate user may have email addresses to remove" 2022-06-24 06:03:33 +00:00
Zuul
2599cdccb8 Merge "gerrit docs: cleanup and use shell-session" 2022-06-24 05:56:55 +00:00
Ian Wienand
4f3be693e5 gerrit docs: add note that duplicate user may have email addresses to remove
Change-Id: I54e935704d38dd60cdf75415dd8c61b06cae7b11
2022-06-24 15:37:54 +10:00
Ian Wienand
3a09bf7e8a gerrit docs: cleanup and use shell-session
A few formatting fixes

* try to more consistently use shell-session formatting for shell
  sessions (makes it easier to copy-paste).
* fix up and use more `` around verbatim/code things.

Fixes:

 * Gerrit Configuration : there's no db to set the ICLA fields in now,
   remove
 * Duplicate Accounts : add required arg "origin" to git fetch command
 * Deactivating account : can not delete comments via sql query,
   remove

Change-Id: Ia481750aa59fc88bef5c00bb0fd9e6f9e23b2777
2022-06-24 15:37:52 +10:00
Jeremy Stanley
121cc0e452 Add description to IRC channel reg example
OFTC's chanserv requires a channel description be provided when
registering it. Update the example in our documentation to reflect
that.

Change-Id: Iee61b8176b2b801b4843530e7570bad5000fe76e
2022-06-16 14:54:32 +00:00
Jeremy Stanley
40caa4eec6 third-party CI: reminder to keep address current
Now that we're retiring the third-party-ci-announce mailing list,
which we never really used consistently anyway, just tell
third-party CI operators to make sure the E-mail address on their
account is current and reachable.

Change-Id: I6186149de25b06f2982702143a807de8bb01be73
2022-05-02 23:14:12 +00:00
Jeremy Stanley
1f1443a2c8 Clean up defunct OpenStack mailing lists
In preparation for retiring a number of mailing lists from
lists.openstack.org which have had no activity for over three years,
remove their configuration so our deployment automation won't
recreate them once they're gone. Also remove references to the
third-part-announce list in our documentation, since that's one of
the unused lists we're removing. See the announcement at
http://lists.openstack.org/pipermail/openstack-discuss/2022-February/027404.html
for details.

Change-Id: Ieedd8613363039d19d3ae47f1a83a38747419bdc
2022-04-29 18:27:22 +00:00
Jeremy Stanley
d185aedd7d Decommission status.openstack.org and services
The status.openstack.org server is offline now that it no longer
hosts any working services. Remove all configuration for it in
preparation for retiring related Git repositories.

Also roll some related cleanup into this for the already retired
puppet-kibana module.

Change-Id: I3cfcc129983e3641dfbe55d5ecc208c554e97de4
2022-04-29 16:34:51 +00:00
Zuul
7b09f7baab Merge "Remove configuration management for ELK stack" 2022-04-22 16:04:22 +00:00
Zuul
4e8d344e67 Merge "Remove config management for subunit2sql workers" 2022-04-18 19:00:40 +00:00
Clark Boylan
4279e20293 Remove configuration management for ELK stack
We indicated to the OpenStack TC that this service would be going away
after the Yoga cycle if no one stepped up to start maintaining it. That
help didn't arrive in the form of OpenDev assistance (there is effort
to use OpenSearch external to OpenDev) and Yoga has released. This means
we are now clear to retire and shutdown this service.

This change attempts to remove our configuration management for these
services so that we can shutdown the servers afterwards. It was a good
run. Sad to see it go but it wasn't sustainable anymore.

Note a follow-up will clean up elastic-recheck which runs on the status
server.

Depends-On: https://review.opendev.org/c/opendev/base-jobs/+/837619
Change-Id: I5f7f73affe7b97c74680d182e68eb4bfebbe23e1
2022-04-18 10:04:06 -07:00
Clark Boylan
a5f06418b6 Remove config management for subunit2sql workers
The openstack health service is being shutdown and retired. That
services was the only service that relied on the subunit2sql workers.
This means we can shutdown and retire the subunit2sql workers. This is
one step of that process.

Change-Id: Ibd02faaeba888dfcd1f512f4dd3a7d768497fc16
2022-04-18 10:01:57 -07:00
Zuul
7675cbd390 Merge "Retire opendev/puppet-openstack_health: remove from system-config" 2022-04-18 15:55:10 +00:00
Jeremy Stanley
15e07d8a37 Fix a trivial typo for repo renaming playbook path
Change-Id: I3cb5c42df9cc4e9c308da592353b7867391211a3
2022-04-15 14:49:00 +00:00
Ian Wienand
654c287367 doc/jeepyb: further cleanups
Follow-on to I07ca2b18d2da7e6261389696a0eae13d20d2cb22

* Github issues are now closed via the
  maintain-github-openstack-mirror which Zuul runs periodically

* manage-projects also runs from Zuul

* run-mirror hasn't been used since If5935b356e222c2f4d474a2cec8add3cc66b6010

* I'm not sure what the ssh key stuff is talking about, it's not
  really relevant now.

Change-Id: If4d8a1ac98c35c494090564d94f3a8c082cea900
2022-04-12 09:29:37 +10:00
Ghanshyam Mann
d37b9ee005 Retire opendev/puppet-openstack_health: remove from system-config
opendev/puppet-openstack_health is retiring(needed-by) so we need to
remove this puppet module from system cofig.

Needed-By: https://review.opendev.org/c/opendev/puppet-openstack_health/+/836711
Change-Id: I2ea259aaec0d2d14447dcd55931b3fa51cd04831
2022-04-06 13:44:49 -05:00
Clark Boylan
97707fe43d Remove openstackwatch docs
This service appears to have gone away. We remove docs about it.

Change-Id: I07ca2b18d2da7e6261389696a0eae13d20d2cb22
2022-03-15 15:44:06 -07:00
Zuul
decddbe23f Merge "docs: reorganise around a open infrastructure overview" 2022-03-10 05:45:08 +00:00
Ian Wienand
4c86706e5e docs: reorganise around a open infrastructure overview
This introduces and "Open Infrastructure" page which is designed for a
moderately experienced developer with some understanding of Zuul,
Ansible and basic Linux admin skills to have an entrypoint to
navigating the system-config and related repositories.

It is designed to re-enforce the idea of open infrastructure, and
explain how development, testing and production come together at a
level high enough to be understood, but with links or descriptions of
specific places in the code to get started.

It moves a little of what was in the sysadmin page into this, and
leaves that page as more low-level descriptions of various tasks.

Change-Id: I60a9299df455b98ad549ac0075a59d381722bc06
2022-03-04 12:18:42 +11:00
Clark Boylan
6f178c2737 Add docs on restoring a gitea repository
We have discovered that it is possible for a gitea repository to be come
corrupted. Since gitea is not the source of truth the easiest way to
handle this is to replace the repo with a new empty repository and have
Gerrit replicate back to it. This adds documentation that walks through
the process of doing this.

Change-Id: Ief990adaaf3cbb3c748bc9ee6ceb466a1104915a
2022-03-02 12:03:01 -08:00
Zuul
10664ccf3d Merge "Update Interop doc" 2022-02-17 16:48:33 +00:00
Zuul
cd939ca0a2 Merge "grafana: update docs and make an import script" 2022-02-01 01:25:24 +00:00
Clark Boylan
bdeef4e4ce Add info on running jstack against gerrit to docs
This is meant to help debug gerrit in some circumstances particularly
now that the Java Melody plugin is not installed.

Change-Id: Ifedb7abd08c7fe1281ac510c6872fe8d9fe700a1
2022-01-31 12:06:05 -08:00
Ian Wienand
70c1fb2dff grafana: update docs and make an import script
Update the docs to reflect not having grafyaml in the container.

Also move the import into a separate helper script, which can be
manually run on the host if the container needs to be restarted
out-of-band for some reason.

Change-Id: Ib1f6aea7e16180d9b122552a2aa30ce223426941
2022-01-25 14:18:04 +11:00
Zuul
79f0a5d413 Merge "Add docs for restoring an etherpad" 2022-01-25 00:15:52 +00:00
Dr. Jens Harbott
fdf6bedcf9 Add docs for restoring an etherpad
Signed-off-by: Dr. Jens Harbott <harbott@osism.tech>
Change-Id: I98c168145125cfa3a6f544b5751dfb936c8ae7ef
2022-01-24 16:39:13 +00:00
Jack Morgan
93e20041f9 Minor update to documentation.
Signed-off-by: Jack Morgan <jack@jento.io>
Change-Id: Ic2b7d71796634ca024dae33547d1b17f349b7f1e
2022-01-11 17:53:16 -08:00
Ghanshyam Mann
4f2bbe301c Fix command for setting the entry message for IRC channel
In OFTC, entery message is set via ``entrymsg`` command,
correcting it in doc.

<ChanServ> *** SET Help ***
..
URL: Set the channel's homepage.
EMAIL: Sets the channel's e-mail address.
ENTRYMSG: Sets the channel greeting.
..

Change-Id: I2e436015641ab78c5b509b4b4ca35e1088c3376f
2021-12-15 16:02:40 -06:00
Martin Kopec
715842d14f Update Interop doc
The commit replaces DefCore committee (a former name) by
Interop Working Group (the current name) and updates a few
more old interop references.

Change-Id: I35d754ad0b37ba462afdc52b552fbd0b607954df
2021-12-13 12:46:05 +00:00
James E. Blair
e79dbbe6bb Add a keycloak server
This adds a keycloak server so we can start experimenting with it.

It's based on the docker-compose file Matthieu made for Zuul
(see https://review.opendev.org/819745 )

We should be able to configure a realm and federate with openstackid
and other providers as described in the opendev auth spec.  However,
I am unable to test federation with openstackid due its inability to
configure an oauth app at "localhost".  Therefore, we will need an
actual deployed system to test it.  This should allow us to do so.

It will also allow use to connect realms to the newly available
Zuul admin api on opendev.

It should be possible to configure the realm the way we want, then
export its configuration into a JSON file and then have our playbooks
or the docker-compose file import it.  That would allow us to drive
change to the configuration of the system through code review.  Because
of the above limitation with openstackid, I think we should regard the
current implementation as experimental.  Once we have a realm
configuration that we like (which we will create using the GUI), we
can chose to either continue to maintain the config with the GUI and
appropriate file backups, or switch to a gitops model based on an
export.

My understanding is that all the data (realms configuration and session)
are kept in an H2 database.  This is probably sufficient for now and even
production use with Zuul, but we should probably switch to mariadb before
any heavy (eg gerrit, etc) production use.

This is a partial implementation of https://docs.opendev.org/opendev/infra-specs/latest/specs/central-auth.html

We can re-deploy with a new domain when it exists.

Change-Id: I2e069b1b220dbd3e0a5754ac094c2b296c141753
Co-Authored-By: Matthieu Huin <mhuin@redhat.com>
2021-12-03 14:17:23 -08:00
Zuul
28243caa7f Merge "Adjust RefStack build for osf->openinfra rename" 2021-11-08 02:20:52 +00:00
Ian Wienand
26d955f344 reprepro: add note on removing components
Change-Id: Ia50861042bb159a9e351321b2503f193eca4e576
2021-10-29 18:04:42 +11:00
Jeremy Stanley
738f42760a Update artifact signing key management process
Now that the SKS keyserver network is no more, and there's no
convenient way to share third-party key signatures, we need to
adjust our key management and rollover process accordingly.

Change-Id: I7008706aae06b6e4a16db2dd85a8c7f91530cd50
2021-10-26 19:41:28 +00:00
Jeremy Stanley
e9f281d3b8 Adjust RefStack build for osf->openinfra rename
All the osf/ namespace Git repositories have moved into a new and
more appropriate openinfra/ namespace, so make the necessary
adjustments to RefStack's image build and operations document.

Change-Id: I01c8d153321a617fbc78c2d3c99102185b03243d
Depends-On: https://review.opendev.org/808479
2021-10-26 18:00:02 +00:00
Clark Boylan
f8b1d914aa Document Zuul's SIGUSR2 handler
This is more zuul debugging documentation.

Change-Id: I5298f62658cd68f2bd19ec02fb2c1970d855bf84
2021-10-22 13:03:23 -07:00
Dr. Jens Harbott
6961f380d1 Fixup some details in the zuul doc
Mostly just formatting and punctuation, plus some outdated bits.

Signed-off-by: Dr. Jens Harbott <harbott@osism.tech>
Change-Id: I641beb5d65f87173d50c74a4e1f0dba48d006231
2021-10-22 10:05:20 +02:00
Clark Boylan
2f7089d33e Make logging zuul restarts less optional
This is followon to feedback for earlier docs updates. Basically we
should always log these restarts so make that more clear that it isn't
optional.

Change-Id: Ib0fa05b2075d6c82199e6e043724aeedaf04e49c
2021-10-21 13:24:28 -07:00
Clark Boylan
f18e575a50 Update zuul secrets decryption docs
Zuul has changed has it stores secret keys and they are in zookeeper
now. This means our old docs on decrypting things are no longer correct.
Update them with a new set of instructions that matches the modern
setup.

Change-Id: I7484a8c02e005fadc41e22a4158b3dcb8434ec5d
2021-10-21 10:39:47 -07:00
Clark Boylan
a6d4d81ee2 Add zuul debugging documentation
Try to provide some hints for debugging unexpected zuul behaviors in our
documentation.

Change-Id: I937df9d8d71ae4984991aa9f327dd1351d539284
2021-10-21 10:39:47 -07:00
Clark Boylan
7eff5b5af2 Update zuul restart documentation
It was recently pointed out that our restart process for zuul is a bit
stale. Document the new modern process that deals with ansible playbooks
and docker containers.

Change-Id: I52812e87ed73e6ed538f94a86c1b62ce3de57c37
2021-10-21 10:39:42 -07:00
Clark Boylan
dce8b2b4a6 Rename Gerrit Non-Interactive Users to Service Users
This is just a documentation update but reflect the change upstream
Gerrit made in versions 3.3 renaming this group.

Change-Id: I5458afd2683c2a7c4616f4894884e3d3ce03bbaf
2021-10-11 08:53:59 -07:00
Jeremy Stanley
7685bf0708 Update management documentation for ptgbot service
Since ptgbot has updated config management and deployment
orchestration now, update our operational docs to reflect that.

Change-Id: Iad4eb23616ac8ad44d8456268dca730a9754acce
2021-10-07 19:34:16 +00:00
Ian Wienand
1d5f5a7657 docs: use logo from assets
Symlink the docs logo to the canonical assets location.  It looks like
it does the sensible thing and de-references the source symlink when
building, as doc/build/html/_static/opendev.svg ends up as the actual
file, not a symlink.

Change-Id: I4409c8e20601bdcb9e387d028b5df13c90d1ffa0
2021-09-17 12:35:12 +10:00
Jeremy Stanley
2fbf6d9e7a Stop managing OpenStackID servers
The Open Infrastructure Foundation's developers who maintain the
OpenStackID software are taking over management of the site itself,
and have deployed it on new servers. DNS records have already been
updated to the new IP address, so it's time to clean up our end in
preparation for deleting the old servers we've been running.

OpenStackID is still used by some services we run, like RefStack and
Zanata, and we're still hosting the OpenStackID Git repository and
documentation, so this does not get rid of all references to it.

Change-Id: I1d625d5204f1e9e3a85ba9605465f6ebb9433021
2021-08-31 19:53:13 +00:00
Clark Boylan
87a67c7656 Update our project rename docs
This update captures that we host projects outside of openstack and
intend for projects like openstack or others to do some steps on their
own. We also update this to reflect chagnes in the configuration
management and deployment tooling that we use today.

Change-Id: I0bc0ce335fd90e6187253e18007361a133a8f30c
2021-08-13 13:33:48 -07:00
Zuul
8adc5a183d Merge "gerrit docs : remove old database docs/update duplicate account info" 2021-08-11 23:15:33 +00:00
Ian Wienand
d4ba30251b gerrit docs : remove old database docs/update duplicate account info
A lot of the current sections here talk about modify the Gerrit
database that no longer exists.  Remove these.

Update the section on duplicate accounts to handle removing the second
account via NoteDB and the API.

Change-Id: I2139ff33d87bf42e4453f6e7252fcc427594967a
2021-08-12 08:37:34 +10:00
Ian Wienand
3d63b3b8a4 borg-backup-server: log prune output to file
This saves prune output to a log file automatically.  Add a bit more
info on the process too.

Change-Id: I2607ddbc313dfebc122609af78bb5eed63906f6b
2021-08-04 14:47:50 +10:00