
【IT】Rails導入から最小CRUDまで(1)〜MacBook×PostgreSQLで動く環境を作る
皆さん、こんにちは
「もう何年もRails触ってない…」
「でも業務アプリの保守をする以上、コードを読めるようになりたい」
そんな“インフラ寄りエンジニア”のリブート学習を想定した、
Rails思い出し講座の第1回です。
※Homebrew、Ruby、Rails等の導入については、過去記事にも掲載してありますが、本記事だけで完結するように再掲載しております。
🧭 ゴール
Railsをゼロから導入し、PostgreSQLと接続する
Shop管理ミニアプリ(CRUD)を作成
Railsの基本構造(MVC)を体で再確認
`.env` にDB接続情報をまとめ、毎回export不要にする
1️⃣ 開発環境の準備
1-1. Xcodeコマンドラインツール
xcode-select --installRubyやネイティブGemをビルドするための基本ツールです。
1-2. Homebrew(パッケージ管理)
以下のコマンドで導入します。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
eval "$(/opt/homebrew/bin/brew shellenv)".bash_profileへの記載例です。
.bash_profile
# Homebrew
eval "$(/opt/homebrew/bin/brew shellenv)"
export LDFLAGS="-L/opt/homebrew/opt/zlib/lib"
export CPPFLAGS="-I/opt/homebrew/opt/zlib/include"
export PKG_CONFIG_PATH="/opt/homebrew/opt/zlib/lib/pkgconfig"1-3. ripgrep(ソース検索用)
brew install ripgrepRailsはファイルが多いので、`rg`で高速検索できると効率が一気に上がります。
2️⃣ Ruby & Railsを入れる
2-1. rbenvでバージョン管理
バージョン管理のモジュールを導入します。
brew install rbenv ruby-build openssl@3 readline libyaml
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
eval "$(rbenv init -)".bash_profileへの記載例です。
.bash_profile
# rbenv
export PATH=~/.rbenv/bin:$PATH
eval "$(rbenv init -)"2-2. Rubyをインストール
今回は、現時点で最新を導入します。
OSに元々、入っているのは、2.x台とかなり古めです。
RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@3)" \
rbenv install 3.4.1
rbenv global 3.4.1
ruby -vApple Silicon環境では `--with-openssl-dir` を指定しないと `openssl` が見つからないことがあります。
2-3. BundlerとRails
Railsを導入します。
gem update --system
gem install bundler -N
gem install rails -N
rails -v3️⃣ PostgreSQLの準備
3-1. ロールとDB作成
Postgresqlへ接続します。
psql -U postgres -h 127.0.0.1psqlに入ったら:
以下のコマンドでユーザを作成して権限を付与します。
CREATE ROLE shopuser WITH LOGIN PASSWORD 'shop-pass';
CREATE DATABASE shopmini_development OWNER shopuser;
GRANT ALL PRIVILEGES ON DATABASE shopmini_development TO shopuser;
\q4️⃣ Railsプロジェクトを作成
Railsプロジェクトを作成します。
rails new shopmini -d postgresql
cd shopmini5️⃣ DB設定を.envで管理する
5-1. dotenv-railsを導入
.envファイルが使えるようにモジュールを導入します。
※設定ファイルにベタ書きはしないようにします。
bundle add dotenv-rails5-2. `.env`ファイルをプロジェクト直下に作成
DB接続等の環境変数をセットします。(パスワード等は適宜変更ください)
# .env
DB_NAME=shopmini_development
DB_USER=shopuser
DB_PASS=shop-pass
DB_HOST=127.0.0.1
DB_PORT=5432`.gitignore` に以下を追記しておくと安全です:
間違って.gitに上がらないように保険です。
.env
.env.*5-3. `config/database.yml`を環境変数対応に
先ほど、.envに記載した環境変数を読み込むように設定します。
(PostgreSQLを前提しております)
default: &default
adapter: postgresql
encoding: unicode
pool: 5
development:
<<: *default
database: <%= ENV.fetch("DB_NAME", "shopmini_development") %>
username: <%= ENV.fetch("DB_USER", "shopuser") %>
password: <%= ENV.fetch("DB_PASS", "shop-pass") %>
host: <%= ENV.fetch("DB_HOST", "127.0.0.1") %>
port: <%= ENV.fetch("DB_PORT", "5432") %>`.env` に設定した変数が、Rails起動時に自動で読み込まれます。
5-4. DB作成・起動確認
DBを初期作成して、Railsを起動します。
bin/rails db:prepare
bin/rails s`http://localhost:3000` にアクセスして
Railsのロゴが出れば成功です。

6️⃣ CRUDを作ってみよう
scaffold用いてCRUDを作成します。
bin/rails g scaffold Shop name:string introduce:text enabled:boolean
bin/rails db:migrate
bin/rails s6-1. 確認
ブラウザで `http://localhost:3000/shops`
→ 「New Shop」から登録・編集・削除ができれば完成!

6-2. シンプルなバリデーション追加
`app/models/shop.rb`
class Shop < ApplicationRecord
validates :name, presence: true, length: { maximum: 50 }
validates :introduce, length: { maximum: 255 }
end7️⃣ MVCの関係を体で理解

Railsは 「1アクション1リクエスト」
→ Controllerが中心で、ViewとModelを橋渡しする構造です。
8️⃣ よく使うコマンド

9️⃣ 次回予告
次回は――
「CSV取り込みで“文字数とバイト数”の違いを可視化」。
UIとCSVで制限が異なる“ズレ”を、ログで再現します。
💡まとめ
`.env`を使えば、毎回`export`しなくてOK
Railsは `rails new → scaffold → migrate` の3ステップでCRUDが完成
MVCの流れを理解すれば、修正ポイントが見えてくる(MTVとの違いはまた今度)
では
また