【rails-newツールのインストールからアプリ新規作成まで ~ macM2 Docker VSCode 使用 ~】

初めまして！6chanです！
自分がつまづいた箇所を自分の言葉で記述しています。
曖昧な部分があるかもしれません。
間違っている箇所などありましたらアドバイス頂けるとありがたいです。

モチベーション:

「Railsガイド DevContainerでの開発ガイド」において、 「1.3 rails-newツールをインストールする」と 「2 storeアプリケーションを作成する」との間に 必要な手順を補完したいと思い記事にしました。

Railsガイド DevContainerでの開発ガイド, https://railsguides.jp/getting_started_with_devcontainer.html

目的:

rails-newツールのダウンロード、実行、DockerとVSCodeでアプリフォルダを開くところまで解説したい。

目次:

1. rails-newツール のダウンロード・解凍 2. ターミナルを用いたrails-new 実行ファイルの移動 3. rails-new のインストールおよびツール許可方法 4. アプリの作成 5. アプリを開く 番外編. rbenvを用いたrubyのバージョン更新

以下のサイトを参考に実行。
https://qiita.com/fgem28/items/d85dbf41d37cd6f0671b

1. rails-newツール のダウンロード・解凍

下記のリンクからREADME のInstallation にあるlatest release (リンク付き)をクリック。 https://github.com/rails/rails-new?tab=readme-ov-file#installation

v*..(*: バージョン番号) をクリック。
Contributors のAssets から適切なtar.gzファイルをダウンロード。
ファイル選定方法は以下のリンク参照
https://qiita.com/ASONE0923/items/39992e2deb610dda105d

aarch64 <- appleシリコンのpc <= 自分はM2のためこっち。
x86 <- Intel cpuのpc
ダブルクリックで解凍。rails-new という名前の実行ファイルが生成される。

2. ターミナルを用いたrails-new 実行ファイルの移動

rails-new コマンドを実行できるようにするには、 その実行ファイルが特定のパスに無いとnot foundとなり実行できない。 コマンドとして感知できるパスの確認には、ターミナルで以下コマンドを実行。

$ printenv

“PATH= ~” にパスがある。パスは”:” で区切られている。

自分の場合、以下のパスに格納。
$ /usr/local/bin/

以下のコマンドをターミナルで実行。
rails-new のあるフォルダからコマンドとして感知できるフォルダ(パス)へ移動。

$ sudo mv /実行ファイルのあるフォルダパス/rails-new /usr/local/bin/

パスが開通しているか確認するため、以下のコマンド実行。

$ rails-new help

「検証できませんでした。」みたいなエラーが表示された場合、「3. rails-new のインストールおよびツール許可方法」を実行。実行できた場合、「4. アプリの作成」から実行。

3. rails-new のインストールおよびツール許可方法

以下のサイトを参考にしました。 https://qiita.com/suzukidog/items/f0e71297ec5307b473fd

エラー表示のまま、設定 > プライバシーとセキュリティ > セキュリティ でrails-newを許可するか聞かれるので許可する。2度聞かれたと思います。
実行後、以下のコマンドでrails-newコマンドが通ることを再度確認。

$ rails-new help

4. アプリの作成

作成したいアプリを保存するフォルダへ移動

$ cd ./フォルダ名/

確認

$ ls

mac のLaunchpad からDocker を開いておく。
以下のコマンドでrails-newツールを使ったアプリ作成実行

$ rails-new アプリ名 —devcontainer

この時
Is the docker daemon running?
が表示された場合、Dockerが開いていない可能性があるためDockerを再度開く。

5. アプリを開く

VSCode を開く。左下角にある「><」みたいなマークをクリック。 「コンテナー構成ファイルを開く」をクリック。 再度「><」をクリック。「コンテナーでフォルダを開く」からアプリフォルダを選択して開く。

番外編. rbenvを用いたrubyのバージョン更新

参考サイト: @_am_, rbenvでrubyのバージョンを切り替える, https://qiita.com/_am_/items/c1dbeb11f40bbbac8fd9 Rubyは最新版に近いバージョンにするのが一般的らしい。Rubyをアップグレード後、Railsをアップグレードにするのが良いらしい。 Railsガイド 1.2 Rubyバージョン, https://railsguides.jp/upgrading_ruby_on_rails.html

Ruby がバージョン更新している場合、以下の手順で実行。
Rubyのバージョン確認。

$ ruby -v

rbenv で管理しているRubyのバージョンの確認

$ rbenv versions

rbenv でインストール可能なバージョン一覧表示

$ rbenv install -l

インストールしたいrubyバージョンがない場合、 brewを更新。 (Homebrewのリンク: https://brew.sh/ja/)

$ brew update

brew で管理されているrbenv を更新

$ brew upgrade rbenv ruby-build

もう一度インストール可能なバージョン一覧表示

$ rbenv install -l

rbenv下でruby インストール

$ rbenv install 3.3.7

確認

$ rbenv versions

バージョン変更

$ rbenv local 3.3.7

(全てのバージョンを変更するにはlocalではなくglobal。参考リンク: https://qiita.com/Yinaura/items/0b021984bb21ae77816d) 確認

$ ruby —version

その他参考サイト:

Ruby リリース一覧, https://www.ruby-lang.org/ja/downloads/releases/

rails バージョン一覧, https://rubygems.org/gems/rails/versions

最後に

同じく詰まっている人の一助になれrば幸いです。