どうも、三町哲平です!

開発が長引くと、Railsのアプリ名を変更したいということがあると思います。
しかし、初めてアプリ名を変更するとなると、一箇所変えただけでは、不具合の原因となりエラーが発生してしまうのではないかと思ってついつい思い止まって時間だけが無駄にすぎてしまうなんてこともあると思います。

そんな、初心者の方にも必見のアプリ名のRailsのアプリ名変更方法を紹介します。

今回は、Docker-composeで開発環境も構築していますので、流れとして、

1. Railsのアプリ名の変更方法
2. Docker-composeのアプリ名変更方法
3. GitHubのアプリ名の変更方法

この順番で紹介します。

例えば、Docker-composeを利用していないのであれば、2.は、読み飛ばしてもらって構わないですし、GitHubを利用していないのであれば、3.を飛ばして読み進めてください。

1. Railsのアプリ名の変更方法

①gemのrenameを使用

Gemfile

gem 'rename'

$ bundler install

インストールしてください。

②データベースを破棄する。

不具合の原因になりますので、破棄します。

$ rails db:drop

Docker-composeでwebという名称で構築した環境の為、下記のコードを先頭に追加した上で、

$ docker-compose run --rm web

↓

te_app % docker-compose run --rm web rails db:drop                
Creating te_app_web_run ... done
Dropped database 'illustration_development'
Dropped database 'illustration_test'

③renameを使用してアプリ名を変更する。

$ rails g rename:into 新しいアプリ名

上記のソースコードを踏まえ私の開発環境だと、

Ⅰ. ②データベースを破棄する。と同様に、Docker-composeで構築した環境の為、下記のコードを先頭に追加した上で、

$ docker-compose run --rm web

Ⅱ. アプリ名を te_app → illustration に変更しています。

te_app % docker-compose run --rm web rails g rename:into illustration
Creating network "te_app_default" with the default driver
Creating te_app_db_1 ... done
Creating te_app_web_run ... done
Search and replace module in...
        gsub  Dockerfile
        gsub  Gemfile
        gsub  Gemfile.lock
        gsub  README.md
        gsub  Rakefile
        gsub  babel.config.js
        gsub  config.ru
        gsub  docker-compose.yml
        gsub  entrypoint.sh
        gsub  package.json
        gsub  postcss.config.js
        gsub  yarn.lock
        gsub  スクリーンショット 2020-11-18 20.19.02.png
        gsub  スクリーンショット 2020-11-18 21.29.05.png
        gsub  config/application.rb
        gsub  config/boot.rb
        gsub  config/environment.rb
        gsub  config/environments/development.rb
        gsub  config/environments/production.rb
        gsub  config/environments/test.rb
        gsub  config/initializers/application_controller_renderer.rb
        gsub  config/initializers/assets.rb
        gsub  config/initializers/backtrace_silencers.rb
        gsub  config/initializers/content_security_policy.rb
        gsub  config/initializers/cookies_serializer.rb
        gsub  config/initializers/devise.rb
        gsub  config/initializers/filter_parameter_logging.rb
        gsub  config/initializers/inflections.rb
        gsub  config/initializers/mime_types.rb
        gsub  config/initializers/wrap_parameters.rb
        gsub  config/puma.rb
        gsub  config/routes.rb
        gsub  config/spring.rb
        gsub  config/initializers/session_store.rb
Error: No such file or directory @ rb_sysopen - /te_app/config/initializers/session_store.rb
        gsub  config/database.yml
Renaming references...
Renaming directory...Error:#<Errno::EBUSY: Device or resource busy @ rb_file_s_rename - (/te_app, /illustration)>

↑エラーが発生しましたが、__②データベースを破棄する。不具合の原因になりますので、破棄します。__の部分をやり忘れていた事で発生したエラーなので、データベースを破棄後、再度実行。

再度実行で下記の結果に↓

te_app % docker-compose run --rm web rails g rename:into illustration
Creating te_app_web_run ... done
[Error] Constant Illustration is already in use, please choose another name.

↑このエラーは、２度同じ、$ rails g rename:into illustration を実行した為に発生したエラーなので、特に問題はありません。

Ⅲ. Railsアプリのディレクトリ名を変更する。

↓ te_appからillustrationへ

④データベースの作成→migrate

$ rails db:create

$ rails db:migrate

⑤残りの部分を修正する。

__gem 'rename'__だけでは、修正できていない、旧アプリ名の部分を検索して手動で削除します。

アプリの名称は、ファイル名やHTML内など様々な場所で使用されることがあると思います。database周りやconfigなどのRailsの仕組みとしてアプリ名称が入ると決まっている場所はgemが一括で修正してくれますが、さすがに個別にアプリ名称を使用した場所までは修正できません。ですので、それらは探して修正していくしかありません。
引用元: [Rails]rails newした後からアプリ名を変更する方法 - Qiita

$ grep -rn 古いアプリ名 . --exclude-dir={.git,tmp,log}

私の場合だと、

illustration % grep -rn te_app . --exclude-dir={.git,tmp,log}
./config/cable.yml:10:  channel_prefix: te_app_production
./config/environments/production.rb:61:  # config.active_job.queue_name_prefix = "te_app_production"
./package.json:2:  "name": "te_app",

３箇所ほど__te_app__表記の箇所が出てきたので、手動で修正します。

$ grep -rn te_app . --exclude-dir={.git,tmp,log}

もう一度実行してみましたが、何も出てこなかったので、これで、Railsアプリに関しては、完成です。

2. Docker-composeのアプリ名変更方法

Ⅰ. docker-compose.ymlとDockerfileの旧アプリ名(te_app)の箇所を新アプリ名(illustration)に変更します。

【docker-compose.yml】

変更前

docker-compose.yml

version: '3.8'  # docker-composeのバージョン
services: # 下のハッシュにサービスを作る。命名は自由だが、通常はwebとdbと名付ける。
  db:
    image: postgres # 使用するimage（dbでPostgreSQLを指定）
    volumes: # ディレクトリのマウント設定（dbデータなどを残せる）
      - ./tmp/db:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
  web:
    build: . # Dockerfileなどがあるパス（基本的にカレントディレクトリ）
    command: bash -c "rm -f tmp/pids/server.pid && bundle exec rails s -p 4000 -b '0.0.0.0'" # コマンド（server.pidファイルを削除してからrailsサーバー起動)
    volumes:
      - .:/te_app
    ports: # ポート番号。[ホスト：コンテナ]で設定。
      - "4000:4000"
    depends_on:
      - db # 依存関係を示していて、起動順を指定できます。ここではdb→webへと起動します。

↓__変更後__

docker-compose.yml

version: '3.8'  # docker-composeのバージョン
services: # 下のハッシュにサービスを作る。命名は自由だが、通常はwebとdbと名付ける。
  db:
    image: postgres # 使用するimage（dbでPostgreSQLを指定）
    volumes: # ディレクトリのマウント設定（dbデータなどを残せる）
      - ./tmp/db:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
  web:
    build: . # Dockerfileなどがあるパス（基本的にカレントディレクトリ）
    command: bash -c "rm -f tmp/pids/server.pid && bundle exec rails s -p 3000 -b '0.0.0.0'" # コマンド（server.pidファイルを削除してからrailsサーバー起動)
    volumes:
      - .:/illustration
    ports: # ポート番号。[ホスト：コンテナ]で設定。
      - "3000:3000"
    depends_on:
      - db # 依存関係を示していて、起動順を指定できます。ここではdb→webへと起動します。

【Dockerfile】

変更前

Dockerfile

# [FROM] 使用するイメージとバージョン
FROM ruby:2.7.1
# [RUN] コマンドの実行。railsに必要なnodejsとpostgeqsqlをインストールしています
RUN apt-get update -qq && apt-get install -y nodejs postgresql-client

# yarnパッケージ管理ツールをインストール
RUN curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - && \
      echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list && \
      apt update && apt install -y yarn
# Node.jsをインストール
RUN curl -sL https://deb.nodesource.com/setup_7.x | bash - && \
apt-get install nodejs

RUN mkdir /te_app
# [WORKDIR] 作業ディレクトリを設定
WORKDIR /te_app
# [COPY] ローカルのファイルをコンテナへコピー
COPY Gemfile /te_app/Gemfile
COPY Gemfile.lock /te_app/Gemfile.lock
RUN bundle install
COPY . /te_app

# コンテナが起動するたびに実行されるスクリプトを追加します
COPY entrypoint.sh /usr/bin/
RUN chmod +x /usr/bin/entrypoint.sh
# [ENTRYPOINT] 一番最初に実行するコマンド（ここではentrypoint.shを参照）
ENTRYPOINT ["entrypoint.sh"]
# [EXPOSE] コンテナがリッスンするport番号
EXPOSE 3000

# メインプロセスを開始します
# [CMD] イメージ内部のソフトウェア実行（ここではRailsを指す）
CMD ["rails", "server", "-b", "0.0.0.0"]

↓__変更後__

Dockerfile

# [FROM] 使用するイメージとバージョン
FROM ruby:2.7.1
# [RUN] コマンドの実行。railsに必要なnodejsとpostgeqsqlをインストールしています
RUN apt-get update -qq && apt-get install -y nodejs postgresql-client

# yarnパッケージ管理ツールをインストール
RUN curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - && \
      echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list && \
      apt update && apt install -y yarn
# Node.jsをインストール
RUN curl -sL https://deb.nodesource.com/setup_7.x | bash - && \
apt-get install nodejs

RUN mkdir /illustration
# [WORKDIR] 作業ディレクトリを設定
WORKDIR /illustration
# [COPY] ローカルのファイルをコンテナへコピー
COPY Gemfile /illustration/Gemfile
COPY Gemfile.lock /illustration/Gemfile.lock
RUN bundle install
COPY . /illustration

# コンテナが起動するたびに実行されるスクリプトを追加します
COPY entrypoint.sh /usr/bin/
RUN chmod +x /usr/bin/entrypoint.sh
# [ENTRYPOINT] 一番最初に実行するコマンド（ここではentrypoint.shを参照）
ENTRYPOINT ["entrypoint.sh"]
# [EXPOSE] コンテナがリッスンするport番号
EXPOSE 3000

# メインプロセスを開始します
# [CMD] イメージ内部のソフトウェア実行（ここではRailsを指す）
CMD ["rails", "server", "-b", "0.0.0.0"]

Ⅱ. buildし直します。

$ docker-compose build --no-cache

Dockerfileを更新したので、念のため__--no-cache__を追加しました。

3. GitHubのアプリ名の変更方法

Ⅰ. GitHubの旧アプリ名で利用していたリポジトリを開き、__Settings__を選択します。

Ⅱ. __Repository name__を変更します。

Ⅲ. 新アプリ名を入力したら、入力欄横の__Rename__をクリックします。

__↓illustration__に変更済

これで、完成です。
後の操作(git add → git commit → git push)などは、通常通り行うことができます。

参考記事