Tool:Jouncebot

Toolforge tools
jouncebot
Description	IRC bot for Deployments
Keywords	irc, python
Author(s)	Matt Walker, Bryan Davis
Maintainer(s)	(View all)
Source code	gitlab:toolforge-repos/jouncebot
License	GNU General Public License 2.0 or later
Issues	Open tasks · Report a bug

Jouncebot is a Python reminder bot for Wikimedia Deployments. It reads the deployments calendar and pokes people on IRC when their window opens.

It listens in these channels on Libera.chat:

#wikimedia-operations ^connect

Usage

Commands

jouncebot: help - Displays a list of available bot commands and their description.
jouncebot: now - Displays the details of on-going deployment event(s), or the time remaining until the next one.
jouncebot: next - Displays the details of the next deployment event(s) to begin.
jouncebot: nowandnext - Displays both the details of the on-going deploying and the next deployment.
jouncebot: refresh – Refresh the bot's cache of the Deployment calendar.

Installation

It runs from Toolforge under the "jouncebot" account.

Source code lives in GitLab.

Management

$ ssh login.toolforge.org
$ become jouncebot

Running the bot

# Start the bot
$ ./jouncebot/bin/jouncebot.sh start

# Stop the bot
$ ./jouncebot/bin/jouncebot.sh stop

# Restart the bot
$ ./jouncebot/bin/jouncebot.sh restart

# Check job status
$ ./jouncebot/bin/jouncebot.sh status

# Tail log files
$ ./jouncebot/bin/jouncebot.sh tail

# Update bot to latest version
$ ./jouncebot/bin/jouncebot.sh update
$ ./jouncebot/bin/jouncebot.sh restart

Configuration

jouncebot is configured using a YAML file located in $HOME/jouncebot/etc/jouncebot.yaml. See also the default config in jouncebot/etc/DefaultConfig.yaml