Since ptgbot has updated config management and deployment
orchestration now, update our operational docs to reflect that.
Change-Id: Iad4eb23616ac8ad44d8456268dca730a9754acce
We're happy for teams to manage their individual IRC channel access
lists through our accessbot configuration if they want, so explain
the situations in which they might choose to add channel ops or
admins, and the differences between them.
Change-Id: I4ae4463fe5017176d2d93cbaac6820fe11350899
The IRC bot nick registration process had Freenode-specific examples
and references, so switch those to reflect we're now using OFTC.
Also the weechat command-line syntax was outdated and did not work
with newer versions of the client, so fix that.
Change-Id: I74b60e997b32cc51e8db6e5b7a76d6f281dfc211
The troubleshooting section of our IRC doc had examples specific to
Freenode, update those. Further, drop the bit about /etc/hosts on
eavesdrop, since OFTC offers an IPv4-only round-robin name we can
use directly in our meetbot configuration to work around the
TwistedPython+SSL+IPv6 DNS resolution bug without resorting to
hard-coding addresses on the server.
Change-Id: I7ac1542dcd0a4f088b8c475756338851994f5433
OFTC doesn't have a server-side remove command (I can't find
evidence that it even works on Freenode though I only bothered to
test on OFTC to confirm). Update this section of our IRC document
accordingly.
Change-Id: I6b7838327f0d4ea3ea8c3697fc784657bb2a64ff
Some syntax and available commands on OFTC differ from Freenode,
adjust them were necessary. In particular, setting the channel topic
through ChanServ isn't quite the same any longer.
Change-Id: Id24afc16f7f46476ef761132c9c9a7b491eda47f
In order to accommodate the different permissions model on OFTC,
some changes were made to accessbot and its data structures. Correct
our documentation to reflect that.
Change-Id: I7a2c4201507dff2640b1506b885126d458b063a4
There is no join forwarding in OFTC's network, so instead let's just
update channel topics and possibly set entry messages to let people
know when a channel has moved. In order to be considerate of the
network operators, remember to drop the old unused channel
registrations after a while.
Change-Id: Icbcc9b780ae3a2d1c19d2591158a9d36d0407582
We're moving to OFTC and this tries to capture the various types of
updates for bots and docs we'll need to do. I don't expect this to
be complete, but adds some good reminder for a few things we don't
want to miss.
Change-Id: I09f4c7aa1a2eb8cd167439d58ab4222f5e63a4b1
We've stopped using many of these, but we never got around to
removing them from lists.
Also, we should probably retire the repos.
Depends-On: https://review.opendev.org/717620
Depends-On: https://review.opendev.org/720527
Change-Id: I8e012c5bfa48d274dbd7f5484a9e75fee080cb5e
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
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
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
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
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
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
In order to demystify some of the initial setup around IRC nick
registration for new bots, start a new section in the IRC
documentation page for a recommended workflow and gotchas.
Change-Id: Ica9f24b725cc2d4425741b383f788a537992f80d
This installs the ptgbot Puppet module so it will run from the
eavesdrop.openstack.org server and generate its Web content there.
Include some rudimentary operational documentation.
Change-Id: I92ddbbb683dede2c325f70267bd5e26884a35c01
Depends-On: Idb1fc5273b67ab88e1c78578275969b04c781c7a
To make it easier to find in a pinch, the IRC channel banning
documentation is given its own subsection and rearranged to make the
fastest and easiest solution appear as the first documented example.
Change-Id: If4d00927c3ac55a74b6ed1059269dbe872f18079
As a persistent means of kick-banning users from a channel, you can
have Chanserv do the dirty work for you making your own nick less of
a target for retaliation.
Change-Id: Ia8dcd17c53ea8235598712d1d6b177770d9bd029
Freenode has a "blog" post of an FAQ about the channel registration
process, which may be more useful to newcomers than our abbreviated
recipe. Link it.
Change-Id: I8f67d1c6baac60f99740d11acae28b1557fb435c
Freenode has recently shuffled around their online documentation
without maintaining redirects from the old URLs, so update the link
to their channel guidelines accordingly.
Change-Id: I9bf3e697f3397f4c0490ab8ad5a72ebb8a385c99
We've moved the long list of channels for statusbot and meetbot (logging) into
the hiera/common.yaml file, updating the documentation accordingly.
Change-Id: I2337de6c82a24fabe0d428ba3a7f40c8d41a62c8
This adds the configuration bits to enable the #success command
in statusbot.
Depends-On: I66b577732d1fec271a42f9229a8b5af2e52a58f4
Change-Id: Id26fb1a9dc27874040d2f5dd05bf20140d07512b
Documentation points to gerribot but it does not mention about
accessbot while creating and setting IRC services for a given
project.
Change-Id: I974bff563e9142b050024023d8494da5826c3ef3
Location of our Puppet modules has changed now that they are split
from system-config, update documentation accordingly.
Change-Id: I4d4adc5d41f50dd92fbd642ac30f95c327a416b2
Freenode has added a +e permission that we need added to the
openstackinfra account as well, document this.
Change-Id: I28bf99119a5d7a906b27d43104b0fcd7c7c0ed42
Logging of meetings and channel is handled by the Supybot, update
documentation to explain both logging mechanisms and how to add
channel logging to the configuration.
Change-Id: I0e7f53f3699cc3352dbbe31379d4753d291a3c9d
We require channels to be registered and have the openstackinfra
account added to the access list before we'll add infra-managed
bots.
Moving this documentation to the beginning of the document and
giving them their own section in case we wish to have other
requirements in the future.
Also add link on stackforge.rst back to the IRC page.
Change-Id: Ic92f3935de19c4afef23f51257a189f2860796c2
Teams need to give openstackinfra access to founder status in their
channel in order for us to add bots, documenting this.
Change-Id: I2946dd5f1b7f54e322fe2843405651335815799f
