docker_for_dev.md

Docker for Development

Source: Ruby on Whales: Dockerizing Ruby and Rails development.

Installation

• docker and docker-compose installed.

For MacOS just use official app.

• dip installed. Since our development docker-compose.yml is not located in the root (there is already a production one), using Docker without Dip wouldn't be a pleasure.

You can install dip as Ruby gem:

gem install dip

Provisioning

When using Dip it could be done with a single command:

dip provision

Running

dip rails s

Developing with Dip

Useful commands

# run rails console
dip rails c

# run rails server with debugging capabilities (i.e., `debugger` would work)
dip rails s

# or run the while web app (with all the dependencies)
dip up web

# run migrations
dip rails db:migrate

# pass env variables into application
dip VERSION=20100905201547 rails db:migrate:down

# simply launch bash within app directory (with dependencies up)
dip runner

# execute an arbitrary command via Bash
dip bash ls -al tmp/cache

# Additional commands

# update gems or packages
dip bundle install

# run psql console
dip psql

# run tests
# TIP: `dip rspec` is already auto prefixed with `RAILS_ENV=test`
dip rspec spec/path/to/single/test.rb:23

# shutdown all containers
dip down

Development Flows

Another way is to run dip <smth> for every interaction. If you prefer this way and use ZSH, you can reduce the typing by integrating dip into your session:

$ dip console | source /dev/stdin
# no `dip` prefix is required anymore!
$ rails c
Loading development environment (Rails 7.0.1)
pry>