Railsアプリの名称を変更したい!できるだけ楽に安心して行える方法を解説【+リモートリポジトリー名変更】

2019年12月9日 23:01
Railsアプリを作成してしばらくしてからアプリ名を変更したいと思ったことはないでしょうか。Railsのアプリ名とは、最初にrails newしたときに指定した文字列のことです。
$ rails new <アプリ名>
ここで指定したアプリ名はRailsアプリのソースコードのそこかしこに書かれています。少しPCに詳しい人だったらディレクトリ配下の一括置換なんかでさくっと変更してしまえますが、初心者にはなかなかハードルの高い作業かもしれません。
今回は初心者の方でも楽に、そして安心してRailsアプリの名称を変更する方法を解説します。
また、GitHubのリポジトリー名の変更についても合わせて解説します。

バックアップ

せっかく作ったアプリが消えてしまったり起動しなくなるのは嫌ですよね。
そんな万が一のことを考えて二重三重にバックアップをとっておくことにしましょう。

GitHub
Railsでアプリ開発を行っている方ならGitHubを利用していることかと思います。
万が一ローカルのアプリが消えてしまっても、GitHubにソースをあげていればすぐに復活させることができます。

GitHubからローカルにアプリを復活させる手順を予習しておきましょう。
1.png40.1KB

自分のGitHubのページにアクセスし、リポジトリー名をクリックします。
2.png72.7KB

Clone or downloadボタンをクリックします。
3.png29.8KB

URLの横のボタンをクリックするとURLがクリップボードにコピーされます。

次に、ターミナルで以下のコマンドを実行します。
既存のアプリがあるディレクトリでは実行しないでください。
$ git clone <コピーしたリポジトリーのURL>
万が一ローカルのアプリが消えてしまったらGitHubから復活させましょう。

データベース
ソースコードのバックアップはGitHubにあるので安心ですが、データベースのバックアップはGitHubにはありません。
なので、原始的な方法でバックアップを取っておきましょう。
なお、データベースはSQLiteを使っていることとします。

SQLiteのデータベースはdb/development.sqlite3です。これを別のディレクトリにコピーしておきます。
$ cd ~/Product/sample/db/
$ cp -p development.sqlite3 ~/.
「~/」はユーザーのホームディレクトリ、「.」はコピー元のファイル名と同じという意味です。

Railsアプリ名称変更

Railsアプリ名称変更を行うためだけのGemが存在します。
Gemfileに以下を追記してbundle installを行います。
...
gem 'rename'
直球の名前ですね。シンプルで好みです。
インストールできたら、変更したいアプリのルートディレクトリで以下を実行します。
$ rails g rename:into <変更後の名前>
これでRailsアプリの名称が変更されました。
ディレクトリ名も変更されているので、VSCodeを使っている人は開き直しましょう。

GitHubのリポジトリー名変更

続いてGitHubのリポジトリー名を変更していきます。
4.png72.6KB

GitHubにアクセスし、Settingsをクリックします。
5.png23.2KB

Repository nameに変更後の名前を入力し、Renameボタンをクリックします。

ローカルのリモートリポジトリー設定を変更していきます。
まず、現在のリモートリポジトリー設定を確認します。
$ git remote -v
origin  <リモートリポジトリーのURL> (fetch)
origin  <リモートリポジトリーのURL> (push)
次に、リモートリポジトリー設定を変更します。
$ git remote set-url origin <変更後のURL>
最後に、リモートリポジトリー設定が変更されているか確認します。
$ git remote -v
origin  <変更後のURL> (fetch)
origin  <変更後のURL> (push)

まとめ

Railsアプリの名称変更はあまり行いたくないものです。そうは言っても、どうしても変更したいということもあると思います。
そんなときはできるだけ安全に行えるよう、事前にバックアップを取っておくと安心です。
また、バックアップから復活させる方法も事前にシミュレーションしておくことをおすすめします。

関連記事

【Rails】Webサーバー「Unicorn」の基本情報と実装方法
# はじめに Railsアプリを本番環境で稼働させるには、クライアントからのリクエストを捌くWebサーバーを導入する必要があります。WebサーバーはクライアントからのリクエストをRailsアプリに伝達し、Railsアプリで処理されたレスポンスをク [...]
2021年4月15日 12:17
【Rails】デプロイツール「Capistrano」の基本情報と実装方法
# はじめに アプリを本番環境にアップロードして誰でもアクセスできる状態にすることをデプロイと言います。デプロイで行うべきことは多岐にわたります。Railsアプリの場合で言えば、本番環境にアップロードすることはもちろんですが、Gemのインストール [...]
2021年4月14日 9:56
【Rails】Webpackerの基本情報と実装方法
# はじめに Rails 6からWebpackerが正式採用されました。Rails 5ではオプションで追加することができたWebpackerですが、Rails 6からは普通にアプリを作成するだけでWebpackerがインストールされ、必要な設定も [...]
2021年4月12日 14:36
【Rails】アセットパイプライン(Sprockets)の基本情報と実装方法
# はじめに Ruby on Railsにはアセットパイプラインという機能があります。アセットパイプラインは画像、CSS、JavaScriptといったアセットファイルを連結/圧縮することでRailsアプリを高速化します。また、より高級な言語で書か [...]
2021年4月11日 14:08
【Rails】Turbolinksの基本情報と実装方法
# はじめに Ruby on Railsにはページの遷移を高速化するTurbolinksという機能があります。Turbolinksは優れたJavaScriptライブラリですが、Rails 5からは標準で有効化されているため、Turbolinksを [...]
2021年4月10日 17:59