rails5 DBをPostgreSQLに変更する

環境

  • OS: CentOS7
  • rails: 5
  • postgres: 10

PostgreSQL側の作業

postgresユーザのパスワード変更(OSとは独立したPostgres側の認証情報の設定)

初期状態ではOSの認証情報を使用してPostgresのDBにログインできる。
この状態でpostgresユーザーでpsqlを起動し、postgresユーザのパスワードを設定する。
(OSとは独立した、Postgres側の認証情報)

$ sudo -u postgres psql
# alter role postgres with password '[PASSWORD]';

[PASSWORD]の部分に任意のパスワードを設定する。

認証方式の切り替え

認証方式をpeerからmd5に変更する。

peer/identは認証にOSの情報が使用される。
(peerはlocal, identはtcp接続時にそれぞれ使用される。)
md5にすると前述のパスワード変更の項で設定したPostgres側の認証情報を使用して認証が行われる。
※デフォルトでpostgresユーザのパスワードは何も設定されていないため、あらかじめpeerの認証でpsqlを起動し、設定しておかないと、md5の認証に切り替えた後、ログイン不能になる。

$ sudo vim /var/lib/pgsql/10/data/pg_hba.conf

※pg_hba.confの場所は環境により異なる可能性がある。

デーモン再起動

認証方式の設定変更を反映するため、デーモンを再起動する。

sudo systemctl restart postgresql-10

railsアプリのDBで使用する任意のUserを作成

$ sudo su - postgres
-bash-4.2$ /bin/createuser -P --interactive [username]
新しいロールのためのパスワード: 
もう一度入力してください:
新しいロールをスーパーユーザにしますか? (y/n)n
新しいロールに対してデータベースを作成する権限を与えますか? (y/n)y
新しいロールに対して別のロールを作成する権限を与えますか? (y/n)n
-bash-4.2$ psql
postgres=# \du
                                   List of roles
 Role name |                         Attributes                         | Member of 
-----------+------------------------------------------------------------+-----------
 username | Create DB                                                  | {}
 postgres  | Superuser, Create role, Create DB, Replication, Bypass RLS | {}

新規に作成したuserに対してAttributesにCreate DBが付与されていることを確認。


Rails側の作業

アプリ作成時に、DBにpostgresqlを指定する場合

アプリ作成後に、DBをpostgresqlに変更する場合

gemをインストール

gemfileに 'pg'を追加

 bundle install

以下のerrorが出た場合

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

current directory: /home/ryohei/.rbenv/versions/2.5.0/lib/ruby/gems/2.5.0/gems/pg-1.0.0/ext
/home/ryohei/.rbenv/versions/2.5.0/bin/ruby -r ./siteconf20180314-25746-bfjmau.rb extconf.rb
checking for pg_config... no
No pg_config... trying anyway. If building fails, please try again with
 --with-pg-config=/path/to/pg_config
checking for libpq-fe.h... no
Can't find the 'libpq-fe.h header
*** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers.  Check the mkmf.log file for more details.  You may
need configuration options.
  • checking for pg_config... no について
    メッセージの通り、pg_configが見つからないので、--with-pg-config=/path/to/pg_configを付与してbundle installすればよい 自分の環境では/usr/pgsql-10/bin/pg_configにあるので、
$ bundle config build.pg --with-pg-config=/usr/pgsql-10/bin/pg_config
  • checking for libpq-fe.h... no について
sudo yum install -y postgresql10-devel #使用するpostgresqlのver.が10の場合
$ bundle install

config/database.ymlを編集

$ rails db:setup

ここでエラーが出る場合は認証周り(postgres側はpg_hba.confの認証設定、ユーザのパスワード設定、rails側はconfig/database.ymlのuser/password)