This tool is used by Mozilla release management to send emails to the Firefox developers. It will query the bugzilla.mozilla.org database and send emails to Mozilla developers and their managers (if Mozilla staff).

The tool will also notify release managers about potential issues in bugzilla and autofix some categories of issues.

The list of checkers is documented on the Mozilla wiki: https://wiki.mozilla.org/Release_Management/autonag

This package currently uses Mozilla's Bugzilla REST API, and optionally the Mozilla IAM phonebook (to access bug assignees' managers & Mozilla email addresses).

Installation

1. Check out the code:

   git clone git://github.com/mozilla/relman-auto-nag.git
   

2. (optional) Create your virtualenv using virtualenvwrapper:

   virtualenv -p python3 venv
   source venv/bin/activate
   

3. Install pip:

   easy_install pip
   

4. Install the dependencies for Python 3 too:

   pip3 install -r requirements.txt
   

To run it into production, you will need the full list of employees + managers.

Automated Nagging Script

Before running:

1. The LDAP + SMTP infos are used to send emails
2. Need to generate an API key from bugzilla admin ( https://bugzilla.mozilla.org/userprefs.cgi?tab=apikey )
3. Should generate an API key from Phabricator ( https://phabricator.services.mozilla.com/settings/user )
4. The IAM secrets are used to generate a dump of phonebook, which is required for some scripts (employees can request them by filing a bug in the SSO: Requests component )
5. The private entry contains URLs for private calendar in ICS format:

# in scripts/configs/config.json
{
  "ldap_username": "[email protected]",
  "ldap_password": "xxxxxxxxxxxxxx",
  "smtp_server": "smtp.xxx.xxx",
  "smtp_port": 314,
  "smtp_ssl": true,
  "bz_api_key": "xxxxxxxxxxxxxx",
  "phab_api_key": "xxxxxxxxxxxxxx",
  "iam_client_secret": "xxxxxxxxxxxxxx",
  "iam_client_id": "xxxxxxxxxxxxxx",
  "private":
  {
    "Core::General": "https://..."
  }
}

Do a dryrun::

python -m auto_nag.scripts.stalled -d

There is a ton of scripts in auto_nag/scripts/ so you should be able to find some good examples.

Setting up 'Round Robin' triage rotations

One use case for this tool is managing triage of multiple components across a team of multiple people.

To set up a new Round Robin rotation, a manager or team lead should create a Google Calendar with the rotation of triagers.

Then the administrators will need to create a configuration file:

# in scripts/configs/<name of rotation>_round_robin.json
{
    "fallback": "<Name of manager or lead>",
    "components":
    {
        "Product::Component": "default",
        "Product::Component": "default",
        …
    },
    "default":
    {
        "calendar": "private://<Name of calendar>"
    }
}

The person requesting the round robin schedule must provide the URL of the calendar's .ics file.

In the calendar, the summary of the events must be the full name (eventually prefixed with text between square brackets) of triage owner as it appears in Phonebook, e.g. [Gfx Triage] Foo Bar or just Foo Bar.

And then you just have to add an entry in auto_nag/scripts/config/tools.json in the round-robin section.

Once everything is set-up you can make a PR similar too https://github.com/mozilla/relman-auto-nag/pull/858/files

Running on a server

This needs to run on a private server because it will have login for smtp and bugzilla key so it can't currently be shared access.

Cronjob:

CRON_DIR=/path/to/repository
00 17  * * 2   cd $CRON_DIR ; ./runauto_nag_tuesday.sh  &> /tmp/autonag-tuesday.log
00 7   * * *   cd $CRON_DIR ; ./update_people.sh        &> /tmp/autonag-people.log
00 12  * * 1-5 cd $CRON_DIR ; ./runauto_nag_weekdays.sh &> /tmp/autonag-day.log
00 8   * * *   cd $CRON_DIR ; ./runauto_nag_daily.sh    &> /tmp/autonag-day.log
30 */1 * * *   cd $CRON_DIR ; ./runauto_nag_hourly.sh   &> /tmp/autonag-hour.log

We run hourly jobs at minute 30 past every hour to avoid overlap with daily jobs. For the people update script, sometimes it could be slow, thus we run it earlier to avoid overlapping with hourly and daily jobs.