メインコンテンツへスキップ
見出し画像

【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 --install

    Rubyやネイティブ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 ripgrep

    Railsはファイルが多いので、`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 -v

    Apple Silicon環境では `--with-openssl-dir` を指定しないと `openssl` が見つからないことがあります。


    2-3. BundlerとRails

    Railsを導入します。

    gem update --system
    gem install bundler -N
    gem install rails -N
    rails -v

    3️⃣ PostgreSQLの準備

    3-1. ロールとDB作成

    Postgresqlへ接続します。

    psql -U postgres -h 127.0.0.1

    psqlに入ったら:
    以下のコマンドでユーザを作成して権限を付与します。

    CREATE ROLE shopuser WITH LOGIN PASSWORD 'shop-pass';
    CREATE DATABASE shopmini_development OWNER shopuser;
    GRANT ALL PRIVILEGES ON DATABASE shopmini_development TO shopuser;
    \q

    4️⃣ Railsプロジェクトを作成

    Railsプロジェクトを作成します。

    rails new shopmini -d postgresql
    cd shopmini

    5️⃣ DB設定を.envで管理する

    5-1. dotenv-railsを導入

    .envファイルが使えるようにモジュールを導入します。
    ※設定ファイルにベタ書きはしないようにします。

    bundle add dotenv-rails

    5-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 s

    6-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 }
    end

    7️⃣ MVCの関係を体で理解

    画像

    Railsは 「1アクション1リクエスト」
    → Controllerが中心で、ViewとModelを橋渡しする構造です。


    8️⃣ よく使うコマンド

    画像

    9️⃣ 次回予告

    次回は――
    「CSV取り込みで“文字数とバイト数”の違いを可視化」。
    UIとCSVで制限が異なる“ズレ”を、ログで再現します。


    💡まとめ

    • `.env`を使えば、毎回`export`しなくてOK

    • Railsは `rails new → scaffold → migrate` の3ステップでCRUDが完成

    • MVCの流れを理解すれば、修正ポイントが見えてくる(MTVとの違いはまた今度)


    では
    また


    過去の記事


     
     
    インフラエンジニアとして実務メモを、 写真作家として写真物語を、 童話作家として物語を書いています。 写真作品は、ポートフォリオサイトとしてまとめていく予定です。

    あなたへのおすすめ