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 changes to a product's Gemfile, and setting a label.
• GitHub pull request monitoring
  • Label and comment on a PR when it becomes unmergeable.
  • Run Rubocop, haml-lint and yamllint against a PR diff and comment on any offenses found.

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 label1[, label2] Add one or more labels to an issue. Multiple labels should be comma-separated.

  Example: @miq-bot add_labels label1, label2

• remove_label label1[, label2] Remove one or more labels to an issue. Multiple labels should be comma-separated.

  Example: @miq-bot remove_label wontfix

• assign [@]user Assign the issue to the specified user. The leading @ for the user is optional. The user must be in the Assignees list.

  Example: @miq-bot assign @user

• unassign [@]user Unassign the issue or pull request to the specified user(s). The leading @ for the user is optional. The user(s) must be assigned to the issue or pull request and they must be comma separated.

  Example: @miq-bot unassign @user1[, @user2]

• add_reviewer [@]user Request for pull request review the specified user. The leading @ for the user is optional. The users must be separated by a comma and they must be in the Assignees list.

  Example: @miq-bot add_reviewer @user1[, @user2]

• remove_reviewer [@]user Remove a request for pull request review from the specified user. The leading @ for the user is optional. The user must be in the Assignees list.

  Example: @miq-bot remove_reviewer @user

• set_milestone milestone_name Set the specified milestone on the issue. Do not wrap the milestone in quotes.

  Example: @miq-bot set_milestone Sprint 27

• move_issue [organization_name/]repo_name Moves the issue to the specified repo. The bot will open a new issue with your original title and description and close the current one. Useful for reorganizing issues opened on the core ManageIQ/manageiq repo to a more appropriate project (a provider or other ManageIQ plugin).

  • This command is restricted to members of the organization containing the issue.
  • The repository being moved to must be under the same organization as the issue being moved.
  • You cannot move a pull request.

  Example: @miq-bot move_issue manageiq-providers-amazon

• close_issue Closes the issue.

  • This command is restricted to members of the organization containing the issue.
  • Restricted use on pull requests. Only the pull request author or a committer can close pull requests (who have access to close them directly anyway). This is intended.

  Example: @miq-bot close_issue

• cross_repo_test test_repos* [including include_repos*] Runs cross repo tests that include the current PR code base. A pull request will be created in the manageiq-cross_repo-tests repo where each of the test_repos will be a separate entry in the test matrix. Those tests will run in the context of all repos declared in test_repos + include_repos + the PR itself.

  • This command is restricted to members of the organization containing the issue.
  • Restricted use on pull requests. This doesn't make sense to use on issues since there is no code to run.

  Example: @miq-bot cross_repo_tests ManageIQ/manageiq#1234 including more_core_extensions@1234abcd

  Also accepts repository groups, e.g. /providers, /core, /all

  Example: `@miq-bot cross_repo_tests ManageIQ/manageiq#1234, /providers including more_core_extensions@1234abcd

Development

Prerequisites

• Ruby 2.2 with bundler
• Redis ~> 2.8.10
• Postgresql
• pip

Setup

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

2. Clone the miq_bot repo and add the upstream remote:

   git clone [email protected]:<your github handle>/miq_bot.git
   cd miq_bot
   git remote add upstream [email protected]:ManageIQ/miq_bot.git
   git fetch —-all
   

3. Install any dependencies:

   bundle install
   sudo pip install yamllint
   

4. 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.

5. Set up the databases:

   bundle exec rake db:setup
   

6. Create/fork a test repository and add it to the database (replace miq-test/sandbox with your test repository below). Note that the bot account you are using must have SSH keys defined correctly if you plan to use an SSH based URL, otherwise you should use an HTTPS based URL.

   bundle exec rails runner 'Repo.create_from_github!("miq-test/sandbox", "https://github.com/miq-test/sandbox.git")'
   

7. Create a custom Procfile for development. Any changes you make to this file won't be tracked.

   cp Procfile.tmpl Procfile
   

8. 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.

9. 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; See the section on enabling/disabling workers
   github_notification_monitor:
     included_repos: ["miq-test/sandbox"]

10. You should now be able to run foreman start to start the services listed in the Procfile.

11. See log/development.log and log/sidekiq.log to make sure things are starting.

12. 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.

Enabling and Disabling workers

By default, most workers are enabled for all repos (except for the MergeTargetTitler which is disabled for all repos), however if you would like to change which workers are enabled or disabled, the following configuration settings can be changed:

worker_a:  # Will run in all repos

worker_b:  # Will only run in the specified repos
  included_repos:
  - "org1/repo1"
  - "org2/repo2"

worker_c:  # Will run in all repos except the specified repos
  excluded_repos:
  - "org1/repo1"
  - "org2/repo2"

worker_d:  # Will raise an exception, since you should not specify both
  included_repos:
  - "org1/repo1"
  excluded_repos:
  - "org2/repo2"

worker_e:  # Effectively disables the worker
  included_repos: []