docker-reviewboard

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.

Quickstart. Run dockerized reviewboard with all dockerized dependencies, and persistent data in docker containers.

Using Makefile

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

Using docker-compose

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

# Install memcached
docker run --name rb-memcached -d -p 11211 sylvainlasnier/memcached

# Create a data container for reviewboard with ssh credentials and media.
docker run -v /root/.ssh -v /media --name rb-data busybox true

# Run reviewboard
docker run -it --link rb-postgres:pg --link rb-memcached:memcached --volumes-from rb-data -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.

Build yourself if you want.

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

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

Dependencies

Install PostgreSQL

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
   

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'"
   

Install memcached

1. Example: install into a docker container

    docker run --name memcached -d -p 11211 sylvainlasnier/memcached
   

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.

Run reviewboard

This container has two volume mount-points:

• /root/.ssh - The default path to where reviewboard stores it's ssh keys.
• /media - The default path to where reviewboard stores 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.

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

Example. Run with dockerized postgres and memcached from above, expose on port 8000:

# Create a data container.
docker run -v /root/.ssh -v /media --name rb-data busybox true
docker run -it --link rb-postgres:pg --link memcached:memcached --volumes-from rb-data -p 8000:8000 ikatson/reviewboard

Example. Run with postgres and memcached installed on the host machine.

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

# Create a data container.
docker run -v /root/.ssh -v /media --name rb-data busybox true
docker run -it -p 8000:8080 --volumes-from rb-data -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!

Container SMTP settings.

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