ReviewBoard Infrastructure SOP

Review Board is a powerful web-based code review tool that offers developers an easy way to handle code reviews. It scales well from small projects to large companies and offers a variety of tools to take much of the stress and time out of the code review process.

Contact Information

Owner: Fedora Infrastructure Team

Contact: #fedora-admin, sysadmin-main, sysadmin-hosted

Location: ServerBeach

Servers: hosted[1-2]

Purpose: Provide our fedorahosted users a way to review code.

File Locations

hosted[1-2]:/srv/reviewboard/conf/settings_local.py - Main config file
hosted[1-2]:/etc/httpd/conf.d/fedorahosted.org/reviewboard.conf - ReviewBoard
https://fedorahosted.org/reviewboard/

Troubleshooting and Resolution

Restarting

After an update, to restart reviewboard just restart apache. Doing a service httpd stop and then a service httpd start should do it.

Create a new repository in ReviewBoard

Creating a new git repository

1. Enter the admin interface. If you have admin privilege, a link will be visible in the upper-right corner of the dashboard.
2. In the admin dashboard click "Add" next to "Repositories"
3. For the name, enter the Fedora Hosted project short name. (e.g. if the project is https://fedorahosted.org/sssd, then the repository name should be sssd)
4. "Show this repository" must be checked.
5. Hosting service is "Custom"
6. Repository type is Bazaar
7. Path should be /srv/git/project_short_name.git (e.g. /srv/git/sssd.git)
8. Mirror path should be git://git.fedorahosted.org/git/project_short_name.git
   • Mirror path is used by client tools such as post-review to determine to which repository a submission belongs
9. Username and Password should both be left blank
10. The bug tracker URL may vary from project to project, but if they are using the Fedora Hosted Trac bugtracker, it should be
    • Type: Trac
    • Bug Tracker URL: https://fedorahosted.org/project_short_name (e.g. https://fedorahosted.org/sssd)
11. Do not set a Bug Tracker URL

Create a default reviewer for a repository

Reviews should be sent to the project development mailing list unless otherwise requested.

1. Enter the admin interface. If you have admin privilege, a link will be visible in the upper-right corner of the dashboard.
2. In the admin dashboard click "Add" next to "Review Groups"
3. Enter the following values:
   • Name: The project short name
   • Display Name: project_short_name Review Group
   • Mailing List: Development discussion list for the project
4. Do not select any users