Dockerize a Rails 5, Postgres, Redis, Sidekiq and Action Cable Application with Docker Compose
Learn how to install and use Docker to run a Rails 5, Postgres, Redis, Sidekiq and Action Cable app in development with Docker Compose.
There is an updated post for Rails 7+
It includes a new updated project repo too!Read the updated post
After this tutorial, you’ll understand what the benefits of using Docker are and will be able to:
- Install Docker on all major platforms in 5 minutes or less
- Run an example Rails 5+ app that uses a bunch of best practices
- Know how to write a Dockerfile
- Run multiple Docker containers with Docker Compose
Also, there’s a free email course to learn a bit about Docker at the bottom of this post.
What Is Docker and Why Is It Useful?
Docker allows you to package up an application or service with all of its dependencies into a standardized unit. This unit is typically labeled as a Docker image.
Everything the application needs to run is included. The Docker image contains the code, runtime, system libraries and anything else you would install on a server to make it run if you weren’t using Docker.
To get a better idea of how Docker will affect you on a day to day basis as a software developer I highly recommend you read one of my previous blog posts which will save you from years of turmoil by using Docker.
The code base we’ll be working with is compatible with Docker 17.06 and Docker Compose 1.14, and I’m sure it will continue to work with future versions of Docker, so feel free to install the latest versions of both.
Update: Everything works just fine with Docker v18.04 and Docker Compose 1.21!
This guide expects you to have Docker already installed. If you’re at ground 0 then you may want to sign up for the free Docker email course at the bottom of this post, because it covers a myriad of ways to install Docker on Mac, Windows and Linux.
Otherwise, feel free to check out Docker’s documentation on installing Docker if you want to get going right now. To help you out, I’ve also written a comparison guide on Docker for Mac / Windows vs Docker Toolbox.
Ensure Docker and Docker Compose Are Working
Before continuing on you should see what I see, or something very similar:
docker --version > Docker version 17.06.0-ce, build 02c1d87 docker-compose --version > docker-compose version 1.14.0, build c7bdf9e
Creating the Rails Application
The focus of this blog post is on Dockerizing a Rails application that has a number of moving parts. We could use
rails new to create a new project and build it up, but it would be faster just to use a pre-made application instead.
We’re going to be using a base application provided by orats, which is an open source tool to generate opinionated Rails projects.
If you want to learn more about what this base app has to offer, then I recommend reading the orats README file for that. This article will cover just the Docker specific side of things.
What About Existing Rails Applications?
This article is very general and you can apply everything you’re about to read to your own application instead of the orats example application.
Nothing you’re about to read is specific to orats at all. You’ll just need to create a few files since you won’t have them beforehand.
Since you’re very likely a Ruby developer, you have Ruby installed on your work station so installation is as simple as
gem install orats.
Generate a New Project
# Feel free to generate the project anywhere you want. orats new /tmp/my_dockerized_app
Open the Project in Your Favorite Code Editor
# Move into the project's directory cd /tmp/my_dockerized_app # Open the project with your favorite editor (mine is Sublime) subl .
Feel free to use whatever editor you want, but if you like Sublime Text 3 and you want to configure it for Rails, Docker and more then check out my post on 25 Sublime Text 3 Packages for Polyglot Programmers.
Dockerize the Rails Application
There’s a few things we need to do to Dockerize the application.
In order for logs to function properly, Docker expects your application or process to log to STDOUT. This is a very good idea because the concept of managing log files will now be de-coupled from your Rails application.
You can choose to have Docker write those log entries to syslog or another local service running on your server, or you can ferry the log output over to a third party service such as Loggly.
In either case, you need to make a small adjustment to your Rails app:
# config/application.rb : Lines 21-24 logger = ActiveSupport::Logger.new(STDOUT) logger.formatter = config.log_formatter config.log_tags = [:subdomain, :uuid] config.logger = ActiveSupport::TaggedLogging.new(logger)
In the orats base project, I’ve decided to set up logging in the
application.rb file because it will be common to all environments.
We’re just setting Rails up to log to STDOUT and then we also set up a custom formatter to include both the subdomain and uuid in each log entry.
I like doing this because it makes filtering logs very simple – especially when your application grows in size and has many moving parts.
Docker Specific Files
The root of the project has a few files that are related to Docker:
nick@oriath:/tmp/my_dockerized_app ⚡ ls -la -rw-rw-r-- 1 nick nick 3507 Jul 7 10:50 .env -rw-rw-r-- 1 nick nick 1032 Jul 7 10:50 docker-compose.yml -rw-rw-r-- 1 nick nick 4353 Jul 7 10:50 Dockerfile -rw-rw-r-- 1 nick nick 49 Jul 7 10:50 .dockerignore
The only file that’s necessary to add is the
Dockerfile but you’ll find that most web applications that are Docker-enabled will have the others.
Let’s start off with the
Dockerfile because to talk about the other files will require having a little bit of knowledge about how Docker images get built.
You can think of this file as your Docker image blueprint or recipe. When you run the
docker build command it will execute each line from top to bottom.
It’s going to run all of these commands in the context of the Docker image.
To get a better understanding of this file, then check out my shiny new Dive Into Docker course.
FROM ruby:2.5-alpine RUN apk update && apk add build-base nodejs postgresql-dev RUN mkdir /app WORKDIR /app COPY Gemfile Gemfile.lock ./ RUN bundle install --binstubs COPY . . LABEL maintainer="Nick Janetakis <email@example.com>" CMD puma -C config/puma.rb
At this point we could build the image and you’d be able to access the Rails app, but let’s avoid doing that for now.
Let’s first look at the next file which is the
.git .dockerignore .byebug_history log/* tmp/*
When we copied in all of the files from our current directory into the Docker image with the
COPY . . command, it’s going to copy literally everything.
That’s not the best idea in the world because if your project is a git repo you’re going to have a TON of extra data. You should strive to have the smallest Docker images you can within reason.
.dockerignore file is very similar to a
.gitignore file. It lets you black list certain folders or files from being included.
Docker Compose is an official tool supplied by Docker. At its core, it’s a utility that lets you “compose” Docker commands and manage multiple containers in an easy way.
Let’s take a glance at the
version: '2' services: postgres: image: 'postgres:10.3-alpine' volumes: - 'postgres:/var/lib/postgresql/data' env_file: - '.env' redis: image: 'redis:4.0-alpine' command: redis-server --requirepass yourpassword volumes: - 'redis:/data' website: depends_on: - 'postgres' - 'redis' build: . ports: - '3000:3000' volumes: - '.:/app' env_file: - '.env' sidekiq: depends_on: - 'postgres' - 'redis' build: . command: sidekiq -C config/sidekiq.yml.erb volumes: - '.:/app' env_file: - '.env' cable: depends_on: - 'redis' build: . command: puma -p 28080 cable/config.ru ports: - '28080:28080' volumes: - '.:/app' env_file: - '.env' volumes: redis: postgres:
Dive Into Docker covers everything in great detail if you want to see how all of this ties together. Often times knowing the “why” is more important than seeing how it’s done. That is what enables you to apply things on your own.
This file isn’t technically part of Docker, but it’s partly used by Docker Compose and the Rails application.
By default Docker Compose will look for an
.env file in the same directory as your
We can set various environment variables here, and you can even add your custom environment variables here too if your application uses ENV variables.
By setting the
my_dockerized_app, Docker Compose will automatically prefix our Docker images, containers, volumes and networks with
It just so happens that Docker Compose will strip underscores from the name.
There’s plenty of other values in this
.env file but most of them are custom to the Rails application. We’ll go over a few Docker related values in a bit.
Run the Ruby on Rails Application
You can run everything by typing:
docker-compose up --build. Docker Compose has many different sub-commands and flags. You’ll definitely want to check them out on your own.
up command finishes, open up a new terminal tab and check out what was created on your behalf.
mydockerizedapp_cable latest ... 392 MB mydockerizedapp_sidekiq latest ... 392 MB mydockerizedapp_website latest ... 392 MB postgres 10.3-alpine ... 39.5 MB redis 4.0-alpine ... 27.5 MB ruby 2.5-alpine ... 60.7 MB
Docker Compose automatically pulled down Redis and Ruby for you, and then built the website, sidekiq and cable images for you.
Name State Ports ------------------------------------------------------------------- mydockerizedapp_cable_1 ... Up 0.0.0.0:28080->28080/tcp mydockerizedapp_postgres_1 ... Up 5432/tcp mydockerizedapp_redis_1 ... Up 6379/tcp mydockerizedapp_sidekiq_1 ... Up mydockerizedapp_website_1 ... Up 0.0.0.0:3000->3000/tcp
Docker Compose automatically named the containers for you, and it appended a
_1 because it’s running 1 instance of the Docker image. Docker Compose supports scaling but that goes beyond the scope of this tutorial.
We can also see which ports the services are using and exposing.
There’s a lot more to go over but the above is enough to get rolling.
Viewing the Site
If you installed Docker through the Docker Toolbox then you’ll need to make 3 quick changes to the
.env file. If you’re running Docker natively then you can access
http://localhost:3000 right now.
Docker Toolbox users need to make 3 changes to the
# Open the .env file and find these values: ACTION_MAILER_HOST=localhost:3000 ACTION_CABLE_FRONTEND_URL=ws://localhost:28080 ACTION_CABLE_ALLOWED_REQUEST_ORIGINS=http:\/\/localhost* # Replace `localhost` with your Docker Machine IP address: ACTION_MAILER_HOST=192.168.99.100:3000 ACTION_CABLE_FRONTEND_URL=ws://192.168.99.100:28080 ACTION_CABLE_ALLOWED_REQUEST_ORIGINS=http:\/\/192.168.99.100*
Toolbox users need to change a few instances of
192.168.99.100 or whatever your Docker Machine IP address is. You can determine your IP by running
docker-machine ip from a Docker-enabled terminal.
This is because you don’t have Docker running natively on your system. It also means you’ll need to access
http://192.168.99.100:3000 in your browser.
At this point you’ll notice that it throws an error saying the database does not exist. No worries, that’s expected right? We haven’t reset our database yet.
Interacting With the Rails Application
This section of the blog post will serve 2 purposes. It will show you how to run Rails commands through Docker, and also shows you how to initialize a Rails database.
Run both of the commands below in a new Docker-enabled terminal tab
Reset the database
docker-compose exec --user "$(id -u):$(id -g)" website rails db:reset
- If you’re on OSX or Windows, do not include the
Migrate the database
docker-compose exec --user "$(id -u):$(id -g)" website rails db:migrate
- If you’re on OSX or Windows, do not include the
What’s going on with the above commands?
Docker Compose has an
exec command which lets you execute commands on an already running container. We’re running commands on the
--user "$(id -u):$(id -g)" flag ensures that any files being generated by the
exec command end up being owned by your user rather than root.
A Live Development Environment
Since we have volumes set up in
docker-compose.yml you’ll be able to actively develop your application as if it were running natively on your OS.
Try going to
app/views/pages/home.html.erb, then make a change to the file. All you have to do is save the file and reload your browser to see the changes.
Shutting Things Down
You’ll want to goto your Docker Compose terminal tab and press
CTRL+C. Then for good measure, type
docker-compose stop. Sometimes Compose bugs out and won’t stop all of your containers automatically.
Docker is awesome. Now you can run your projects on other platforms without having to worry about dependencies and platform specific gotchas.
You can even deploy your projects to production with minimal fuss.
If you’re ready to master Docker, then check out the Dive Into Docker course.