← 記事一覧へ戻る

PCを汚したくないのでDockerでPostgreSQL環境を作ったお話

開発

🐋 PCを汚したくないのでDockerでPostgreSQL環境を作った

NagiLogの開発環境ではSQLite、本番環境ではPostgreSQLを使用していた。

この環境差は以前から把握していたものの、優先順位を下げていたため、 NagiLog_v2ではローカル環境もPostgreSQLへ統一することにした。

ただし、PostgreSQLをWindowsへ直接インストールして常駐させるのは避けたい。

そこで今回はDockerを使い、PostgreSQLをコンテナとして動かすことにした。

🐋 Docker環境を準備

PCにはDocker環境がなかったため、まずWSL2とDocker Desktopを導入した。

Docker Engineが正常に起動することを確認後、 NagiLog_v2にcompose.yamlを作成した。

🐘 PostgreSQLコンテナを定義

今回の構成は以下。

  • PostgreSQL 17
  • DB名:nagilog
  • PostgreSQL用ユーザーを作成
  • Windows側の5432ポートをコンテナへ接続
  • Docker Volumeを利用してDBデータを永続化

Dockerコンテナ自体を作り直してもDBデータを保持できるよう、 PostgreSQLのデータ領域にはVolumeを割り当てた。

🧪 Compose設定を確認

コンテナを起動する前に、

docker compose config

を実行。

Composeファイルが正常に解釈されることを確認した。

その後、

docker compose up -d

でPostgreSQLコンテナを起動。

docker compose ps

でコンテナがUpになっていることと、 5432ポートが正常に公開されていることを確認した。

🐘 PostgreSQLへの接続確認

最後にコンテナ内のPostgreSQLへpsqlで接続。

作成したnagilogデータベースへ正常に接続できることを確認した。

これでWindowsへPostgreSQLを直接インストールせず、 NagiLog_v2専用のPostgreSQL環境を用意できた。

📝 今回理解したこと

Docker Composeでは、

  • image:コンテナを作る元となるイメージ
  • environment:コンテナへ渡す環境変数
  • ports:ホストPCとコンテナのポートを接続
  • volumes:コンテナとは別にデータを永続化

という役割がある。

特にVolumeはバックアップそのものではなく、 コンテナを作り直してもデータを保持するための永続化領域であることを理解した。

🚀 次回

PostgreSQL自体の準備は完了したが、 現時点ではDjangoはまだSQLiteを使用している。

次はDjangoのDATABASES設定を変更し、

SQLite → Docker上のPostgreSQL

へ接続先を切り替える。

その後、

  • migration
  • 既存機能の動作確認
  • 全回帰テスト

まで実施する予定。