アプリケーション層の構築
次に、アプリケーション層となるFastAPIコンテナを構築します。クローンしたリポジトリのapiフォルダにソースコードとDockerfileが用意されています。
| 📝 REST APIとは |
|---|
| REST APIは、HTTPメソッド(GET、POST、PUT、DELETEなど)を使ってデータをやり取りする仕組みです。URLでリソース(データ)を指定し、メソッドで操作を指定します。例えば「GET /notes」でノート一覧を取得、「POST /notes」で新規ノートを作成します。Webアプリケーションでフロントエンドとバックエンドが通信する標準的な方法として広く使われています。 |
1. Dockerfileの確認
api/Dockerfileを開いてみましょう。以下の内容が記述されています。
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY main.py models.py database.py ./
COPY routers/ ./routers/
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
このDockerfileで行っている各命令について、1行ずつ解説します。
FROM python:3.11-slim
ここでは、ベースイメージとしてPython 3.11の軽量版(slim)を使用することを指定しています。slimは不要なパッケージを省いた軽量なイメージで、コンテナサイズを小さくできます。
WORKDIR /app
ここでは、コンテナ内の作業ディレクトリを/appに設定しています。以降の命令(COPY、RUNなど)はこのディレクトリを基準に実行されます。
COPY requirements.txt .
ここでは、ホストマシンのrequirements.txtをコンテナの作業ディレクトリ(/app)にコピーしています。末尾の.は現在の作業ディレクトリを意味します。
RUN pip install --no-cache-dir -r requirements.txt
ここでは、requirements.txtに記載されたライブラリをインストールしています。--no-cache-dirオプションを付けることで、キャッシュを保存せずイメージサイズを削減しています。
COPY main.py models.py database.py ./
COPY routers/ ./routers/
ここでは、アプリケーションのソースコードをコンテナの作業ディレクトリにコピーしています。main.py、models.py、database.pyを作業ディレクトリ直下に、routers/フォルダをサブフォルダごとコピーしています。
EXPOSE 8000
ここでは、コンテナがポート8000で待ち受けることを宣言しています。これはドキュメント的な役割であり、実際のポート公開はdocker runの-pオプションで行います。
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
ここでは、コンテナ起動時に実行するコマンドを指定しています。uvicornサーバを使ってmain.py内のapp(FastAPIアプリケーション)をポート8000で起動します。
2. イメージのビルド
Visual Studio Codeのターミナルからapiフォルダに移動し、Dockerイメージをビルドします。
cd api
docker image build -t api-image .
| オプション | 値 | 説明 |
|---|---|---|
| -t | api-image | イメージに名前を付ける |
| . | - | 現在のディレクトリのDockerfileを使用する |
イメージが作成されたことを確認します。
docker image ls
以下のようにapi-imageが表示されていれば成功です。
REPOSITORY TAG IMAGE ID CREATED SIZE
api-image latest xxxxxxxxxxxx x seconds ago xxx MB
mysql latest xxxxxxxxxxxx x days ago xxx MB
3. コンテナの起動
APIコンテナを起動します。apiフォルダで以下のコマンドを実行します。
Macの場合:
docker container run -d -p 8000:8000 --name api-container \
-v $(pwd):/app \
-e DB_HOST=db-container \
-e DB_USER=noteuser \
-e DB_PASSWORD=notepass \
-e DB_NAME=notedb \
api-image
Windowsの場合(PowerShell):
docker container run -d -p 8000:8000 --name api-container -v ${PWD}:/app -e DB_HOST=db-container -e DB_USER=noteuser -e DB_PASSWORD=notepass -e DB_NAME=notedb api-image
| オプション | 値 | 説明 |
|---|---|---|
| -d | - | バックグラウンドでコンテナを実行する |
| -p | 8000:8000 | ホストの8000番ポートをコンテナの8000番ポートに転送する |
| --name | api-container | コンテナに名前を付ける |
| -v $(pwd):/app | - | 現在のフォルダをコンテナの/appにバインドマウントする |
| -e DB_HOST | db-container | 接続先のデータベースコンテナ名 |
| -e DB_USER | noteuser | データベース接続用のユーザ名 |
| -e DB_PASSWORD | notepass | データベース接続用のパスワード |
| -e DB_NAME | notedb | 接続先のデータベース名 |
| 💡 ポイント |
|---|
-v $(pwd):/appでバインドマウントすることで、現在のフォルダ(apiフォルダ)がコンテナ内の/appにマウントされます。ソースコードを変更した場合、コンテナを再起動すると変更が反映されます。 |
コンテナが起動していることを確認します。
docker container ls
STATUSがUpになっていれば、コンテナは正常に起動しています。
4. APIの動作確認
APIコンテナの起動状況をログで確認します。
docker container logs api-container
以下のように、Database connection attempt N/30 failed: ...Name or service not known が繰り返し出力されます。
Database connection attempt 1/30 failed: (pymysql.err.OperationalError) (2003, "Can't connect to MySQL server on 'db-container' ([Errno -2] Name or service not known)")
Database connection attempt 2/30 failed: (pymysql.err.OperationalError) (2003, "Can't connect to MySQL server on 'db-container' ([Errno -2] Name or service not known)")
この時点では、APIコンテナとDBコンテナは同じネットワークに属していないため、db-container という名前が解決できずデータベースへの接続に失敗しています。api/main.py の lifespan ハンドラでDB接続を30回リトライする実装のため、DBに繋がるまでFastAPIの起動が完了せず、curl http://localhost:8000/health も応答を返しません。
次の見出しでネットワークを設定し、コンテナ間通信を可能にすることで、この接続失敗が解消されます。