NestJS+PostgreSQL(+pgAdmin4)の開発環境をDockerで構築する


はじめに

NestJS + PostgreSQL(+ pgAdmin4)の開発環境を、dockerで構築する手順を紹介します。

バージョン情報

  • Docker : 19.03.13

  • Docker Compose : 1.27.4

  • Node.js : 14

  • PostgreSQL : 11.2

  • pgAdmin4 : 4.2

ディレクトリ構成

以下のような構成で作成します。

$ tree -L 2  
.
├── api
│   └── Dockerfile
├── app    // コンテナ共有ディレクトリ
│   └── [ project directory ]
├── db
│   ├── pgadmin4  // DBサーバ接続永続化用ディレクトリ
│   └── postgres  // DBサーバデータ永続化用ディレクトリ
└── docker-compose.yml

Dockerfileの作成

公開されているNode.jsのdockerイメージを使い、PostgreSQLのライブラリを導入します。
ついでにちょっとしたファイル編集用にvimをインストールしておきます。
(主要なファイルは共有フォルダに置くので無くてもよい)

FROM node:14 
# share directory
ENV ROOT="/app"
# add path env
ENV PATH $PATH:/usr/local/bin
# set home directory
RUN mkdir ${ROOT}
WORKDIR ${ROOT}

RUN apt-get update && apt-get upgrade -y
# install lib (opt : vim)
RUN apt-get install -y build-essential libpq-dev postgresql-client vim
# install NestJS
RUN npm install -g @nestjs/cli

docker-compose.ymlの作成

NestJSアプリケーションを構成するコンテナ情報を記載します。
データベース操作用にpgAdmin4を入れてますが、端末に既に入ってたり、使用しないのであれば要らないです。

version: "3.7"

services:
  api:
    build: api
    container_name: nest_api
    tty: true
    ports:
      - "3000:3000"
    volumes:
      - ./app:/app:delegated  # share directory
    links:
      - db
    restart: always

  db:
    image: postgres:11.2
    container_name: nest_db
    ports:
      - "5432:5432"
    volumes:
      - ./db/postgres/init.d:/docker-entrypoint-initdb.d
      - ./db/postgres/pgdata:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: root       # DB USER
      POSTGRES_PASSWORD: root   # DB Password
      POSTGRES_INITDB_ARGS: "--encoding=UTF-8"
    hostname: postgres
    user: root
    restart: always

  pgadmin4:
    image: dpage/pgadmin4:4.2
    container_name: pgadmin4
    ports:
      - "8000:80"
    volumes:
      - ./db/pgadmin4:/var/lib/pgadmin
    environment:
      PGADMIN_DEFAULT_EMAIL: root     # pgAdmin Address
      PGADMIN_DEFAULT_PASSWORD: root  # pgAdmin Password
    hostname: pgadmin4
    links:
      - db
    restart: always

postgreSQL(pgAdmin4)に設定しているアドレス、パスワードはrootにしてますけど、そこは各自お任せします。

コンテナを作成&起動する

早速コンテナを作成、および起動します。

docker-compose build
docker-compose up -d

起動後は、一応エラーがないか調べましょう。
(立ち上がらなかったら、原因調査に時間がかなり取られます)

docker ps -a
// 立ち上がってなかった場合、ログを見て原因調査
docker-compose logs

コンテナにログインする

起動後はコンテナにログインし、プロジェクト作成の準備をします。

docker-compose exec api bash
// 以下はログインした後にやってます。作業がやりやすいようにしてるだけなので必須ではないです。
echo 'export LS_OPTIONS='\''--color=auto'\' >> ~/.bashrc
echo 'alias ll='\''ls $LS_OPTIONS -l'\' >> ~/.bashrc
source ~/.bashrc

PostgreSQLに接続できるか確認

一応、ちゃんと設定できているか確認。

psql -h db -U root -d postgres
// rootを入力
Password for user root: 
psql (9.6.19, server 11.2 (Debian 11.2-1.pgdg90+1))
WARNING: psql major version 9.6, server major version 11.
         Some psql features might not work.
Type "help" for help.

// postgresのテーブルにログインできたら成功
postgres=# 

ん?なんか警告出てる。
クライアントとサーバ間のバージョン差異での警告みたい。
警告が出るだけで、特に問題ないからヨシ!

※ ヨシじゃねーだろ!って人は以下のコマンドでアップグレードしてください。

sh -c "echo 'deb http://apt.postgresql.org/pub/repos/apt/ stretch-pgdg main' > /etc/apt/sources.list.d/pgdg.list"
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add -
apt-get update
apt-cache search postgresql | grep ^postgresql
// postgresqlのバージョンが増えてるはずなので、対象のパッケージをインストールします。
// サーバ側を11で入れてるのでクライアントも11をインストールします。
apt-get install -y postgresql-client-11

NestJS新規プロジェクトを作成する

コンテナ内でコマンドを発行します。

nest new [ New Project Name]
// npm か yarn どっちを使用するか聞かれるので好みの方を選択する。

NestJS起動

作成したプロジェクトのディレクトリに移動して、NestJSを起動します。

cd [ Project directory ]
// npm
npm run start
// yarn
yarn run start

起動した後は、実際にブラウザで確認します。
localhost:3000にアクセスします。Hello Worldが表示されていたらOK

おまけ: pgAdmin4の確認

pgAdmin4も接続確認してみます。
localhost:8000でアクセスできます。

アドレスとパスワードは、docker-compose.ymlに書いたrootで入ります。
ログインすると下記のような画面になります。

サーバを登録するための設定を行います。
Serversを選択した状態で右クリック→サーバの設定を行います。

サーバ名は自分が分かりやすい名前で。

Connectionタブでホスト名、ユーザ名、パスワードを入力して保存。

無事に接続できました。

最後に

dockerコンテナでNestJSの開発環境を構築しました。
NestJSはAngularに似てるらしいです。
(触ったことがないので私は分かりません。ControllerとServiceはSpringに似てるなぁと思いました)
ここからHTMLを返せるようにするもよし、TypeORMを入れるもよし。
どんどん使っていきましょ〜!

参考

NestJS公式
pgAdmin公式
水無瀬のプログラミング日記 - NestJS事始め