FlaskとMySQLのDocker連携ガイド

2026年7月23日

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

Contents

1 FlaskとMySQLの連携手順を解説｜Docker環境構築からコード実装まで
2 DockerでMySQLを構築する手順
3 FlaskアプリケーションでのMySQL接続準備
- 3.1 必要ライブラリのインストールと比較表
- 3.2 DB接続設定コードの実装
4 FlaskとMySQLの連携コード構築
- 4.1 ORMによるデータベース操作の導入
5 CRUD操作の実装サンプル
- 5.1 Create機能の実装
6 セキュリティ対策と環境変数の活用
- 6.1 .envファイルの作成と設定例
- 6.2 セキュアな接続設定の実装手順
7 動作確認と今後の拡張案
- 7.1 起動テストの手順とトラブルシューティング
- 7.2 今後の拡張可能性と改善点
8 まとめ

スポンサードリンク

FlaskとMySQLの連携手順を解説｜Docker環境構築からコード実装まで

FlaskアプリケーションとMySQLデータベースを接続する際、Dockerでの環境構築は非常に効率的です。本記事では、Docker ComposeでMySQLコンテナを構築し、Flaskアプリケーション内でデータベース操作を行う一連の手順を具体的に解説します。読者の中には「Dockerとの連携が不安」「セキュリティ対策が分からない」という疑問を持つ方もいるでしょう。この記事を読み終えると、MySQLとの連携環境構築からCRUD操作までスムーズに行えるようになります。

DockerでMySQLを構築する手順

Docker Composeを使用することで、MySQLコンテナの設定は非常にシンプルになります。以下に具体的な手順を示します。

セキュリティとバージョン管理の注意点

MySQLイメージやライブラリ依存関係の最新性には常に気を配りましょう。mysql:8.0は現在の代表的なバージョンですが、将来的に互換性がなくなる可能性があります。定期的に公式ドキュメントで確認してください。

Docker Composeファイルの作成

MySQLコンテナを起動するには、docker-compose.ymlを作成します。このファイルでは、ポート設定や環境変数を指定できます。以下のコード例を参考にしてください。

version: '3.8'

services:
  db:
    image: mysql:8.0
    container_name: mysql_db
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: flask_db
      MYSQL_USER: flask_user
      MYSQL_PASSWORD: flask_pass
    ports:
      - &quot;3306:3306&quot;
    volumes:
      - db_data:/var/lib/mysql
    networks:
      - app_network

volumes:
  db_data:

networks:
  app_network:

version: '3.8'

services:

db:

image: mysql:8.0

container_name: mysql_db

environment:

MYSQL_ROOT_PASSWORD: rootpass

MYSQL_DATABASE: flask_db

MYSQL_USER: flask_user

MYSQL_PASSWORD: flask_pass

ports:

- "3306:3306"

volumes:

- db_data:/var/lib/mysql

networks:

- app_network

volumes:

db_data:

networks:

app_network:

この設定では、MySQLのルートパスワードをrootpassとして定義し、Flaskアプリケーションが使用するデータベース名やユーザー情報も指定しています。ポート3306をホスト側とコンテナ内で同じにすることで、外部から接続が可能になります。

MySQLコンテナの起動確認

Docker Composeファイルを作成したら、以下のコマンドでコンテナを起動します。

docker-compose up -d

1 2	docker-compose up -d

起動後の確認手順

MySQLサーバーの接続テスト: mysql-clientを使用して接続を確認しましょう。

docker run --rm mysql:8.0 mysql -h localhost -u flask_user -pflask_pass -e &quot;SHOW DATABASES;&quot;

1 2	docker run --rm mysql:8.0 mysql -h localhost -u flask_user -pflask_pass -e "SHOW DATABASES;"

このコマンドでデータベース一覧が表示されれば、MySQLコンテナの構築は完了です。

エラーメッセージ対応: Access deniedなどが出た場合は、パスワードやユーザー名を確認してください。

FlaskアプリケーションでのMySQL接続準備

Flaskアプリケーションでは、pymysqlやflask-mysqldbを使用してMySQLに接続します。以下に必要な手順を紹介します。

必要ライブラリのインストールと比較表

選択肢

flask-mysqldb: データベース設定を簡潔に管理できます。
pymysql: 低レイヤーなSQL操作が必要な場合に利用。

ライブラリ名	特徴	導入コマンド
`flask-mysqldb`	Flaskと連携しやすい	`pip install flask-mysqldb`
`pymysql`	SQL操作が自由度が高い	`pip install pymysql`

DB接続設定コードの実装

MySQLと接続するためには、以下のようなコードをFlaskアプリケーションに記述します。

from flask import Flask
from flask_mysqldb import MySQL

app = Flask(__name__)

# MySQL設定
app.config['MYSQL_HOST'] = 'localhost'
app.config['MYSQL_USER'] = 'flask_user'
app.config['MYSQL_PASSWORD'] = 'flask_pass'
app.config['MYSQL_DB'] = 'flask_db'
mysql = MySQL(app)

from flask import Flask

from flask_mysqldb import MySQL

app = Flask(__name__)

# MySQL設定

app.config['MYSQL_HOST'] = 'localhost'

app.config['MYSQL_USER'] = 'flask_user'

app.config['MYSQL_PASSWORD'] = 'flask_pass'

app.config['MYSQL_DB'] = 'flask_db'

mysql = MySQL(app)

このコードでは、app.configにMySQLの接続情報を設定し、MySQL(app)で初期化しています。これにより、Flaskアプリケーション内から簡単にデータベース操作が可能になります。

注意事項:

実際に運用する際は、セキュリティ対策として.envファイルで環境変数を使用してください（後述）。
パスワードなど機密情報はコード内でハードコーディングしないようにしましょう。

FlaskとMySQLの連携コード構築

MySQLとの連携を確立したら、モデルクラスやルーティングを実装することで具体的な操作を行うことができます。

ORMによるデータベース操作の導入

Flask-Mysqldbでは直接SQLクエリを発行することも可能ですが、ORMを使用するとデータベース操作がシンプルになります。以下にflask-sqlalchemyを使った簡単なモデル例を示します。

from flask_sqlalchemy import SQLAlchemy

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://flask_user:flask_pass@localhost/flask_db'
db = SQLAlchemy(app)

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(100), nullable=False)
    email = db.Column(db.String(150), unique=True, nullable=False)

    def __repr__(self):
        return f'&lt;User {self.name}&gt;'

from flask_sqlalchemy import SQLAlchemy

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://flask_user:flask_pass@localhost/flask_db'

db = SQLAlchemy(app)

class User(db.Model):

id = db.Column(db.Integer, primary_key=True)

name = db.Column(db.String(100), nullable=False)

email = db.Column(db.String(150), unique=True, nullable=False)

def __repr__(self):

return f'<User {self.name}>'

このコードでは、Userモデルを定義し、データベースに保存される項目（id、name、email）を設定しています。また、__repr__メソッドでオブジェクトの文字列表現を指定します。

導入時の手順

pip install flask-sqlalchemyでインストール。
データベースURIを正しく設定する。
モデルクラスを定義し、CRUD操作に使用する。

CRUD操作の実装サンプル

Flaskアプリケーション内でCRUD（作成・読み取り・更新・削除）機能を実装するには、以下のエンドポイントを作成します。

Create機能の実装

新しいユーザーをデータベースに追加するPOST /usersエンドポイントです。以下のようにリクエストボディからデータを受け取って保存できます。

from flask import request

@app.route('/users', methods=['POST'])
def create_user():
    data = request.get_json()
    new_user = User(name=data['name'], email=data['email'])
    db.session.add(new_user)
    db.session.commit()
    return {'message': 'User created successfully'}, 201

from flask import request

@app.route('/users', methods=['POST'])

def create_user():

data = request.get_json()

new_user = User(name=data['name'], email=data['email'])

db.session.add(new_user)

db.session.commit()

return {'message': 'User created successfully'}, 201

このコードでは、request.get_json()で送信されたデータを取得し、Userモデルのインスタンスを作成して保存します。

実装時のポイント:

バリデーション（例: 電子メール形式チェック）が必要な場合は、追加ロジックを挿入。
エラーハンドリングも忘れずに実装してください。

セキュリティ対策と環境変数の活用

アプリケーション内でDB接続情報（ユーザー名やパスワード）を硬编码するとセキュリティリスクがあります。それを避けるために、.envファイルを使用して情報を管理します。

.envファイルの作成と設定例

プロジェクトルートに.envを作成し、以下のように環境変数を定義します。

MYSQL_HOST=localhost
MYSQL_USER=flask_user
MYSQL_PASSWORD=flask_pass
MYSQL_DB=flask_db

MYSQL_HOST=localhost

MYSQL_USER=flask_user

MYSQL_PASSWORD=flask_pass

MYSQL_DB=flask_db

このようにしてDB接続情報は外部から読み込むことで、セキュリティ対策が強化されます。

セキュアな接続設定の実装手順

.envファイルを読み込むには、python-dotenvライブラリを使用します。以下のようにインストール・初期化してください。

pip install python-dotenv

1 2	pip install python-dotenv

from dotenv import load_dotenv
import os

load_dotenv()
app.config['MYSQL_HOST'] = os.getenv('MYSQL_HOST')
app.config['MYSQL_USER'] = os.getenv('MYSQL_USER')
# 他の設定も同様に読み込む

from dotenv import load_dotenv

import os

load_dotenv()

app.config['MYSQL_HOST'] = os.getenv('MYSQL_HOST')

app.config['MYSQL_USER'] = os.getenv('MYSQL_USER')

# 他の設定も同様に読み込む

このようにすることで、DB接続情報はコード内に含まれず、外部ファイルで管理できるようになります。

導入のメリット:

デプロイ時に秘密情報を漏らさない。
環境ごとの設定（開発・本番）を柔軟に切り替え可能。

動作確認と今後の拡張案

構築したアプリケーションが正しく動作するかを確認し、今後の拡張性についても検討しましょう。

起動テストの手順とトラブルシューティング

Dockerコンテナを起動し、Flaskアプリケーションを実行してアクセスします。以下のコマンドで起動できます。

docker-compose up -d
python app.py

docker-compose up -d

python app.py

ブラウザでの確認

http://localhost:5000/usersにアクセスすると、ユーザーの一覧が表示されるはずです。
エラー処理: パスワードや接続情報のミスなどがあれば、コンテナログ(docker-compose logs)を確認してください。

今後の拡張可能性と改善点

提案事項

認証機能（JWTやOAuth）の追加。
データベース操作にトランザクションを導入。
ロギングの整備: アプリケーションの動作状況を可視化する。
Docker Composeの拡張: RedisやNginxなどのコンテナを追加。

改善例

flask-sqlalchemyではなく、より柔軟なORM（例: SQLAlchemy Core）を使用。
Dockerイメージのバージョン管理にlatestタグではなく、固定バージョンで指定する（例: mysql:8.0.32）。

まとめ

本記事では、FlaskアプリケーションとMySQLデータベースをDocker環境で連携する一連の手順について解説しました。具体的には以下をカバーしています：

Docker ComposeでのMySQLコンテナ構築
pymysqlやflask-mysqldbのインストールと設定
Flaskアプリケーション内でのDB接続コード実装
CRUD機能のエンドポイント設計
セキュリティ対策として環境変数の活用

これらを参考に、自らDockerでFlaskとMySQLの連携環境を作成し、データベース操作を試してみてください。実践することで理解が深まり、開発効率も向上します。

スポンサードリンク

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

-Flask

comment コメントをキャンセル

: Flask

Flask 3.0 リリース概要と実務向け移行ガイド – 中級開発者向け解説

Flask 3.0 は Python 3.9+ を必須とし、例外伝搬設定や依存関係警告が強化された実務向け LTS 版です。本稿では新機能の解説と安全な移行手順を提供します。

: Flask

FlaskでJWT認証とLogto連携：Access/Refreshトークン・RBAC実装ガイド

本記事では、Flask‑JWT‑Extended と Logto SDK を組み合わせて、Access/Refresh トークンの生成・管理、カスタムクレームでロールベースアクセス制御（RBAC）を実装する手順を詳しく紹介します。トークンリフレッシュやブラックリストによるログアウト処理、最新のセキュリティ対策も網羅しています。

: Flask

Flask API 作成手順と環境構築ガイド (Python 3.12)

ローカルで Flask API を作成するための開発環境準備からコード構造、バリデーション実装、テスト自動化、コンテナ化までをステップ別に解説します。

: Flask

FlaskアプリをHerokuにデプロイする手順｜初心者向け完全ガイド

本記事ではFlaskアプリをHerokuにデプロイするステップバイステップガイドを紹介。アカウント作成からGit送信、WSGIサーバー構築まで初心者向けに解説します。

: Flask

Flask本番環境デプロイ: Heroku・Render・PythonAnywhereによる無料手順

Heroku・Render・PythonAnywhereでFlaskアプリを無料公開する方法を解説。Procfile設定やGitプッシュ、WSGIサーバー構築まで5分で完了可能な手順を紹介します。

乗換NAVITIMEの乗降アラーム設定方法と活用術【Android・iPhone】

iPhone Pro LiDAR & Polycam: Free vs Pro Comparison