【初心者向け】railsアプリをherokuを使って確実にデプロイする方法【決定版】

herokuを使ったRailsアプリのデプロイ

Railsといえば「爆速でアプリが作れる」だと思いますが、そうやって作ったアプリもやっぱり「爆速でデプロイしたい」ですよね。
そんな時に非常に便利になってくるのがherokuというサービスなのですが、プログラミングの講師をさせていただいている時、生徒さんにherokuにデプロイしてもらってもうまくいかないことが多いです。

インターネット上にherokuによるデプロイの記事は数多に存在しておりますが、なぜそのようなことがおきてしまうのか？

それは、簡単にデプロイできすぎてしまうため、__エラーが起きるときの原因と結果が知られていない__からかと思われます。
すごい人はすぐ解決しちゃうし、初心者の方は解決するので精一杯なのでアウトプットするまでに至らない、といったようなことかなと。

なので、チュートリアル形式で__エラーをなるべく起こさないように__Railsアプリをherokuにデプロイして行きます。

必要なもの、コト(ここら辺もチュートリアル形式でやっていきます)

• デプロイしたいRailsアプリ
• gitのインストール
• herokuのユーザー登録
• heroku-cliのインストール

自分の環境

• Rails 5.1.6
• Ruby 2.3.1
• git 2.14.1
• heroku-cli/6.15.37-14485d4 (darwin-x64) node-v9.9.0

始める前に

Railsアプリの作成については省略したいところなのですが、
もしherokuへのデプロイのみを試したい、という方がいればアプリの作成できる環境にはいり、ターミナルで以下のコマンドを打ってください。
(#~ となっているのはコメントアウトなので、無視してください。)

ターミナル

$rails new heroku_app #アプリ名はなんでも良いです
$cd heroku_app #作ったアプリに移動します
$rails g scaffold blog title:string body:text #scaffoldで作っていますがなんでも良いです
$rake db:migrate

これで、blogモデル、blogsコントローラなどなど色々作られた簡易的なブログができたと思います。Railsはやはり爆速ですね！はい。

確認のため、サーバーを立ち上げてみましょう。ターミナルで打ってください。

ターミナル

$rails s

以下のURLを押してみてください。Railsのwelcomeページが表示されていたらOKです！
http://localhost:3000

では次に進んで行きましょう！

はじめに

早速デプロイ・・・とはいきたいところなんですが、まず初めにRailsアプリをherokuにあげれるよう準備してあげなくてはなりません。

Railsアプリをデプロイする準備

大きく分けて以下の変更を行います。全てRailsアプリの設定の変更です。

• config/routes.rbの設定
• Gemfileの設定
• config/datebase.ymlの設定
• config/environments/production.rbの設定
• bin以下のフォルダの設定(任意)

そんなに難しくありませんので、順番にやっていきましょう！

config/routes.rbの設定

configフォルダの中のroutes.rbを以下のように編集してください。トップページをindexに設定しています。
もちろん、ご自身のアプリの設定したいトップページをここに定義してください。
大事なのは__トップページを何かしらに設定していること__です。

config/routes.rb

Rails.application.routes.draw do
   resources :blogs
   root 'blogs#index' #トップページをblogsコントローラのindexアクションに設定
 end

これをしないと本番環境(デプロイした後の環境)で「urlが正しく有りません」というエラーになってしまいます。
先ほどアクセスした
http://localhost:3000
にアクセスして、ご自身の設定したトップページが表示されていればOKです。
先ほどscaffoldで作成したアプリの場合は、このようになります。

Gemfileの設定

次に、Gemfileを変更していきます。
まず、gem 'sqlite3'と、書いてある箇所があると思うのですが、それをコメントアウトしましょう。文字列の先頭に#をつけます。

Gemfile

# sqlite3

コメントアウトができたら、またGemfileのgroup :development, :test do ~~ end__内に__以下のように書き込んでください。下の方にあります。

Gemfile

group :development, :test do
  gem 'sqlite3' #do ~ end内部に追加。他のgemは残してください。
end

他にもbyebugやcapybaraなど色々なgemが書いてあったと思いますが、気にせずで問題ありません（消しちゃダメですよ！）。do ~ end内でしたらどこでも大丈夫です。

最後にもう一つだけGemfileに追加します。以下の記述を__そのまま__Gemfileのどこかに追加してください。ごちゃごちゃにならないよう、一番最後に記述すると良いかもしれません。

Gemfile

group :production do
  gem 'pg'
end

ここでは__環境ごとのデータベースの変更__を行なっています。
開発していた時(developmentやtest環境)はRailsアプリに最初からついている__SQLite3__というのを使っていたのですが、本番環境(production)、もとい__これからデプロイする予定であるheroku__では__PostgreSQL__(略してpg)というデータベースが最初からインストールされているので、その環境に合うようにこのような変更をしています。
SQLite - https://www.sqlite.org/index.html
PostgreSQL - https://www.postgresql.org/

さて、Gemfileを変更したので忘れずにbundle installをしておきましょう。ただし、以下のようにオプションを指定します。

ターミナル

$bundle install --without production

このオプションをつけることによって、__group :produciton do~end内以外の__gemをインストールすることができます。
自分のパソコンにはPostgreSQLは入っていないため、このようなオプションをつけています。

ちなみに、このオプションは一度打ち込めば、アプリ内部の/bundle/configというところに書き込まれるため、それ以降は--without producitonを打たなくても本番環境以外のgemをインストールしてくれるようになります。その他の__bundle install時のオプションは全てここに書き込まれます。__

.のついているファイルは隠しフォルダといい通常は見れないのですが、ターミナルでls -aとうてば確認することができます。(-aは隠しフォルダを表示するコマンドです。)

.bundle/config

#このようになっていたらOKです
BUNDLE_WITHOUT: "production"

もし無くしたければ、config内の記述を削除してしまってください。

さて、gem周りの設定は終わりましたが、データベースの変更にはもう一ついじらなくてはいけない箇所があります。__config/database.yml__です。

config/datebase.ymlの設定

さきほどGemfileを変更したことにより__このアプリは本番環境でPostgreSQLを使います__、という宣言（と機能をインストールするための準備）は完了したのですが、実際にデータベースと接続する記述はまだ完了していません。その接続の設定をする箇所がconfigフォルダの中にある__database.yml__というファイルです。

ファイル内の下の方にある__production__環境についての設定を、以下のように変更してください。

注意して欲しいのが、production:以降の記述は必ずインデント、もとい__半角スペース２個ぶん__の空白を開けて記述してください。.ymlという拡張子のファイルは__インデントで記述を判別__しています。

config/database.yml

production:
#半角スペース２個分の空白を開ける
  <<: *default
  adapter: postgresql
  encoding: unicode
  pool: 5

adapter: postgresql - postgreSQLのデータベースに接続します。
encoding: unicode - unicodeという文字コードを使用します。
pool: 5 - DBに接続できる上限の数を決めます。今回は5。

さて、これにより本番環境でPostgreSQLと接続する準備ができました。ここまでくればRailsアプリの設定はほぼ完了しています。

あとは初心者がエラーを起こしがちな箇所への対策を行なっていきたいと思います。

config/environments/production.rbの設定

実は、Railsは__本番環境での動的な画像の表示(というかプリコンパイル)がデフォルトでオフになっています。__
画像を表示するために以下の記述をfalseからtrueに変更してください。（自分は31行目にありました）
この記述により、assets以下のフォルダから動的にコンパイルしながらページを読み込みます。

config/environments/production.rb

#デフォルトでfalseとなっている以下の箇所をtrueに変更
  config.assets.compile = true

こちらの記述はパフォーマンスを悪化させる原因となりますので、こちらを参考にするのが良いです。(@jnchito さんありがとうございます。)
https://qiita.com/jnchito/items/3d225112a3ac95379b1d~~

これが終わればいよいよ次でRailsの設定は最後です。

bin以下のフォルダの設定

この設定は人によっては大丈夫なことも多いのですが、rbenvなどを使ってない人は陥りがちなことが多いので一応記述しておきます。

後述するのですが、データベース周りの設定は完璧なのに__heroku run rails db:migrate__が通らない人はここの箇所で詰まっている人が多いです。

アプリ内にbinというフォルダがあるのですが、その中のファイル全て(bundle,rails,rake,setup,spring, update,yarn)の一番上に

#!/usr/bin/env ruby

という記述があると思います。ここの記述が、

#!/usr/bin/env ruby 2.3.1

など__バージョン指定されてしまっているファイル__全てのバージョンを削除してください。つまり、上の記述から

#!/usr/bin/env ruby

このように__数字を削除__するということになります。(今回は2.3.1の部分)

さて、長くなってしまいましたがこれでRailsアプリの設定は終了になります。本格的にデプロイに移っていきましょう。

herokuのデプロイには__git__というツールを使用します。

git とは

• 保存するためのツール。めちゃ多機能。過去や、並行世界とかにいける。

ここではgitについての詳しい解説は行いません。以下のページで勉強してみましょう。
https://qiita.com/yunico-jp/items/87bdd13971e82833f6bb

以下のurlからインストールしましょう。
https://git-scm.com/downloads
(macかwindowsかお間違えなく！)
vagrantの方は「Linux/Unix」を選択し、自分のOSにあったコマンドを打てばOKです。
https://git-scm.com/download/linux

Debian/ubuntuの場合

ターミナル(ubuntu内)

$apt-get install git

以下のコマンドを打って、インストールしたバージョンが出てきたらインストールが成功しています。

ターミナル

$git --version
>>git version 2.14.1

gitがインストールできたら、ターミナルで以下のコマンドを打ってください。

このコマンドで、「このアプリでgitを使います」という指示を出しています。

最初の一回だけ！

ターミナル

$git init   #このフォルダをgitと紐づけます、という指示。

続けて、gitを使ったアプリを保存するコマンドです。

変更したら毎回やるやつ

ターミナル

$git add -A #保存するファイルの選択。-Aは全部
$git commit -m "first commit" #addしたファイルの保存の確定

ここで、初めてコミットする場合は、githubのユーザー名とemailの入力を求められます。
githubに登録していない方は無視してしまって大丈夫です。もしくは、登録する予定のメアドとユーザーネームを入力してください（笑）

初めてgitを使ってコミットした方

ターミナル

$git config --global user.email #ギットハブに登録したemail
$git config --global user.name #ギットハブに登録したユーザーネーム

念のためもう一度commitしましょう。

ターミナル

$git commit -m "first commit"

以下のように

と、create mode ...とたくさん出てきた方か、

このようにnothing to commitと出てきた方は大丈夫です。

では、いよいよherokuを使っていきます。

herokuとは

• PaaS（Platform as a Service）と呼ばれるサービス
• サーバやOS、データベースなどの「プラットフォーム」と呼ばれる部分を、インターネット越しに使えるようにしてくれるサービス
• 簡単かつ無料でRailsアプリがあげられる

通常、Railsアプリはデプロイが難しいことが多いのですが、このherokuを使うと比較的簡単にデプロイすることができます。機能的には物足りない部分もあるのですが、その場合は有料版を使えば問題なくサービスを立ち上げることができます。

herokuへの登録

さて、gitの準備はできましたので、herokuに登録しましょう。英語ですが、google翻訳を駆使すれば全然問題ありません。(僕も英語できないんです)

会員登録が完了したら、今度はherokuの機能を自分のPCに紐付けましょう。cliをダウンロードします。

今回もmacかwindowsか、それとも他のか注意してください。
サイトにも書いてありますが、ubuntuの場合は以下のコマンドを打ってください。

ターミナル(ubuntu)

$curl https://cli-assets.heroku.com/install-ubuntu.sh | sh

パスを通してください、という文と以下のコマンドが出るので、コピペしてまたターミナルに打ちましょう。

ターミナル

$echo 'PATH="/usr/local/heroku/bin:$PATH"' >> ~/.profile

gitの時と同じように以下のコマンドを打って、インストールしたバージョンが出てきたらインストールが成功しています。

ターミナル

$heroku --version
>>heroku/7.0.47 darwin-x64 node-v10.1.0

はい、herokuのcliもインストールできたので、いよいよ自分のアプリとherokuを紐づけていきましょう！

Railsアプリとherokuの紐づけ

まずは、自分のPCからherokuにログインします。（ここまでできているなら大丈夫だと思いますが、wi-fiに繋ぐのを忘れずに！）

PCからherokuにログイン

ターミナル

$heroku login

そうすると、herokuに登録したemailとpasswordの入力を求められるので、指示された通りに打ち込んでください。

herokuに登録したemailとpasswordの入力

ターミナル

Enter your Heroku credentials:
Email: ~~~~~@example.com  (ふっつーにherokuに登録したアドレス打ってください)
Password: **********  (ふっつーにherokuに登録したパスワード打ってください)
Logged in as ~~~~~@example.com

ログインしたら、以下のコマンドを打ってください。このコマンドはherokuとアプリを紐づけるコマンドなので、アプリごとに最初の一回だけで大丈夫です。

アプリごとに最初の一回だけ！

ターミナル

$heroku create 好きなアプリ名 (「好きなアプリ名」に入力する文字列はurlになるものです。_とか使えないので注意！)

「好きなアプリ名」は空欄にしてしまっても自動生成してくれるので大丈夫です。このようになっていたらおっけーです。

このように「Name is already taken...」となっていたら残念ながらそのアプリ名は他の方に取られちゃっています。変更しましょう。

では、いよいよデプロイになります。ターミナルに以下のコマンドを打ち込んでください。

herokuにデプロイ

ターミナル

$git push heroku master

(herokuを使うと、このようにコマンド一つでRailsアプリがデプロイできちゃいます。これで無料はすごい！)

こんな感じでデプロイが進んでいきます。
うまくいかない方は下にデバッグの方法をいくつか載せています。ご参照ください。

詳しくみていくと、このタイミングでproductionでのbundle installや

rake assets:precompile(ざっくりいうと画像の表示)なども行われているのがわかると思います。

さて、ここまで順調であれば、一番最後の方に

このように自分の指定したアプリ名を含んだurlが生成されていますが、これがまさに__自分のアプリのURL__になります。早速確認しにいきたいところなんですが、最後に以下のコマンドを入力してください。

本番環境でのデータベースのマイグレーションになります。

本番環境(heroku)でのマイグレーション

ターミナル

$heroku run rails db:migrate

実行結果

このようにheroku runをつけると__heroku上でrailsコマンド__を打つことができます。他にもheroku run rails cなどなど、色々ありますので調べてみましょう。

以上でherokuでのデプロイは完了になります！早速、先ほどメモしたURLをブラウザのアドレスバーに貼り付けて、確認してみましょう。

お疲れ様でした！

ここまでやったのに、 git push heroku master が通らない

Rubyのバージョンによっては、下のようにRubyのバージョンとHerokuのStack(HerokuのOSイメージ)のバージョンが合わずに下のようにエラーが出ることがあります。
詳しくはこちら(Heroku公式ドキュメント)をご覧ください。

この場合はRubyのバージョンを新しくする か、以下のコマンドでstackのバージョンをHeroku-18からHeroku-16に変更する 必要があります。

下のコマンドは非推奨なのでこちらの記事を参考に直してください。(かなり昔に書いた解決策なのでご勘弁を・・・・。)
=> https://qiita.com/jnchito/items/c3035cc49a9cef053549

ターミナル

$ heroku stack:set heroku-16

ここまでやったのに、 heroku run rails db:migrate が通らない

heroku run rails db:migrate が通らず、かつ下エラーが表示される場合は、Heroku上のアプリケーションにPostgresqlのアドオンが登録されていない可能性があります。

アドオン(add-on)とは、「拡張機能の追加」という意味です。

ターミナル

PG::ConnectionBad: could not connect to server: No such file or directory

その場合、上記コマンドでアドオン登録を行った後、再度マイグレーション処理を実行すると、問題が解決する事があります。

ターミナル

$heroku addons:add heroku-postgresql

おまけ:更新の時

ここまでやった通り、herokuは__gitと連携して、gitに保存した内容をデプロイ__しています。なので、「アプリをちょっと変えたから変更したい」という時には、git addからコマンドを実行してください。

更新時の例:

ターミナル

$git add -A
$git commit -m "Update application"
$git push heroku master

テーブル追加や内容変更などをした場合は、もちろんこちらのコマンドも打ってください。

ターミナル

$heroku run rails db:migrate