foodsoft/doc/SETUP_DOCKER.md

# Foodsoft on Docker

This document explains setting up and using Foodsoft with Docker.

## Requirements

* Docker (=> 1.5)
* Docker Compose (=> 1.1)
* Nothing more, no ruby, mysql, redis etc!

For installing instructions see https://docs.docker.com/installation/.
Docker runs on every modern linux kernel, but also with a little help on MacOS
and Windows!

## Setup

Create docker volume for mysql data:

    mkdir -p ~/.docker-volumes/foodsoft/mysql

Setup foodsoft development data: (This will take some time, containers needs
to be pulled from docker registry and a lot dependencies needs to be installed.)

    docker-compose run app rake foodsoft:setup_development

## Usage

Start containers (in foreground, stop them with `CTRL-C`)

    docker-compose up

Run a rails/rake command

    docker-compose run app rake db:migrate

Open a rails console

    docker-compose run app rails c

Setup the test database

    docker-compose run app rake db:setup RAILS_ENV=test DATABASE_URL=mysql2://root:secret@mysql/test

Run the tests

    docker-compose run app ./bin/test

Jump in a running container for debugging.

    docker exec -ti foodsoft_app_1 bash

## Notes

### Gemfile updates

This is bit tricky, as the gemfiles are stored in the container and so we have
to rebuild the container each time we change the Gemfile. To avoid installing
all the gems from scratch we can use this workaround:

```bash
docker-compose run app bundle update rails # Update Gemfile.lock file
docker ps -a # Look for the last exited container and grab the Container ID
docker commit -m "Updated rails" <Container ID> foodsoft_app
```

### Database configuration

To make this easier we use the environment variable `DATABASE_URL`
(and `TEST_DATABASE_URL` when using the testing script).