1.7 KiB
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:
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).