Database setup for production in Ruby on Rails - Mini Project: Build & Apply

Database setup for production

📖 Scenario: You are preparing a Ruby on Rails application to run in a production environment. This means setting up the database configuration correctly so the app can connect to the production database server.

🎯 Goal: Build a Rails database configuration file config/database.yml with a production section that uses PostgreSQL with the correct settings.

📋 What You'll Learn

Create a production section in config/database.yml

Set the adapter to postgresql

Set the database name to myapp_production

Set the username to myapp_user

Set the password to securepass

Set the host to db.example.com

💡 Why This Matters

🌍 Real World

Rails apps need a production database config to connect to real databases when deployed.

💼 Career

Understanding how to configure production databases is essential for backend and full-stack developers working with Rails.

1

Create the production section in database.yml

In config/database.yml, create a production: section with indentation two spaces. Add the line adapter: postgresql under it.

Ruby on Rails

production:
  # Your code here

Hint

Remember YAML uses indentation with spaces. Use two spaces before adapter.

2

Add database name and username

Under the production: section, add the lines database: myapp_production and username: myapp_user with two spaces indentation.

Ruby on Rails

production:
  adapter: postgresql
  # Your code here

Hint

Keep the same indentation level for these keys as adapter.

3

Add password and host

Add the lines password: securepass and host: db.example.com under the production: section with two spaces indentation.

Ruby on Rails

production:
  adapter: postgresql
  database: myapp_production
  username: myapp_user
  # Your code here

Hint

Make sure the indentation matches the other keys.

4

Complete the production database configuration

Ensure the production: section in config/database.yml includes all these lines exactly with correct indentation: adapter: postgresql, database: myapp_production, username: myapp_user, password: securepass, and host: db.example.com.

Ruby on Rails

production:
  adapter: postgresql
  database: myapp_production
  username: myapp_user
  password: securepass
  host: db.example.com
# Verify your configuration is complete

Hint

Double-check all lines and indentation for correctness.

Practice

1. What file do you edit to configure your production database settings in a Rails app?

easy

A. config/initializers/database.rb

B. config/routes.rb

C. config/environments/production.rb

D. config/database.yml

Solution

1. Step 1: Identify the configuration file for databases

   Rails uses config/database.yml to set up database connections for all environments including production.

2. Step 2: Confirm production environment settings location

   The production database details like adapter, username, password, and host are specified inside config/database.yml under the production section.

3. Final Answer:

   config/database.yml -> Option D

4. Quick Check:

   Production DB config = config/database.yml [OK]

Hint: Production DB settings are always in database.yml [OK]

Common Mistakes:

• Confusing environment config files with database config
• Editing routes.rb for database settings
• Looking in initializers for DB config

2. Which command correctly sets up the production database in Rails?

easy

A. rails db:migrate RAILS_ENV=production

B. rails db:create RAILS_ENV=production

C. rails db:setup RAILS_ENV=production

D. rails db:seed RAILS_ENV=production

Solution

1. Step 1: Understand the purpose of each command

   db:create creates the database, db:migrate runs migrations, db:seed loads seed data, and db:setup does all three: create, migrate, and seed.

2. Step 2: Choose the command that fully prepares the production DB

   To fully prepare the production database, including creation, migration, and seeding, use rails db:setup RAILS_ENV=production.

3. Final Answer:

   rails db:setup RAILS_ENV=production -> Option C

4. Quick Check:

   Full DB setup = rails db:setup [OK]

Hint: Use db:setup to create, migrate, and seed at once [OK]

Common Mistakes:

• Using db:create alone without migrations
• Running db:migrate without creating DB first
• Forgetting to specify RAILS_ENV=production

3. Given this config/database.yml snippet for production:

production:
  adapter: postgresql
  encoding: unicode
  database: myapp_production
  pool: 5
  username: user123
  password: secret
  host: db.example.com

What will happen if you run rails db:setup RAILS_ENV=production?

medium

A. It creates the production database, runs migrations, and loads seed data using the given credentials.

B. It only creates the database but does not run migrations or seed data.

C. It throws an error because the host is not localhost.

D. It ignores the production section and uses development settings instead.

Solution

1. Step 1: Understand db:setup behavior with production config

   The command rails db:setup RAILS_ENV=production reads the production section in database.yml and uses those credentials to create the DB, run migrations, and seed data.

2. Step 2: Confirm host usage and environment selection

   Using a remote host like db.example.com is valid if accessible. The command will not default to development but use production as specified.

3. Final Answer:

   It creates the production database, runs migrations, and loads seed data using the given credentials. -> Option A

4. Quick Check:

   db:setup uses production config fully [OK]

Hint: db:setup uses production config fully, even remote hosts [OK]

Common Mistakes:

• Assuming db:setup only creates DB without migrations
• Thinking host must be localhost
• Forgetting to specify RAILS_ENV=production

4. You run rails db:setup RAILS_ENV=production but get a connection error. Which is the most likely cause?

medium

A. You ran the command without RAILS_ENV=production.

B. The config/database.yml production section has wrong credentials or unreachable host.

C. The production database already exists.

D. You forgot to run rails db:migrate first.

Solution

1. Step 1: Analyze connection error causes

   Connection errors usually mean the app cannot reach the database server or the credentials are invalid.

2. Step 2: Check command and environment usage

   Running rails db:setup creates and migrates the DB, so missing migrations or existing DB are unlikely causes of connection errors.

3. Final Answer:

   The config/database.yml production section has wrong credentials or unreachable host. -> Option B

4. Quick Check:

   Connection error = wrong credentials or host [OK]

Hint: Connection errors usually mean bad credentials or host [OK]

Common Mistakes:

• Assuming migrations cause connection errors
• Ignoring environment variable in command
• Thinking existing DB causes connection failure

5. You want to securely manage your production database credentials without hardcoding them in config/database.yml. Which approach is best practice?

hard

A. Use environment variables referenced in database.yml for username and password.

B. Store credentials in plain text inside database.yml but restrict file permissions.

C. Commit encrypted credentials directly in database.yml without decryption setup.

D. Remove username and password from database.yml and rely on default system user.

Solution

1. Step 1: Understand secure credential management

   Hardcoding sensitive info in files is risky. Using environment variables keeps secrets out of code and config files.

2. Step 2: Confirm best practice in Rails

   Rails supports referencing environment variables in database.yml like <%= ENV['DB_USERNAME'] %> for secure, flexible credential management.

3. Final Answer:

   Use environment variables referenced in database.yml for username and password. -> Option A

4. Quick Check:

   Env vars for DB credentials = best practice [OK]

Hint: Use ENV vars in database.yml to keep credentials safe [OK]

Common Mistakes:

• Hardcoding passwords in config files
• Committing encrypted data without decryption
• Relying on system defaults without credentials