Ubuntu 18.04 LTS にデータベースを作成する

データベースのインストール前提条件

  • HTTP Proxy の設定が必要な場合、HTTP Proxy の設定（環境変数）が予め行われていること。
  • ネットワーク設定が予め行われていること。
  • データベースの設定は、説明では以下の使用します。
    • データベース名称: dbname
    • データベースホスト名: dbhost
    • データベースサービスポート: 5432
    • データベースユーザ名: dbuser
    • データベースユーザパスワード: dbpass

データベースセットアップ手順

  1. PostgreSQL をインストールし、起動します。 
    $ sudo apt update
    $ sudo apt install -y postgresql-10
  2. データベースを作成します。 
    $ sudo su - postgres
    $ psql -l
      ※ 作成しようとしているデータベース名のデータベースが無いことを確認します。
    $ createdb --encoding=UTF-8 dbname
  3. データベースユーザ（データベースにアクセスする際の認証で使用するユーザ）を作成します。 
    $ createuser -P dbuser
      ※ パスワード入力（ここでは dbpass）
  4. 3.で作成したユーザに dbname へのアクセス権限を付与 
    $ echo 'grant all privileges on database dbname to dbuser' | psql dbname
    $ exit
  5. PostgreSQLの設定 (postgresql.conf) を変更します。 
    $ sudo vi /etc/postgresql/10/main/postgresql.conf
    [変更前] 
    #listen_addresses = 'localhost'   # what IP address(es) to listen on;
    [変更後] 
    listen_addresses = '*'    # what IP address(es) to listen on;

  6. PostgreSQLの設定 (pg_hba.conf) を変更します。

    • [VMサーバと同一のホスト上にデータベースをセットアップしている場合]

    • 6-1-1. まず、docker0 インタフェースの IP アドレスを確認します。 

      $ ip address show dev docker0
      3: docker0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500
                          qdisc noqueue state UP group default 
      link/ether 02:42:e6:14:05:27 brd ff:ff:ff:ff:ff:ff
      inet 172.17.0.1/16 brd 172.17.255.255 scope global docker0
         valid_lft forever preferred_lft forever
      inet6 fe80::42:e6ff:fe14:527/64 scope link
         valid_lft forever preferred_lft forever

      上記の場合、データベースサーバの IP アドレスは 172.17.0.1 で、ネットワークアドレスは 172.17.0.0/16 であることを確認できます。

    • 6-1-2. 6-1-1.より docker0 のネットワークアドレスが 172.17.0.0/16 であることが 確認できるため、PostgreSQL 設定ファイルの pg_hba.conf にアクセス許可の設定を 行います。 

      $ sudo vi /etc/postgresql/10/main/pg_hba.conf
      [最後に追記]
      host	dbname dbuser	172.17.0.0/16	md5

    • 6-1-3. 設定変更を反映するため、データベースを再起動します。 

      $ sudo service postgresql restart
    • [VMサーバと別のホスト上にデータベースをセットアップしている場合]

    • 6-2-1. VMサーバのIPアドレスを xxx.xxx.xxx.xxx とした場合、PostgreSQL 設定ファイルの pg_hba.conf にアクセス許可の設定を行います。 

      $ sudo vi /etc/postgresql/10/main/pg_hba.conf
      [最後に追記]
      host	dbname dbuser	xxx.xxx.xxx.xxx/32	md5

    • 6-2-2. 設定変更を反映するため、データベースを再起動します。 

      $ sudo service postgresql restart
  7. 以上で、データベースのセットアップは完了です。

データベースバックアップ手順

  1. データベースのバックアップは、データベースのセットアップを行ったホスト上で以下のように操作します。 
    $ sudo su - postgres
    $ pg_dump -U dbuser -h localhost dbname | gzip -c > /tmp/dbname.psql.gz
      ※ パスワード入力（ここでは dbpass）
    作成された /tmp/dbname.psql.gz がバックアップファイルです。

データベースリストア手順

  1. データベースのリストアは、データベースのセットアップを行ったホスト上で以下のように操作します。
    dbname.psql.gzは、データベースのバックアップで作成したバックアップファイルです。操作の 前に/tmp/ディレクトリに転送しておきます。 
    $ sudo su - postgres
    $ gzip -dc /tmp/dbname.psql.gz | psql -U dbuser -h localhost dbname
      ※ パスワード入力（ここでは dbpass）
    なお、pg_dumpコマンドは異なるホスト上のデータベースを指定してバックアップを取得することも可能ですが、PostgreSQLのバージョンが異なる場合にはアクセスに失敗する可能性があります。
    そのため、データベースのバックアップについては、データベースサーバ上で実行することをお勧めします。
    取得したバックアップファイルについては、異なるバージョンのPostgreSQLでも基本的には読み込むことが可能です。