docker-compose で DB とアプリサーバを立ち上げ、接続する
— Docker docker-compose Rust PostgreSQL — 3 min read
docker-compose
で DB とアプリサーバのコンテナを管理する際に、両者を接続するための方法に関しての備忘録です。
構成
必要最低限の構成のみ記します。
.|-- docker-compose.yml`-- server |-- Dockerfile |-- Cargo.toml `-- src |-- *.rs ...
ファイルの中身
Rust 関連のファイルの内容に関しては省略します。
DB は Postgres を使用し、アプリサーバには Rust で diesel を用いて DB に接続するとします。
Dockerfile
ポート 8088 でサーバを立ち上げます。
Docker コンテナ立ち上げ時に diesel をインストールします。
# 開発環境FROM rust:1.57.0 as develop-stageWORKDIR /appRUN cargo install cargo-watchRUN apt install -y libpq-devRUN cargo install diesel_cli
# ビルド環境FROM develop-stage as build-stageRUN cargo build --release
docker-composed.yml
diesel 起動時に環境変数 DATABASE_URL
が必要なので指定します。
version: '3.7'
services: server: build: context: ./server target: 'develop-stage' ports: - '8088:8088' depends_on: db: condition: service_healthy environment: - DATABASE_URL=postgres://admin:password@db:5432/postgres command: /bin/sh -c "diesel setup && cargo watch -x run tty: true db: image: postgres:14-alpine ports: - '5432:5432' environment: POSTGRES_USER: admin POSTGRES_PASSWORD: password POSTGRES_DB: postgres healthcheck: test: ["CMD-SHELL", "pg_isready"] interval: 10s timeout: 5s retries: 5
docker-compose.yml
の中身に関してのポイントは以下の3点です:
- DB のホスト名は DB コンテナのサービス名となる。
- 今回の場合は
db
- よって、
DATABASE_URL
に渡す URL は上記の通りとなる。
- 今回の場合は
- アプリサーバのコンテナは起動させっぱなしにする:
tty: true
を指定する。 - アプリサーバのコンテナは DB サーバのコンテナが正常起動し終わった後に起動させる。
server
のdepends_on
にサービスdb
を指定し、条件service_healthy
を指定する。db
のhealthcheck
に DB が正常に起動していることを確かめるためのコマンドを指定する。depends_on
のみの指定は単に起動順を制御するのみで、正常起動したかどうかを確かめた上で起動するわけではないことに注意。
上記のファイルを作成した上で、 docker-compose up -d
を実行すると、(初回はビルドが走った後に)無事にコンテナが起動します。
$ docker-compose ps (git)-[main] Name Command State Ports ------------------------------------------------------------------------------------------------------------rust-web-api-server-sample_db_1 docker-entrypoint.sh postgres Up(healthy) 0.0.0.0:5432->5432/tcprust-web-api-server-sample_server_1 bash Up 0.0.0.0:8088->8088/tcp
まとめ
- docker-compose で DB とアプリサーバを管理する際に引っかかった点をまとめました。
- diesel を使用していると、 DB が正常起動していなければアプリが立ち上がらなかったため、少し苦労しました。