アプリケーションの起動
このページで扱う手順で、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)