1.2.1 開発環境

開発環境は、1人1人すべて異なります。なぜなら開発者は慣れてくるにつれて、自分の環境をカスタマイズするものだからです。開発環境を大別すると、テキストエディタやコマンドラインを組み合わせて使う環境と、IDE（統合開発環境）の2つに分けられます。

クラウドIDEにはWeb開発に必要な三種の神器であるテキストエディタ、ファイルブラウザ、コマンドラインターミナル（図 1.6）もしっかり組み込まれています。また、クラウドIDEのテキストエディタでは、Ruby on Railsの大きなプロジェクトには不可欠とも言うべき横断的ファイル検索も利用できます⁷。たとえクラウドIDEを今後使うことがないとしても、コマンドラインターミナルやテキストエディタなどの開発ツールで一般にどんなことができるのかを知っておくには最適です（筆者としても他のエディタの使い方は知っておいた方が良いと考えています）。

図 1.6: クラウドIDEの外観

Railsチュートリアルでは、難しい環境構築を後回しにするためクレジットカード不要かつ数クリックで環境構築が完了するGitHub Codespacesを採用し、GitHub公式のRailsテンプレートを、Railsチュートリアル用にカスタマイズしたものを使用⁸します。GitHub Codespaces はブラウザ上で開発できるサービスで、無料のプランでも月60時間まで使えます⁹。

クラウドIDEを利用するための手順は次のとおりです。GitHubのサイトは継続的に更新されているため、詳細な手順は異なっているかもしれません。コラム 1.2の「熟練」の考え方を参考に細かな差異にも対応してみましょう。

1. GitHubアカウントをお持ちでない方はGitHubアカウントに登録（サインアップ）しましょう（図 1.7）¹⁰。GitHubにアカウントを作るときに、2要素認証（2FA）も設定しておくことをオススメします（特に「Git に GitHub の認証情報をキャッシュする」を読んでおくとよいでしょう）。
   

   図 1.7: GitHubにユーザー登録する
2. Railsチュートリアル用のテンプレートページに行き、「Use this template」から「Create a new repository」をクリックします。「Use this template」が表示されていない場合はブラウザ幅を広げてみましょう。
   

   図 1.8: テンプレートページからリポジトリの作成へ進む
3. 新しいリポジトリを作成するページが表示されるので、ここではリポジトリ名にhello_appを入力しましょう。Description（説明欄）の内容は空欄でも大丈夫です。そして万全の注意を払って、確実に、“Private”オプションを選択してください（図 1.9）。

   Publicオプションを選択し、本チュートリアルで取り扱うRailsアプリのソースコードをうっかり公開しても原理的には安全です。とはいえ、特にGitを今回初めて使うような場合は秘密鍵のような重要なファイルをうっかりコミットしてしまう可能性もゼロではありません。ですから、何か起きる前にひとまずPrivateにしておく用心深さが大事です¹¹。

   最後に「Create repository」をクリックすると新しくリポジトリが作成されます。

   

   図 1.9: 新しくリポジトリを作成する
4. 作成したリポジトリに飛んだら「Code」から「Codespaces」タブに移動し、「Create codespace on main」をクリックします。
   

   図 1.10: Codespaces を起動する
5. 環境構築が完了するのを待ちます。以下の画面が切り替わった後もCodespacesのサーバーが立ち上がるまで１〜２分ほど掛かります。
   

   図 1.11: 環境構築が完了するのを待つ
6. Railsチュートリアルのロゴ画像が表示されたら完成です。
   

   図 1.12: 環境構築の完成です！

以上で環境構築は完了です！Ruby on RailsでWeb開発を行うための準備が完全に整いました。Codespacesを使用すると、この後の説明はスキップして1.3.2から学習できます。

Codespacesでは必要なバージョンを使用するよう設定されているため以下の操作は不要ですが、それ以外の環境ではバージョンを揃えておきましょう。例えばrvm（Ruby Version Manager）を利用すれば、さまざまなバージョンのRubyを指定してインストールできます¹²。

$ rvm get stable
$ rvm install 3.2.2
$ rvm --default use 3.2.2

1.7でも後述するように、本チュートリアルではUnixのプロンプトとして$記号を使いますので、上の各行冒頭にある$記号は入力しないでください。

Rubyのインストールが完了したら、以下を実行してRubyのバージョンを確認できます（実際に表示されるバージョンはこれと異なることもあります）。

$ ruby -v
ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-linux]

1.2.2 Railsをインストールする

1.2.1の開発環境には必要なソフトウェアがすべて含まれていますが、他の環境ではRailsが含まれていない場合もあるでしょう。また、チュートリアルを期待どおりに進めるには、Railsの正確なバージョンをインストールすることが重要です。

まずはインストール時間を短縮するため、インストールに時間のかかるRubyドキュメントをインストールしないようにする設定を追加してみましょう（リスト 1.1）¹³。このコマンドは1回実行するだけでOKです（コマンドラインの慣習については 1.7で説明します）。

$ echo "gem: --no-document" >> ~/.gemrc

Railsをインストールするには、RubyGemsが提供するgemコマンドを使います。リスト 1.2のコマンドをターミナルに入力してください。クラウドIDEを使っている場合は図 1.6の右下にあるコマンドライン領域に入力してください（ローカル環境で開発している場合は通常のターミナルウィンドウに入力してください）。

$ gem install rails -v 7.0.4.3

-vというオプションを使うことで、インストールされるRailsのバージョンを正確に指定できます。railsコマンドに-vオプション渡せばインストールされたことを確認できます。

$ rails -v
Rails 7.0.4.3

このコマンドで出力されるRailsのバージョン番号は、インストールされたRailsのバージョン（リスト 1.2）と正確に一致する必要があります¹⁴。

経験上、リスト 1.3で示すようにbundler gemのバージョンも揃えておくとよいことがわかっています。

$ gem install bundler -v 2.4.12

bundler gemは重要です。詳しくは 1.3.1で学びます。

1.3.1 Bundler

Railsアプリケーションを新規作成したら、次はBundlerを実行して、アプリケーションに必要なgemをインストールします。Gemfileは、railsコマンド（リスト 1.5）によって自動的に作成されますが、ここではGemfileに記載されているデフォルトのアプリケーションgemを少し変更します。

そのために、テキストエディタでGemfileを開きます（クラウドIDEの場合は、ファイルナビゲーター画面で矢印をクリックしてサンプルアプリのディレクトリを開き、Gemfileアイコンをダブルクリックします）。

Gemfileの内容は、だいたい図 1.14やリスト 1.6のようになります（バージョン番号など細かな点は異なる可能性があります）。Gemfileの内容はRubyのコードですが、ここでは文法を気にする必要はありません。Rubyの詳細については第4章で説明します。

ファイルやディレクトリが図 1.14のように表示されない場合、ナビゲーターの歯車アイコンをクリックして［Refresh File Tree］を選択します。

一般に、ファイルやディレクトリがうまく表示されていない場合は、このようにファイルツリーを再表示してみてください²⁰。

図 1.14: hello_appディレクトリにあるデフォルトのGemfileをテキストエディタで開く

  source "https://rubygems.org"
  git_source(:github) { |repo| "https://github.com/#{repo}.git" }

  ruby "3.2.2"

  # Bundle edge Rails instead: gem "rails", github: "rails/rails", branch: "main"
  gem "rails", "~> 7.0.4", ">= 7.0.4.3"

  # The original asset pipeline for Rails [https://github.com/rails/sprockets-rails]
  gem "sprockets-rails"

  # Use sqlite3 as the database for Active Record
  gem "sqlite3", "~> 1.4"

  # Use the Puma web server [https://github.com/puma/puma]
  gem "puma", "~> 5.0"

  # Use JavaScript with ESM import maps [https://github.com/rails/importmap-rails]
  gem "importmap-rails"

  # Hotwire's SPA-like page accelerator [https://turbo.hotwired.dev]
  gem "turbo-rails"

  # Hotwire's modest JavaScript framework [https://stimulus.hotwired.dev]
  gem "stimulus-rails"

  # Build JSON APIs with ease [https://github.com/rails/jbuilder]
  gem "jbuilder"

  # Use Redis adapter to run Action Cable in production
  # gem "redis", "~> 4.0"

  # Use Kredis to get higher-level data types in Redis [https://github.com/rails/kredis]
  # gem "kredis"

  # Use Active Model has_secure_password [https://guides.rubyonrails.org/active_model_basics.html#securepassword]
  # gem "bcrypt", "~> 3.1.7"

  # Windows does not include zoneinfo files, so bundle the tzinfo-data gem
  gem "tzinfo-data", platforms: %i[ mingw mswin x64_mingw jruby ]

  # Reduces boot times through caching; required in config/boot.rb
  gem "bootsnap", require: false

  # Use Sass to process CSS
  # gem "sassc-rails"

  # Use Active Storage variants [https://guides.rubyonrails.org/active_storage_overview.html#transforming-images]
  # gem "image_processing", "~> 1.2"

  group :development, :test do
    # See https://guides.rubyonrails.org/debugging_rails_applications.html#debugging-with-the-debug-gem
    gem "debug", platforms: %i[ mri mingw x64_mingw ]
  end

  group :development do
    # Use console on exceptions pages [https://github.com/rails/web-console]
    gem "web-console"

    # Add speed badges [https://github.com/MiniProfiler/rack-mini-profiler]
    # gem "rack-mini-profiler"

    # Speed up commands on slow machines / big apps [https://github.com/rails/spring]
    # gem "spring"
  end

  group :test do
    # Use system testing [https://guides.rubyonrails.org/testing.html#system-testing]
    gem "capybara"
    gem "selenium-webdriver"
    gem "webdrivers"
  end

ほとんどの行はハッシュシンボル #（4.2）でコメントされています。これらの行では、よく使われているgemとBundlerの文法の例をコメント形式で紹介しています。この時点では、デフォルト以外のgemをインストールする必要はありません。

gemコマンドで特定のバージョン番号を指定しない限り、Bundlerは自動的に最新バージョンのgemを取得してインストールします。例えば、Gemfileに次のような記述があるとします。

gem "sprockets-rails"

このgemのバージョンを指定する主な方法は2通りあります。これにより、Railsで使われるgemのバージョンを「ある程度」制御できます。1番目の方法は次のとおりです。

gem "capybara", ">= 3.26"

これで最新バージョンのcapybara gemがインストールされます（これはテストで使うgemです）。極端に言えば、バージョンが7.2であっても、3.26と同じかそれより上のバージョンならインストールされます 。

2番目の方法は次のとおりです。

  gem "puma", "~> 5.0"

このように指定すると、バージョンが5.0以上（つまりマイナーアップデート）のpuma gemがインストールされますが、バージョンが6以上（つまりメジャーアップデート）のpuma gemはインストールされません。つまり、>=という記法では最新のgemを探してインストールし、~> 5.0という記法ではバージョン5.1などの新しいマイナーバージョンがあればインストールされますが、バージョン6.0のようなメジャーバージョンアップはインストールされません²¹。

gemのバージョン指定に~>を使う主な理由は、「一般には」マイナーアップデートの方が安全度が高いからです。しかし経験上は、ちょっとしたマイナーアップデートでも問題が発生することがあります。

このため、Railsチュートリアルでは基本的に事実上すべてのgemでバージョンを「ピンポイントで」指定し、がっちり固定してあります。ベテラン開発者にはGemfileで~>を使って指定し、最新のgemを使って進めることをオススメしていますが、チュートリアルが思い通りに動かなくなる可能性があることはご承知おきください²²。

リスト 1.6のGemfileを、実際に使用する正確なバージョンのgemに置き換えたものをリスト 1.7に示します²³。

また、最後の行はWindows環境特有の設定なので、ネイティブのWindows環境でRailsを実行する場合は、この行のコメントアウトを解除しておきましょう²⁴。

source "https://rubygems.org"
git_source(:github) { |repo| "https://github.com/#{repo}.git" }

ruby "3.2.2"

gem "rails",           "7.0.4.3"
gem "sassc-rails",     "2.1.2"
gem "sprockets-rails", "3.4.2"
gem "importmap-rails", "1.1.5"
gem "turbo-rails",     "1.4.0"
gem "stimulus-rails",  "1.2.1"
gem "jbuilder",        "2.11.5"
gem "puma",            "5.6.5"
gem "bootsnap",        "1.16.0", require: false
gem "sqlite3",         "1.6.1"

group :development, :test do
  gem "debug",   "1.7.1", platforms: %i[ mri mingw x64_mingw ]
end

group :development do
  gem "web-console", "4.2.0"
  gem "solargraph",  "0.48.0"
end

group :test do
  gem "capybara",                 "3.38.0"
  gem "selenium-webdriver",       "4.8.3"
  gem "webdrivers",               "5.2.0"
  gem "rails-controller-testing", "1.0.5"
  gem "minitest",                 "5.18.0"
  gem "minitest-reporters",       "1.6.0"
  gem "guard",                    "2.18.0"
  gem "guard-minitest",           "2.4.6"
end

# Windows ではタイムゾーン情報用の tzinfo-data gem を含める必要があります
# gem "tzinfo-data", platforms: %i[ mingw mswin x64_mingw jruby ]

前置きが長くなりましたが、いよいよBundlerを使ってhelloアプリに必要なgemsをインストールする準備が整いました。アプリケーションのGemfileをエディタで開き、リスト 1.7の内容で置き換えて保存したら、bundle installを実行してgemをインストールします²⁵。

リスト 1.5のrailsコマンドのときと同様に、リスト 1.8でもバージョン番号を明示的に指定しています。これにより、正しいバージョン（つまりリスト 1.3でインストールしたバージョン）のbundler gemを使ってbundleコマンドが実行されるようになります。本チュートリアルでは、互換性を最大限に高めてスムーズに作業するためにこの方法を使っています。ただしこれはあくまでチュートリアル向けの方法なので、実際の業務では一般にbundleコマンドでバージョンを指定しないことが多いでしょう（コラム 1.4）。またリスト 1.8の最後には、一部のシステムで必要となるLinuxデプロイプラットフォーム向けの行も含めてあります。

$ cd hello_app/
$ bundle _2.4.12_ install
Fetching source index for https://rubygems.org/
.
.
.
$ bundle _2.4.12_ lock --add-platform x86_64-linux

bundle installコマンドの実行には少し時間がかかるかもしれません。完了後、アプリケーションが実行可能になります（なお、ネイティブのWindowsでRailsを実行する場合は、リスト 1.7の末尾の行のコメント解除をお忘れなく）。

    $ rails new hello_world

    $ bundle install

    $ bundle

    $ bundle update

    $ rm -f Gemfile.lock
    $ bundle

ちなみに、bundle installを実行すると「まずbundle updateを実行してください」というようなメッセージが表示される場合があります。その場合は、メッセージのとおりにbundle updateをまず実行しましょう（特に安全を期して、リスト 1.8のときと同様にbundle _2.4.12_ updateと実行すれば万全です）。マニュアルどおりに行かない場合に慌てず落ち着いて対応することもスキルの1つです。こうしたエラーメッセージにはその場で問題を解決する方法が含まれているものなので、よく読んでおきましょう。

1.3.2 rails server

Railsチュートリアル用のCodespacesテンプレートでは自動でrails serverが実行されています。結果はシンプルブラウザにも表示されていますが、実際のブラウザとは表示が異なる場合もあるので、シンプルブラウザのタブ（図 1.15）か「ポート」タブ（図 1.16）からブラウザウィンドウを開いておくと良いでしょう。

図 1.15: シンプルブラウザタブからブラウザウィンドウを開く

図 1.16: ポートタブからブラウザウィンドウを開く

図 1.17: ブラウザウィンドウでの表示

ブラウザウィンドウでの表示方法は環境によって異なります。例えばクラウドではない開発環境では、ターミナルでrails serverを実行してブラウザのアドレスバーにhttp://localhost:3000を貼り付けましょう。また、Codespaces以外の環境では、図 1.17ではなくRailsのデフォルトページが表示されます。

サーバーをシャットダウンするときは、サーバーを実行しているターミナルで「Ctrl-C」キー²⁶を押します（図 1.18）。再び実行したい場合はrails serverコマンドを入力してください。

図 1.18: サーバーをシャットダウンする

1.3.3 Model-View-Controller（MVC）

まだ始まったばかりですが、今のうちにRailsアプリケーションの全体的な仕組みを知っておくと後々役立ちます（図 1.19）。デフォルトのRailsアプリ構造（図 1.13）を眺めてみると、app/というディレクトリがあり、その中に「models」「views」「controllers」という3つのサブディレクトリがあることに気付いた方もいると思います。ここにはRailsがMVC（model-view-controller）というアーキテクチャパターンを採用していることが暗に示されています。MVCでは、アプリケーション内のデータ（ユーザー情報など）と、データを表示するコードを分離します。アプリケーションのグラフィカルユーザーインターフェイス（GUI）は多くの場合このようにして構成されます。

ブラウザがRailsアプリと通信する際、一般的にWebサーバーにリクエスト（request）を送信し、これはリクエストを処理する役割を担っているRailsのコントローラ（controller）に渡されます。コントローラは、場合によってはすぐにビュー（view）を生成してHTMLをブラウザに送り返します。動的なサイトでは、一般にコントローラは（ユーザーなどの）サイトの要素を表しており、データベースとの通信を担当しているRubyのオブジェクトであるモデル（model） と対話します。モデルを呼び出した後、コントローラは、ビューを描画（レンダリング）し、完成したWebページをHTMLとしてブラウザに返します。

図 1.19: Model-View-Controller（MVC）アーキテクチャの概念図

今はこの解説がまだ少し抽象的に思えるかもしれませんが、この章は後に何度も参照しますのでご安心ください。特に1.3.4では、MVCを扱うお試しアプリケーションをご覧に入れます。2.2.2では、このtoyアプリを使ってMVCの詳細を解説します。サンプルアプリケーションでは、MVCの3つの要素をすべて扱います。3.2でまずコントローラとビューを扱い、モデルについては6.1から扱い始める予定です。その後、これら3つの要素を協調動作させる方法を7.1.2で見ていきます。

1.3.4 Hello, world!

記念すべき最初のMVCフレームワークアプリケーションとして、先ほど作ったアプリにほんのちょっぴり変更を加えることにしましょう。「hello, world!」という文字列を表示するだけのコントローラのアクションを追加し、図 1.17のページを置き換えてみましょう（コントローラのアクションについては2.2.2で詳しく解説します）。

コントローラという名前から想像できるように、コントローラのアクションはコントローラ内で定義します。ここでは、Applicationという名前のコントローラの中にhelloという名前のアクションを作成することにします。実際、この時点ではコントローラはApplicationふたつあります。次のコマンドを実行すると、現在あるコントローラを確認できます。

$ ls app/controllers/*_controller.rb

新しいコントローラの作成は第2章で行います。リスト 1.9に、helloを定義したところを示します。ここではrenderメソッドで「hello, world!」というテキストを表示しています。この時点ではRubyの文法については気にする必要はありません。第4章で詳しく解説します。

class ApplicationController < ActionController::Base

  def hello
    render html: "hello, world!"
  end
end

表示したい文字列を返すアクションを定義したので、今度はデフォルトのページ（1.17）の代わりにこのアクションを使うようRailsに指示します。そのためには、Railsのルーター（router）を編集します。ルーターはコントローラとブラウザの間に配置され（図 1.19）、ブラウザからのリクエストをコントローラに振り分ける（=ルーティング）役割を果たします（図 1.19はわかりやすくするためルーターを省略していますが、2.2.2で詳しく解説します）。ここではデフォルトのページを差し替えたいので、ルートのルーティング（ルート URLにアクセスした場合のルーティング）を変更することにします。例えば http://www.example.com/ というURLの末尾は「/」になっているので、ルートURLは単に「/」（スラッシュ）と簡略表記することもあります。本チュートリアルではrouteやroutingを「ルーティング」、rootを「ルート」と表記します。

Railsのルーティングファイル（config/routes.rb）にはRailsガイドの「ルーティング」を参照するようコメントがあり、ルートルーティングの構成方法がリンク先に示されています（リスト 1.10）。たとえば、具体的なルーティングの文法は次のような形式になります。

root "controller_name#action_name"

現在のコード（リスト 1.10）の場合、コントローラ名はhelloであり、アクション名は indexですが、これをリスト 1.11に示したコードに変更します。

Rails.application.routes.draw do
  root "hello#index"
end

Rails.application.routes.draw do
  root "application#hello"
end

リスト 1.9のコードとリスト 1.11のコードを使うと、ルートルーティングから「hello, world!」が返されるようになります（図 1.20）²⁷。

図 1.20: 「hello, world!」をブラウザで表示する

演習

1. リスト 1.9のhelloアクションを書き換え、「hello, world!」の代わりに「hola, mundo!」と表示されるようにしてみましょう。
2. Railsでは「非ASCII文字」もサポートされています。「¡Hola, mundo!」にはスペイン語特有の逆さ感嘆符「¡」が含まれています（図 1.21）²⁸。「¡」文字をMacで入力するには、Optionキーを押しながら1キーを押します。この文字をコピーして自分のエディタに貼り付ける方が早いかもしれません。
3. リスト 1.9のhelloアクションを参考にして、2つ目のアクションgoodbyeを追加しましょう。このアクションは、「goodbye, world!」というテキストを表示します。リスト 1.11のルーティングを編集して、ルートルーティングの割り当て先をhelloアクションからgoodbyeアクションに変更します（図 1.22）。

図 1.21: ルートルーティングで「¡Hola, mundo!」を表示するよう変更する

図 1.22: ルートルーティングで「goodbye, world!」を表示するよう変更する

1.4.1 Gitのセットアップ

    $ git config --list
    credential.helper=/.codespaces/bin/gitcredential_github.sh
    user.name=[GitHubアカウント名]
    user.email=[GitHubアカウント名]@users.noreply.github.com
    gpg.program=/.codespaces/bin/gh-gpgsign
    init.defaultbranch=main
    core.repositoryformatversion=0
    core.filemode=true
    core.bare=false
    core.logallrefupdates=true
    remote.origin.url=https://github.com/[GitHubアカウント名]/[リポジトリ名]
    remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*
    branch.main.remote=origin
    branch.main.merge=refs/heads/main

プロジェクトの全ファイルはすでにリポジトリに追加されています。ここではgit add -A³⁰を実行して、Git管理下にあるすべての変更ファイルをリポジトリに追加します。

$ git add -A

ただし、.gitignoreに書かれているパターンにマッチするファイルは追加されません。.gitignoreファイルもrails newコマンド実行時に自動生成され、Railsでよく使うパターンが追加されています。もちろん、自分でパターンを追加しても構いません³¹。

Gitで変更したファイルを追加するときは、最初ステージング（Staging）という一種のコミット待ち状態にします。安全のため、いきなり変更を保存（コミット）しないようになっているのです。現在のステージングの状態を知るにはgit statusコマンドを使います。

$ git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)

        new file:   .browserslistrc
        new file:   .gitignore
        new file:   .ruby-version
        new file:   Gemfile
        new file:   Gemfile.lock
        .
        .
        .

ステージングに控えている変更をリポジトリに保存（コミット）するときは、git commitコマンドを使います。

$ git commit -m "Initialize repository"
[main (root-commit) df0a62f] Initialize repository
.
.
.

-mオプションを使うと、コミットの内容を説明するためのコミットメッセージをコマンドラインで直接記入できます。-mオプションを使わない場合はデフォルトに設定されているエディタが開き、そこでコミットメッセージを入力します（本チュートリアルでは常に-mオプションを使っていきます）。

git commitで保存したコミットは、あくまでローカルマシン（クラウドIDEなど）にしか保存されない点にご注意ください。ローカルマシンに保存したコミットを、GitHubに置かれているGitリポジトリに反映（プッシュ）する方法については1.4.4で解説します。

ちなみに、git logコマンドでこれまでのコミットメッセージの履歴を確認することもできます。

$ git log
commit b981e5714e4d4a4f518aeca90270843c178b714e (HEAD -> main)
Author: Michael Hartl <michael@michaelhartl.com>
Date:   Wed Mar 9 17:57:06 2022 +0000

    Initialize repository

コミットログがある程度長い場合は、qキーを押して終了します。『Git/GitHub編』でも解説していますが、git logではlessコマンドをインターフェイスとして使っています。なお、lessコマンドの詳細は、『コマンドライン編』の「使うならmoreよりless」で説明しています。

1.4.2 Gitのメリット

「ソースコードのバージョンをGitで管理する理由が分からない」という方もいるかもしれませんので、1つ例をご紹介します。仮に、あなたが重要なapp/controllers/ディレクトリを削除してしまったとしましょう（ホーマー・シンプソンがやらかすような感じで）。

$ ls app/controllers/
application_controller.rb  concerns/
$ rm -rf app/controllers/
$ ls app/controllers/
ls: app/controllers/: No such file or directory

ここでは、Unixコマンドのlsでapp/controllers/ディレクトリの中身を表示した後、rmコマンドでうっかりディレクトリごと削除してしまったとします（表 1.1）。詳しくは『コマンドライン編』の「ディレクトリのリネーム/コピー/削除を行う」で解説しますが、ここで使っている-rfオプションは、「recursive」（ディレクトリ内にあるすべてのファイルとサブディレクトリを削除する）と、「force」（削除して良いかどうかの確認・警告をせずに削除する）という意味になります。

現在の状態を確認してみましょう。

$ git status
On branch main
Changes not staged for commit:
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore -- <file>..." to discard changes in working directory)

        deleted:    app/controllers/application_controller.rb
        deleted:    app/controllers/concerns/.keep

no changes added to commit (use "git add" and/or "git commit -a")

ファイルがいくつか削除されましたが、この変更はまだステージングに追加されておらず、コミットもされていません。つまり、restoreコマンド（と、対象ディレクトリまたはファイル名）を使えば、直前にコミットした状態まで簡単に戻すことができます³²。

$ git restore .
$ git status
On branch main
nothing to commit, working tree clean
$ ls app/controllers/
application_controller.rb  concerns/

うっかり削除してしまったディレクトリやファイルが、無事に復旧できましたね。これがGitを使うメリットの1つです。

1.4.3 GitHub

Gitを使ったソースコードのバージョン管理ができるようになったので、今度はGitHubにソースコードをアップロードしてみましょう。GitHubはGitに特化したソフトウェア開発のプラットフォームです³³。

ローカルマシンにあるGitリポジトリを、わざわざGitHubにプッシュする主な理由は2つあります。1つ目は、ソースコードとそのすべての変更履歴（コミット記録）の完全なバックアップを作成するためです。2つ目は、他の開発者との共同作業をより簡単に行うためです。

1.2.1で環境構築を行なった際に、すでにGitHubにリポジトリを作成（図 1.9）しているので、あとはgit pushを実行するだけです³⁴。ブラウザでGitHubのhello_appリポジトリページを表示すると、コミットが反映されています³⁵。このページで、リポジトリのファイルを見たりコミット履歴を参照するなど、さまざまな機能が利用できるようになります（図 1.23）。

図 1.23: GitHubのリポジトリページ

1.4.4 ブランチ、編集、コミット、マージ

GitHubのリポジトリのページににアクセスすると、READMEファイルの内容が表示されることに気付いたでしょうか（図 1.24）。このREADME.mdファイルは、Railsチュートリアルのテンプレートからcodespacesで環境構築した時に自動生成されました。ファイル名の拡張子が「.md」となっているファイルは、Markdownという人間にとって読みやすい記法を使って書きます³⁶。Markdownは簡単にHTMLに変換できるため、GitHubでもMarkdownで書かれたREADME.mdファイルをHTMLで表示してくれます。

Railsが自動生成したREADMEをそのまま使ってもよいですし、プロジェクトに合わせて内容を書き換えても構いません。とはいえ良い練習になるので、今回はREADMEを書き換えながらGitの使い方に慣れてみましょう。具体的には、Gitの基本的なコマンドであるブランチ（branch）、編集（edit）、コミット（commit）、マージ（merge）の4つを紹介します³⁷。

図 1.24: CodespacesテンプレートのデフォルトREADMEの表示

$ git switch -c modify-README
Switched to a new branch 'modify-README'
$ git branch
  main
* modify-README

Gitの編集（Edit）

トピックブランチを作ったら、READMEを編集（edit）してコンテンツを追加しましょう（リスト 1.13と図 1.25）。

リスト 1.13: 新しいREADMEファイル README.md

# Ruby on Rails Tutorial

## "hello, world!"

This is the first application for the
[*Ruby on Rails Tutorial*](https://railstutorial.jp/)
by [Michael Hartl](https://www.michaelhartl.com/). Hello, world!

図 1.25: READMEファイルを編集する

$ git status
On branch modify-README
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore -- <file>..." to discard changes in working directory)

        modified:   README.md

no changes added to commit (use "git add" and/or "git commit -a")

$ git commit -a -m "Improve the README file"
[modify-README 34bb6a5] Improve the README file
 1 file changed, 5 insertions(+), 22 deletions(-)

$ git switch main
Switched to branch 'main'

$ git merge modify-README
Updating b981e57..015008c
Fast-forward
 README.md | 27 +++++----------------------
 1 file changed, 5 insertions(+), 22 deletions(-)

$ git branch -d modify-README
Deleted branch modify-README (was 015008c).

# これはあくまで例です。誤ってブランチを作ったとき以外は実行しないでください。
$ git switch -c topic-branch
$ <ココで何か変更を加えてみてください>
$ git add -A
$ git commit -a -m "Make major mistake"
$ git switch main
$ git branch -D topic-branch

Push（プッシュ）

READMEファイルの更新が終わったので、プッシュ（push）コマンドでGitHubに変更をアップロードしてみましょう。既に1.4.3で一度プッシュしているため、今回はgit push origin mainを省略したgit pushでも実行できるはずです。

$ git push

無事にアップロードできたら、GitHub上にあるhello_appのページを確認してみましょう。README.mdの部分が更新されていれば成功です（図 1.26）。

図 1.26: GitHub上で更新されているREADMEファイル

1.6.1 本章のまとめ

• Ruby on Railsとは、Webアプリケーションを開発するためのフレームワークであり、プログラミング言語Rubyで作られている。
• クラウドIDEを利用すると、Railsのインストールやアプリケーションの生成、生成したファイルの編集などが簡単にができる。
• Railsにはrailsコマンドが用意されていて、rails newで新しいアプリケーションを生成したり、rails serverで開発環境用のサーバーを立ち上げられる。
• コントローラのアクションを追加したり、ルーティングを変更するだけで「hello, world」を表示するアプリケーションを作成できた。
• データの喪失を防止し、他の開発者と共同作業できるようにするため、Gitによるバージョン管理を導入し、GitHubの非公開リポジトリに保存した。
• Gitを導入していたため、アプリケーションを本番環境（Render）にすぐデプロイできた。