アプリケーション層の構築

次に、アプリケーション層となる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 も応答を返しません。

次の見出しでネットワークを設定し、コンテナ間通信を可能にすることで、この接続失敗が解消されます。