Shiftstack Bugwatcher

A collection of scripts to assist us in triaging our bugs.

make build

pretriage

Usage:

./pretriage

Finds untriaged, unassigned Shiftstack bugs and assigns them to a team member.

Required environment variables:

• JIRA_TOKEN: a Jira API token of an account that can access the OCPBUGS project
• SLACK_HOOK: a Slack hook URL
• TEAM_MEMBERS_DICT is a JSON object in the form:

{
  "kerberos_id1": {
    "slack_id": "UG65473AM",
    "bz_id": "[email protected]",
    "components": ["component1"],
    "jira_name": "user1",
    "jira_components": ["component1/sub-component1"]
  },
  "kerberos_id2": {
    "slack_id": "UGF8B93HA",
    "bz_id": "[email protected]",
    "components": [],
    "jira_name": "user2",
    "jira_components": []
  }
}

Optional environment variable: TEAM_VACATION in the form:

[
  {
    "kerberos": "jdoe",
    "start": "2022-01-01",
    "end": "2022-01-15"
  },
  {
    "kerberos": "jdoe",
    "start": "2022-06-12",
    "end": "2022-06-15"
  }
]

Local testing

A local script will set the required environment variables for you if you provide a vault token.

export VAULT_TOKEN=$vault_token
make run-pretriage

triage

Usage:

./triage

Reminds assignees about the bugs assigned to them for triage.

Required environment variables:

• JIRA_TOKEN: a Jira API token of an account that can access the OCPBUGS project
• SLACK_HOOK: a Slack hook URL
• TEAM_MEMBERS_DICT is a JSON object in the form described [above][pretriage].

posttriage

Usage:

./posttriage

Resets the Triaged keyword on bugs that still need attention.

Required environment variables:

• JIRA_TOKEN: a Jira API token of an account that can access the OCPBUGS project

doctext

Usage:

./doctext

Finds resolved bugs lacking a doc text, and posts a reminder to Slack.

Required environment variables:

• JIRA_TOKEN: a Jira API token of an account that can access the OCPBUGS project
• SLACK_HOOK: a Slack hook URL
• TEAM_MEMBERS_DICT is a JSON object in the form: