Flask+Docker

概要
#

これまでの内容をまとめて、Flask を Docker コンテナ上で動かします。単なる一つのファイルで終わるプログラムではなく、複数の設定ファイル、スクリプトファイルから構成されることになります。そのため、1つのディレクトリを作成し、その中に必要なファイルを配置することにします。

ディレクトリ構成
#

Flaskで作成した hello_rest2.py を Docker コンテナ上で動かすことを考えます。以下のディレクトリ構成を考えます。

hello-rest-app/
├── README.md        # このアプリケーションの説明。何をするものであるのかの1行は最低限書きましょう。
├── Dockerfile       # これから作成していきます。Docker イメージを構築するための設定ファイルです。
├── requirements.txt # これから作成していきます。Python パッケージの依存関係を記述します。
├── compose.yml      # これから作成していきます。Docker コンテナを管理するための設定ファイルです。
└── app/
    └── app.py       # hello_rest2.py を app.py にファイル名を変更しました。

`README.md`
#

Markdown という形式で書きます。基本的にテキスト形式に、リンクや画像を埋め込むことができます。行頭の # で見出し、- で箇条書きを表現できます。詳細は以下のリンクを参照してください。

Markdownk記法と書き方

`Dockerfile`
#

まずは、Docker イメージを構築するための Dockerfile を作成します。

# Dockerのベースイメージを指定する。
FROM python:3

# コンテナイメージでの作業ディレクトリを指定する。
WORKDIR /app
USER nonroot

# Flask に必要なパッケージを列挙したものをコンテナ内にコピーする。
COPY ./requirements.txt /app

# Flask に必要なパッケージをコンテナ内にインストールする。
# 実行するのはコンテナOS内であるため、pip3 ではなく pip で実行する。
RUN    pip install --upgrade pip \
    && pip install -r requirements.txt

`requirements.txt`
#

次に、Python パッケージの依存関係を記述する requirements.txt を作成します。

# requirements.txt
# flask の最新バージョンを指定する。
flask == 3.0.3

`compose.yml`
#

Docker コンテナを管理するための compose.yml を作成します。

services:
  app:                          # サービス名
    container_name: "hello"     # コンテナ名
    build:
      context: .                # Dockerfile のあるディレクトリ
      dockerfile: Dockerfile    # Dockerfile のファイル名
    ports:                      # ポート番号を設定する。
      - "5001:5001"             # ホスト側のポート:コンテナ側のポート
    volumes:
      - ./app:/app              # ホスト側のディレクトリ:コンテナ側のディレクトリ
    command: python /app/app.py # コンテナ起動時に、コンテナ内で実行するコマンド。python3 ではなく、python で実行する。

実行する
#

Flaskで作成した hello_rest2.py を hello-rest-app/app/app.py にコピーし、hello-rest-app ディレクトリに移動します。これで、hello-rest-app ディレクトリには以下のファイルが存在します。

README.md
Dockerfile
requirements.txt
compose.yml
app/app.py

このとき、docker compose up を実行すると、hello-rest-app ディレクトリ内のファイルを読み込み、Docker コンテナが起動します。 http://localhost:5001/ にアクセスすると、Hello, REST World! というメッセージが表示されることを確認してください。また、flask で作成した hello_rest2.py と同じような URL にアクセスして、期待通りの結果が表示されることを確認してください。

概要#

ディレクトリ構成#

README.md#

Dockerfile#

requirements.txt#

compose.yml#

実行する#