Rubyの学習や開発を行う際に、毎回安定した環境をサクッと構築するためのテンプレート手順をまとめました。Dockerを使って環境構築を行う方法を、初心者の方にもわかりやすく解説しています。

✅ 目次

プロジェクト用ディレクトリの作成
Dockerfile・docker-compose.ymlの記述
Docker Desktopの起動
ターミナルでDockerを実行
コンテナ内へログイン
Rubyのバージョン確認
コマンド一覧（🇯🇵日本語訳つき）
ターミナルの表示状態の見分け方

1. プロジェクト用ディレクトリの作成

cd ~                         # ホームディレクトリに移動
mkdir ruby_playground       # プロジェクト用ディレクトリ作成
cd ruby_playground          # 作成したディレクトリに移動
touch Dockerfile            # Dockerfileを作成
touch docker-compose.yml    # docker-compose.ymlを作成

自分のホームに Ruby の作業部屋（ruby_playground）を作り、その中に「どう構成するか（Dockerfile）」と「どう起動するか（compose.yml）」の2つの設計図を配置します。

2. Dockerfile・docker-compose.ymlの記述

Dockerfile

FROM ruby:3.1.3
ENV LANG C.UTF-8
ENV TZ Asia/Tokyo
RUN apt-get update
WORKDIR /app

Ruby 3.1.3 をベースに、日本語対応・東京時間に設定し、作業ディレクトリ /app を指定した環境を構築します。

docker-compose.yml

version: '3'
services:
  ruby:
    build: .
    container_name: ruby_playground
    tty: true
    volumes:
      - type: bind
        source: ./
        target: /app

項目	意味・役割
version: '3'	Docker Composeのバージョン
services:	以下に使用するサービス（＝環境）を定義
ruby:	サービス名（`docker compose run ruby` などで使う）
build: .	現在のディレクトリにあるDockerfileで構築
container_name: ruby_playground	コンテナの名前を指定
tty: true	対話モードを有効にする設定
volumes:	ローカルとコンテナのフォルダを同期（bind）
source: ./	ローカルの作業ディレクトリ
target: /app	コンテナ内のマウント先

3. Docker Desktopの起動

アプリを起動するだけでOK。
※Dockerエンジンがバックグラウンドで動くようになります。

4. ターミナルでDockerを実行

docker compose build
docker compose up

コマンド	意味
`docker compose build`	Dockerfile をもとに環境を構築
`docker compose up`	docker-compose.yml をもとに環境を起動
`docker compose up --build`	再ビルドも含めて起動
`docker compose down`	起動中の環境を停止・削除（片付け）

5. コンテナ内へログイン

起動とは別の新しいターミナルを開き、以下を実行：

docker container exec -it ruby_playground bash

起動中の ruby_playground コンテナ内にログインし、bashで操作を行います。

なぜ「別のターミナル」でログインするの？

docker compose up はログを表示し続けるため、同じターミナルで他の作業ができなくなります。
そのため、別のターミナルを立ち上げて作業を行います。

6. Rubyのバージョン確認

ruby -v

出力例：

ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]

項目	意味
`ruby 3.1.3`	Rubyのバージョン
`p185`	パッチ番号
`2022-11-24`	リリース日
`[x86_64-linux]`	実行環境の種類

7. Ruby開発環境構築のコマンド × 日本語訳

コマンド	意味（わかりやすく言うと）
`cd ~`	ホームディレクトリに移動する
`mkdir ruby_playground`	Rubyの作業フォルダを作成する
`cd ruby_playground`	作業フォルダに入る
`touch Dockerfile`	Dockerの設計図ファイルを作成する
`touch docker-compose.yml`	起動設定ファイルを作成する
`code .`	VSCodeでこのフォルダを開く
`docker compose build`	環境を組み立てる（ビルド）
`docker compose up`	環境を起動する（エンジンON）
`docker container exec -it ruby_playground bash`	実行中の環境にログインして操作する
`ruby -v`	Rubyのバージョンを確認する

8. ターミナルの表示状態について

状態	例えるなら…	表示例
Macターミナル	工場の外で準備している人	`k@Macbook ~ %`
コンテナ内	工場の中で作業している人	`root@xxxxx:/app#`

🧩 補足
このテンプレートは学習用・開発初期のRuby環境として非常に便利です。
docker-compose.ymlやDockerfileの設定を調整することで、Railsや他のライブラリも柔軟に追加できます。

📝 参考
Docker公式ドキュメント

Qiitaの記事各種（初心者向けDocker環境構築）