Docker deployment in Ruby on Rails

Introduction

Docker deployment helps you package your Rails app with everything it needs to run. This makes it easy to move and run your app anywhere without setup problems.

You want to share your Rails app with others who may have different computers.

You need to run your app on a server or cloud without installing Ruby or dependencies manually.

You want to keep your app environment consistent between development and production.

You want to test your app in a clean environment without affecting your computer.

You want to automate deployment steps for faster updates.

Syntax

Ruby on Rails

FROM ruby:3.2
WORKDIR /app
COPY Gemfile* ./
RUN bundle install
COPY . .
CMD ["rails", "server", "-b", "0.0.0.0"]

FROM sets the base image with Ruby installed.

WORKDIR sets the folder inside the container where commands run.

Examples

Basic Dockerfile to run a Rails server inside a container.

Ruby on Rails

FROM ruby:3.2
WORKDIR /app
COPY Gemfile* ./
RUN bundle install
COPY . .
CMD ["rails", "server", "-b", "0.0.0.0"]

Command to build the Docker image named myrailsapp from the current folder.

Ruby on Rails

docker build -t myrailsapp .

Run the container and map port 3000 inside the container to port 3000 on your computer.

Ruby on Rails

docker run -p 3000:3000 myrailsapp

Sample Program

This Dockerfile sets up a Rails app to run inside a container. It installs Ruby gems, copies your app code, exposes port 3000, and starts the Rails server so you can access it from your browser.

Ruby on Rails

FROM ruby:3.2

# Set working directory
WORKDIR /app

# Copy Gemfile and Gemfile.lock
COPY Gemfile Gemfile.lock ./

# Install gems
RUN bundle install

# Copy all app files
COPY . .

# Expose port 3000
EXPOSE 3000

# Start Rails server binding to all interfaces
CMD ["rails", "server", "-b", "0.0.0.0"]

Important Notes

Make sure your Gemfile.lock is present to speed up gem installation.

Use EXPOSE 3000 to document the port your app uses.

Binding Rails server to 0.0.0.0 allows access from outside the container.

Summary

Docker deployment packages your Rails app and its environment together.

Use a Dockerfile to define how your app runs inside a container.

Build and run your Docker image to test and deploy your app easily anywhere.

Practice

1. What is the main purpose of using Docker for deploying a Rails application?

easy

A. To package the app and its environment together for consistent deployment

B. To write Rails code faster

C. To replace the Rails framework

D. To automatically fix bugs in the app

Solution

1. Step 1: Understand Docker's role

   Docker packages the app with all dependencies so it runs the same everywhere.

2. Step 2: Compare options

   Options B, C, and D describe unrelated or incorrect uses of Docker.

3. Final Answer:

   To package the app and its environment together for consistent deployment -> Option A

4. Quick Check:

   Docker deployment = packaging app + environment [OK]

Hint: Docker bundles app + environment for consistent runs [OK]

Common Mistakes:

• Thinking Docker speeds up coding
• Confusing Docker with Rails framework
• Believing Docker fixes app bugs automatically

2. Which line correctly exposes port 3000 in a Dockerfile for a Rails app?

easy

A. EXPOSE port 3000

B. EXPOSE '3000'

C. EXPOSE:3000

D. EXPOSE 3000

Solution

1. Step 1: Recall Dockerfile syntax for exposing ports

   The correct syntax is simply EXPOSE followed by the port number without quotes or extra words.

2. Step 2: Evaluate options

   EXPOSE 3000 matches the correct syntax. Options A, B, and D have invalid syntax.

3. Final Answer:

   EXPOSE 3000 -> Option D

4. Quick Check:

   Expose port syntax = EXPOSE 3000 [OK]

Hint: Use EXPOSE followed by port number without quotes [OK]

Common Mistakes:

• Adding quotes around port number
• Writing extra words like 'port'
• Using colon instead of space

3. Given this Dockerfile snippet for a Rails app:

FROM ruby:3.1
WORKDIR /app
COPY . .
RUN bundle install
EXPOSE 3000
CMD ["rails", "server", "-b", "0.0.0.0"]

What happens when you run this container and visit http://localhost:3000 on your host machine?

medium

A. You can access the Rails app running inside the container

B. The app will not be accessible because the port is not exposed

C. The app will crash because of missing files

D. The server will bind only to localhost inside the container

Solution

1. Step 1: Analyze Dockerfile commands

   The Dockerfile exposes port 3000 and runs Rails server bound to 0.0.0.0, allowing external access.

2. Step 2: Understand port exposure and binding

   Exposing port 3000 and binding to 0.0.0.0 lets the host access the app via localhost:3000.

3. Final Answer:

   You can access the Rails app running inside the container -> Option A

4. Quick Check:

   Expose + bind 0.0.0.0 = accessible app [OK]

Hint: Bind Rails to 0.0.0.0 and expose port to access app [OK]

Common Mistakes:

• Thinking EXPOSE alone publishes port to host
• Binding server only to localhost inside container
• Assuming missing files cause crash without evidence

4. You wrote this Dockerfile for your Rails app:

FROM ruby:3.1
WORKDIR /app
COPY . .
RUN bundle install
EXPOSE 3000
CMD ["rails", "server"]

Why might your app not be accessible from your host machine at http://localhost:3000?

medium

A. Because the port 3000 is not exposed in the Dockerfile

B. Because the Rails server is not bound to 0.0.0.0, so it listens only inside the container

C. Because the WORKDIR is incorrect

D. Because bundle install was not run

Solution

1. Step 1: Check server binding in CMD

   The CMD runs 'rails server' without '-b 0.0.0.0', so it binds to localhost inside container only.

2. Step 2: Understand port exposure and binding

   Even though port 3000 is exposed, binding only to localhost prevents external access from host machine.

3. Final Answer:

   Because the Rails server is not bound to 0.0.0.0, so it listens only inside the container -> Option B

4. Quick Check:

   Missing bind 0.0.0.0 = no host access [OK]

Hint: Always bind Rails server to 0.0.0.0 for external access [OK]

Common Mistakes:

• Assuming EXPOSE publishes port to host automatically
• Thinking WORKDIR affects network access
• Believing bundle install affects accessibility

5. You want to deploy a Rails app with Docker and ensure the app reloads code changes during development inside the container. Which Dockerfile and command setup is best?

hard

A. Copy code once in Dockerfile and run: rails server without binding

B. Expose port 3000 but do not bind Rails server to 0.0.0.0

C. Use a volume to mount your app code and run: rails server -b 0.0.0.0

D. Run Rails server with rails server -b localhost and no volume

Solution

1. Step 1: Understand code reload needs

   For code changes to reflect immediately, the app code must be mounted as a volume, not copied once.

2. Step 2: Ensure external access

   Binding Rails server to 0.0.0.0 allows access from host machine.

3. Step 3: Evaluate options

   Use a volume to mount your app code and run: rails server -b 0.0.0.0 mounts code and binds correctly. Others miss volume or binding, causing no reload or no access.

4. Final Answer:

   Use a volume to mount your app code and run: rails server -b 0.0.0.0 -> Option C

5. Quick Check:

   Volume + bind 0.0.0.0 = live reload + access [OK]

Hint: Mount code volume and bind server to 0.0.0.0 for dev [OK]

Common Mistakes:

• Copying code only once, missing live reload
• Not binding server to 0.0.0.0
• Binding server to localhost disables host access