ManageIQ Bot

The ManageIQ bot is the ManageIQ team's helper to automate various developer problems.

Usage

Automatic tasks

Commit monitoring and reaction to commits
- Detection of Red Hat Bugzilla URLs in commit messages
  - in pull request branches, setting the BZ to ON_DEV if not already set.
  - in regular branches, writing the commit details to the BZ ticket.
- Detection of changes to a product's Gemfile, and setting a label.
GitHub pull request monitoring
- Comment on a PR when it becomes unmergeable.
- Run Rubocop and haml-lint against a PR diff and comment on any offenses found.
Travis monitoring
- Detecting stalled builds and automatically restarting them.

Requested tasks

The bot will react to direct messages in GitHub issues, performing actions on your behalf which would otherwise not be possible without commit rights to the repo. Just add a comment to any issue in a monitored repo, with each request on its own line, in the form @miq-bot command params. Available commands are below. Any command can also be pluralized, where sensible, or have the underscores replaced with hyphens.

add_label: Add one or more labels to an issue. Multiple labels should be comma-separated. e.g. @miq-bot add_label label1, label2, label3
remove_label (or rm_label): Remove one or more labels to an issue. Multiple labels should be comma-separated. e.g. @miq-bot remove_label label1, label2, label3
assign: Assign the issue to the specified user. The leading @ for the user is optional. The user must be in the organization, and must have publicized their membership in order to be assigned. e.g. @miq-bot assign @user
set_milestone: Set the specified milestone on the issue. Do not wrap the milestone in quotes. e.g. @miq-bot set_milestone Sprint 27

Development

Prerequisites

Ruby 2.2 with bundler
Redis ~> 2.8.10
Postgresql

Setup

Fork https://github.com/ManageIQ/miq_bot

Clone the miq_bot repo and add the upstream remote:

git clone git@github.com:<your github handle>/miq_bot.git
cd miq_bot
git remote add upstream git@github.com:ManageIQ/miq_bot.git
git fetch —-all

Install any gem dependencies:
```
bundle install
```
Create the database.yml file.
```
cp config/database.tmpl.yml config/database.yml
```
Edit the database.yml file, and change username and password for your PostgreSQL database.
Set up the databases:
```
bundle exec rake db:setup
```
Create/fork a test repository and add it to the database (replace miq-test/sandbox with your test repository below). Note that the url provided must use the http or https scheme:
```
bundle exec rails runner 'Repo.create_from_github!("miq-test/sandbox", "https://github.com/miq-test/sandbox.git")'
```
Create a custom Procfile for development. Any changes you make to this file won't be tracked.
```
cp Procfile.tmpl Procfile
```

Either start redis as a daemon or have foreman start it for you by adding this to the Procfile:

redis: redis-server /path/to/redis.conf  # change this to the redis.conf provided by your package manager.

Configure the bot settings. First copy the template:

cp config/settings.yml config/settings/development.local.yml

Then set to the following values:

# config/development.local.yml:

#   Try to use a test account, as the account in question uses notifications
#   and needs to read them and modify them.
github_credentials:
  username: "some-test-account"
  password: # account token goes here

# Optional; leave blank to disable
gem_changes_labeler:
  enabled_repos: ["miq-test/sandbox"]

# Optional; leave blank to disable
github_notification_monitor:
  repo_names: ["miq-test/sandbox"]

# Optional; leave blank to disable
travis_event:
  enabled_repos: ["miq-test/sandbox"]

You should now be able to run foreman start to start the services listed in the Procfile.
See log/development.log and log/sidekiq.log to make sure things are starting.
You should be able to open a new PR on the miq-test/sandbox repository with any rubocop problems, such as MixedCaseConstant = 1. Wait a few minutes and see if it comments on your PR.