アプリケーションの起動

このページで扱う手順で、Docker がインストールされていることを確認します。

1. サービスの一括起動

以下のコマンドで、Docker がインストールされていることを確認します。

docker --version

以下のように Docker のバージョンが表示されれば、インストールは確認できています。

Docker version 27.x.x, build xxxxxxx

バージョンが表示されない場合は、Docker Desktopのインストール を先に実施してください。

インストールが確認できたら、Visual Studio Codeのターミナルを開き、Docker Composeでサービスを起動します。

docker compose up -d --build
オプション 説明
-d バックグラウンドでコンテナを起動するため
--build イメージを(再)ビルドするため。初回起動時やソースコードを変更した場合に使用

初回起動時は、イメージのビルドに時間がかかります。

💡 ポイント
docker compose up -d --buildの1コマンドで、3つのコンテナすべてが起動します。前の章では、各コンテナを個別に起動し、ネットワークを作成して接続する必要がありましたが、Docker Composeではこれらの操作が自動的に行われます。

2. 起動状況の確認

サービスの状態を確認します。

docker compose ps

すべてのサービスがrunningまたはhealthy状態になっていれば成功です。

NAME                          IMAGE                    STATUS
sample-note-api-api-1         sample-note-api-api      Up
sample-note-api-db-1          mysql:8.0                Up (healthy)
sample-note-api-front-1       sample-note-api-front    Up
⚠️ サービスが起動しない場合
docker compose logs サービス名でエラーログを確認してください。よくある問題として、以下のものがあります。

・dbサービスがhealthyにならない → MySQLの起動に時間がかかっています。1分程度待ってから再度docker compose psを実行してください。
・apiサービスがすぐに終了する → docker compose logs apiでエラーを確認してください。
・frontサービスがビルドに失敗する → docker compose logs frontでエラーを確認してください。

3. ログの確認

全サービスのログをリアルタイムで確認できます。

docker compose logs -f

以下のようなログが表示されていれば、各サービスが正常に起動しています。

  • db:ready for connectionsと表示され、MySQLが接続を受け付ける状態になっている
  • api:Uvicorn running on http://0.0.0.0:8000と表示され、APIサーバが起動している
  • front:start worker processと表示され、Nginxが起動している

Ctrl+Cでログの表示を終了します。

特定のサービスのログだけを確認したい場合は、サービス名を指定します。例えば、APIサーバのログだけを確認するには以下を実行します。

docker compose logs api

以下のようにUvicorn running on http://0.0.0.0:8000と表示されていれば、APIサーバが正常に起動しています。

sample-note-api-api-1  | INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)