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の認証に切り替えた後、ログイン不能になる。
- peer: https://www.postgresql.org/docs/10/static/auth-methods.html#AUTH-PEER
- ident: https://www.postgresql.org/docs/10/static/auth-methods.html#AUTH-IDENT
$ 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を指定する場合
$ rails new <app_name> -d postgresql
上記-dオプションでpostgresqlを指定すると、自動作成されるGemfileに以下の通り、pgが追加される。
# Use postgresql as the database for Active Record gem 'pg', '>= 0.18', '< 2.0'
また、config/database.ymlのadapter設定にpostgresqlがデフォルトで指定される。
default: &default adapter: postgresql
「config/database.ymlを編集」以降の手順は下記「アプリ作成後に、DBをpostgresqlに変更する場合」と同様。
アプリ作成後に、DBをpostgresqlに変更する場合
gemをインストール
gemfileに 'pg'を追加
# Gemfile: 以下を追加 # sqliteを使わない場合はコメントアウト # gem 'sqlite3' gem '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を編集
# config/database.yml # development環境でPostgresを使う場合の例 default: &default adapter: postgresql encoding: unicode pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %> timeout: 5000 development: <<: *default database: [app_name]_dev username: [app_name]_dev password: [password] host: localhost
上記の情報をもとに、dbを作成
$ rails db:migrate $ rails db:setup
ここでエラーが出る場合は認証周り(postgres側はpg_hba.confの認証設定、ユーザのパスワード設定、rails側はconfig/database.ymlのuser/password)