はじめに
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 directoryENV ROOT="/app"# add path envENV PATH $PATH:/usr/local/bin# set home directoryRUN 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 NestJSRUN npm install-g @nestjs/cli
docker-compose.ymlの作成
NestJSアプリケーションを構成するコンテナ情報を記載します。
データベース操作用にpgAdmin4を入れてますが、端末に既に入ってたり、使用しないのであれば要らないです。
version:"3.7"services:api:build:apicontainer_name:nest_apitty:trueports:-"3000:3000"volumes:-./app:/app:delegated# share directorylinks:-dbrestart:alwaysdb:image:postgres:11.2container_name:nest_dbports:-"5432:5432"volumes:-./db/postgres/init.d:/docker-entrypoint-initdb.d-./db/postgres/pgdata:/var/lib/postgresql/dataenvironment:POSTGRES_USER:root# DB USERPOSTGRES_PASSWORD:root# DB PasswordPOSTGRES_INITDB_ARGS:"--encoding=UTF-8"hostname:postgresuser:rootrestart:alwayspgadmin4:image:dpage/pgadmin4:4.2container_name:pgadmin4ports:-"8000:80"volumes:-./db/pgadmin4:/var/lib/pgadminenvironment:PGADMIN_DEFAULT_EMAIL:root# pgAdmin AddressPGADMIN_DEFAULT_PASSWORD:root# pgAdmin Passwordhostname:pgadmin4links:-dbrestart:alwayspostgreSQL(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を入れるもよし。
どんどん使っていきましょ〜！