Dockerized reviewboard. This container follows Docker's best practices, and DOES NOT include sshd, supervisor, apache2, or any other services except the reviewboard itself which is run with uwsgi.

The requirements are PostgreSQL and memcached, you can use either dockersized versions of them, or external ones, e.g. installed on the host machine, or even third-party machines.

make build  # if you want to build the image yourself
make run

docker-compose up

Then go to http://127.0.0.1:8000/ (or your docker host) and login as admin:admin

Alternatively, here are the commands to do the same manually.

# Install postgres
docker run -d --name rb-postgres -e POSTGRES_USER=reviewboard postgres:alpine

# Install memcached
docker run --name rb-memcached -d -p 11211 memcached:alpine

# Run reviewboard with a named volume to hold your site's data
docker run -it -v reviewboard-site:/var/www/ --link rb-postgres:pg --link rb-memcached:memcached -p 8000:8000 ikatson/reviewboard

After that, go the url, e.g. http://localhost:8000/, login as admin:admin, change the admin password, and change the location of your SMTP server so that the reviewboard can send emails. You are all set!

For details, read below.

If you want to build this yourself, just run this:

docker build -t 'ikatson/reviewboard' git://github.com/ikatson/docker-reviewboard.git

You can install postgres either into a docker container, or whereever else.

1. Example: install postgres into a docker container, and create a database for reviewboard.

    docker run -d --name rb-postgres -e POSTGRES_USER=reviewboard postgres:alpine
   

2. Example: install postgres into the host machine, example given for a Debian/Ubuntu based distribution.

    apt-get install postgresql-server
   
    # Uncomment this to make postgres listen on all addresses.
    # echo "listen_addresses = '*'" >> /etc/postgresql/VERSION/postgresql.conf
    # invoke-rc.d postgresql restart
    sudo -u postgres createuser reviewboard
    sudo -u postgres createdb reviewboard -O reviewboard
    sudo -u postgres psql -c "alter user reviewboard set password to 'SOME_PASSWORD'"
   

1. Example: install into a docker container

    docker run --name memcached -d -p 11211 memcached:alpine
   

2. Example: install locally on Debian/Ubuntu.

    apt-get install memcached
   

   Don't forget to make it listen on needed addresses by editing /etc/memcached.conf, but be careful not to open memcached for the whole world.

This container has one volume mount-point:

• /var/www/ - The path where the reviewboard site resides, this includes it's ssh keys and uploaded media.

The container accepts the following environment variables:

• PGHOST - the postgres host. Defaults to the value of PG_PORT_5432_TCP_ADDR, provided by the pg linked container.
• PGPORT - the postgres port. Defaults to the value of PG_PORT_5432_TCP_PORT, provided by the pg linked container, or 5432, if it's empty.
• PGUSER - the postgres user. Defaults to reviewboard.
• PGDB - the postgres database. Defaults to reviewboard.
• PGPASSWORD - the postgres password. Defaults to reviewboard.
• MEMCACHED - memcache address in format host:port. Defaults to the value from linked memcached container.
• DOMAIN - defaults to localhost.
• DEBUG - if set, the django server will be launched in debug mode.
• SITE_ROOT - the path of the site, relative to the domain. This should start and end with a /. For example, /reviews/. Defaults to /.

Also, uwsgi accepts environment prefixed with UWSGI_ for it's configuration E.g. -e UWSGI_PROCESSES=10 will create 10 reviewboard processes.

docker run -it -v reviewboard-site:/var/www/ --link rb-postgres:pg --link memcached:memcached -p 8000:8000 ikatson/reviewboard

DOCKER_HOST_IP=$( ip addr | grep 'inet 172.1' | awk '{print $2}' | sed 's/\/.*//')

docker run -it -v reviewboard-site:/var/www/ -p 8000:8080 -e PGHOST="$DOCKER_HOST_IP" -e PGPASSWORD=123 -e PGUSER=reviewboard -e MEMCACHED="$DOCKER_HOST_IP":11211 ikatson/reviewboard

Now, go to the url, e.g. http://localhost:8000/, login as admin:admin and change the password. The reviewboard is almost ready to use!

You should also change SMTP settings, so that the reviewboard can send emails. A good way to go is to set this to docker host's internal IP address, usually, 172.17.42.1).

Don't forget to setup you mail agent to accept emails from docker.

For example, if you use postfix, you should change /etc/postfix/main.cf to contain something like the lines below:

mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128 172.17.0.0/16
inet_interfaces = 127.0.0.1,172.17.42.1

Upgrading to a new ReviewBoard version is as simple as pulling and running the latest image (or use a specific tag). The upgrade will be detected at runtime and rb-site upgrade will be executed. See: https://www.reviewboard.org/docs/manual/dev/admin/upgrading/upgrading-sites