メインコンテンツへスキップ
見出し画像

【40代の学び直し】10分で建てるコンテナDB。手動構築から脱却するローカル開発 | 40代マネージャーのDocker学習録 vol.7

    はじめに

    私は、中堅SIerに所属し、大手企業の業務アプリ開発プロジェクトにてマネージャーを務める。元々はIBMホストでCOBOLの業務アプリに携わっていたが、いまでは、オープン系でサーバーサイドをJavaで構築するフロント業務アプリを担当する。最近では、クラウドサービス上に構築するクラウドネイティブなフロント業務アプリ開発も携わるようになった。この間、Dockerコンテナが誕生し、業務アプリの形(フレームワーク)も変わり、開発環境も変わっている。その中で、業務アプリ開発では欠かせない、データベースについて、とくに、手元の開発用PCにおける単体試験環境構築について、私が携わるプロジェクトを例に、その実例を紹介したい。

    ■この連載を最初から読みたい方■
    vol.1 【40代の学び直し】Ubuntu断念からopen.Yellow.osへ。中古PCで始めるLinux生活

    ■Windowsユーザー向け環境構築■
    vol.3.5 【Windowsユーザー向け】Docker Engineを選ぶ実践的理由と導入手順

    ■前回の記事■
    vol.6 【40代の学び直し】コンテナは「使い捨て」が常識。破棄してもデータが残る仕組みを動かして検証

    コンテナ以前の環境構築

    Dockerコンテナが登場する以前、そしていまもまだ残っている、開発用PCでの単体試験環境におけるデータベースの準備について、比較のために、記しておく。

    端的にいえば、開発用PCにDBRMソフトウェア(Oracle、DB2、MySQL、PostgreSQL等)を直接インストールする。

    インストールは、配布されたインストーラ(とくにセキュリティの厳しい環境では、事前にダウンロードされたインストーラをファイル共有サーバ経由で配布する)をもとに、インストール手順書をもとに各自がインストールを行う。Oracleを例にすると、インストーラー実行時に表示されるGUI画面の案内にしたがって、インストールを実施していく。さらに、データベースを作成し、リスナーを定義する。ユーザー(≒スキーマ)を登録し、テーブルスペースを割り当てる。最後に、プロジェクトのリポジトリ(主にSVN)からダウンロードしたDDLをもとに、テーブルを作成する。これで準備完了。ようやく業務アプリを担当するSEとしての仕事が始まる。

    ここまで順調にいけば、1〜2時間程度。慣れている人はそこまでかからないだろうが、慣れていない人であれば半日、下手したら予期せぬエラーにあたって1日を消費することもある。さらに、管理側の視点でいえば、開発業務の進捗に寄与しない作業に、各メンバーがかかり、さらに、インストール等の構築作業がうまく行かなかったときのフォローでベテランSEやときには自身の時間を奪われる。

    メンバーにつき1回の儀式であるが、なかなかに重い。

    だから、私個人としては、この作業に対してあまりいい印象はない。しかしながら、不要ではないので、新規参画要員の着任時には、その作業を組み込んで計画を立てている。

    Dockerコンテナ登場で変わるデータベース構築

    DockerコンテナアプリをKubernetesで運用・管理する、クラウドネイティブな業務アプリ構築プロジェクトで、経験(というか導入)したのが、データベースのコンテナ化である。

    Windows11のWSL2+Ubuntu環境にてDockerコンテナのデータベースイメージを使って、データベース環境を開発用PC上に構築するのだ。以下のコマンドは、OSSのmariaDBのデータベースを構築したときのコマンド例である。(Linux環境でも同様)

    $ cd ~
    $ mkdir database
    $ chmod 777 database
    $ docker run -d --name myMariaDb \
    -e MARIADB_USER=KYONSTYLE \
    -e MARIADB_PASSWORD=P@ssw0rd \
    -e MARIADB_DATABASE=testDb \
    -e MARIADB_ROOT_PASSWORD=P@ssw0rd \
    -e TZ=Asia/Tokyo \
    -p 3306:3306 \
    -v ~/database:/var/lib/mysql \
    mariadb:13.1.1-ubi10-rc

    コマンド手順でなにをやっているのか

    上記では、以下①〜④を実施している。
    ①ホームディレクトリ(Windowsでは、WSL2上のUbuntuのホームディレクトリ)に移動(cd ~)
    ②「database」ディレクトリ作成(mkdir database)
    ③「database」ディレクトリの権限を『誰でも操作できる』に変更(chmod 777 database)
    ④mariaDBのコンテナ「myMariaDb」を作成し、起動(docker run)

    これにより、10分ほどで、mariaDBのデータベース「testDb」が構築される。あとは、SQLクライアントソフト(DBeaver等)からlocalhost:3306のURLでアクセスして、DDLを実行することで、目的とするで環境が構築できる。

    docker runのオプション「-e」について

    ④コマンドでは、過去のdocker run解説vol.05にて対象としなかった、環境変数を設定する「-e」オプションがあるので、簡単に解説する。
    定義は以下のとおりである。

    -e [環境変数名]=[環境変数の値]

    ④コマンドでは、以下の環境変数を設定している。

    環境変数名値設定内容MARIADB_USERKYONSTYLE初期登録するユーザー名MARIADB_PASSWORDP@ssw0rd登録ユーザーのパスワードMARIADB_DATABASEtestDb実行時に作成するDB名MARIADB_ROOT_PASSWORDP@ssw0rd管理者ユーザーのパスワードTZAsia/Tokyoシステム日付のタイムゾーン\newcommand{\arraystretch}{1.5} % \begin{array}{|l|l|l|} \hline \mathbf{環境変数名} & \mathbf{値} & \mathbf{設定内容} \cr \hline \textsf{MARIADB\_USER} & \textsf{KYONSTYLE} & \textsf{初期登録するユーザー名} \cr \hline \textsf{MARIADB\_PASSWORD} & \textsf{P@ssw0rd} & \textsf{登録ユーザーのパスワード} \cr \hline \textsf{MARIADB\_DATABASE} & \textsf{testDb} & \textsf{実行時に作成するDB名} \cr \hline \textsf{MARIADB\_ROOT\_PASSWORD} & \textsf{P@ssw0rd} & \textsf{管理者ユーザーのパスワード} \cr \hline \textsf{TZ} & \textsf{Asia/Tokyo} & \textsf{システム日付のタイムゾーン} \cr \hline \end{array}

    「-v」オプションによるバインドマウントと注意ポイント

    その他、④コマンドでは、「-v」オプションにより、PCのローカルディレクトリ(~/database)と、データベースのデータ格納先(/var/lib/mysql)を共有し、コンテナ経由で登録したデータベースのデータをローカル上に格納できる。

    ここで、1点、注意ポイントが③コマンドである。
    これは、データベースのデータを保管するディレクトリ(~/database)を、『誰でも操作できる』状態にするコマンドである。実は、この手順を省いてしまうと、コンテナは作成されるものの、実行に失敗する。「docker logs」コマンドでログを見ると以下のようなエラーが発生している。

    $ docker logs myMariaDb
    (中略)
    2026-10-12  1:25:53 0 [Warning] Can't create test file '/var/lib/mysql/b6992c5634a4.lower-test' (Errcode: 13 "Permission denied")
    2026-10-12  1:25:53 0 [ERROR] mariadbd: Can't create/write to file './ddl_recovery.log' (Errcode: 13 "Permission denied")
    2026-10-12  1:25:53 0 [ERROR] DDL_LOG: Failed to create ddl log file: ./ddl_recovery.log
    2026-10-12  1:25:53 0 [ERROR] Aborting

    権限エラー(Permission denied)によりデータベースで利用するファイルが作成できない、というエラーである。つまり、MariaDBのコンテナ「myMariaDb」内でデータベース作成を操作するユーザーが、databaseディレクトリ内へ各種ファイルを作成しにいこうとして、捜査権限がなくてエラーとなった、というものである。

    これを回避するために、『誰でも操作できる』権限(777)をdatabaseディレクトリに対して与えるのである。正直、セキュリティ観点からはあまりよい解決方法ではない。あくまで暫定的な処置である。

    【コラム①】データ永続化の選択肢(バインドマウント/ボリュームマウント)

    vol.4、vol.5でも「-v」オプションによるデータ永続化を紹介してきた。これは、ローカルディレクトリと、コンテナ内のディレクトリを共有する方式である。このデータ永続化の方式を正式には、バインドマウントと呼ぶ。対して、コンテナ内のディレクトリにホストPCのDocker専用のボリュームをマウントする方式「ボリュームマウント」がある。

    ボリュームマウントを使ったデータ保管

    ボリュームマウントでのデータ永続化設定は、以下のとおりとなる。

    $ docker volume create myMariaDb-vol
    $ docker run -d --name myMariaDb (中略) -v myMariaDb-vol:/var/lib/mysql mariadb:13.1.1-ubi10-rc

    ※中略の部分は、前述のコマンドのとおりである。

    上のコマンドではなにをしているのか。Docker専用のボリューム(myMariaDb-vol)を作成し、そのボリュームに、データベース格納先(/var/lib/mysql)にマウントしている。

    ボリュームマウントの場合は、「-v」オプションの定義は以下のとおりとなる。

    -v [ボリューム名]:[共有対象のコンテナディレクトリパス]

    バインドマウントとボリュームマウントの違い

    バインドマウントもボリュームマウントも、コンテナにおけるデータ永続化の方式であるが、以下の違いがある。

    バインドマウントは、ホストPCのローカルディレクトリをマウントしているので、ホストPC側からでもコンテナ側からでも操作できる。

    ボリュームマウントでは、Docker専用ボリューム(myMariaDb-vol)をマウントしており、コンテナ側から操作できるが、ホストPC側からは操作できない。

    どちらを選ぶのがよいか

    過去記事vol.4で構築を紹介したWebサーバーの場合は、バインドマウントがよいと考える。コンテナを止めることなく、静的資材を入れ替えたりするのに、ホストPC側からの操作が必要だから。私の開発現場でもWebサーバーコンテナの静的資材を格納するルートディレクトリは、ストレージサーバーにマウントする方式をとっており、アプリケーション開発者はWebサーバーコンテナ側に触れることなく、ストレージ上の資材をアップロードするだけで資材反映ができるようにしている。

    当記事で紹介しているデータベースの場合は、ボリュームマウントがよいと考える。コンテナ側からしか操作しなく、ホストPC側からの操作が不要だからである。バインドマウントをしてもいいが、該当ディレクトリの権限を緩くしてしまうのはあまりオススメできない。データの安全性の観点からも、ボリュームマウントをオススメする。

    現場との差異

    上記で「ボリュームマウントがオススメ」と評しているが、冒頭で紹介した手順はバインドマウントを選択している。そして、これは実際に私の開発現場の手順そのままである。

    正直、この記事を書くまで疑問に思っていなかったし、現場では手順書かされて、だれも疑問に思っていない状況であった。

    なぜ本来であれば非推奨のこの手順を用いていたのか。これはひとえに、インフラに慣れていないアプリケーション開発担当者にとっての理解のハードルに起因すると推察する。
    すなわち、ボリュームの概念に比べれば、ローカルディレクトリを扱うバインドマウントのほうがハードルが低かったからだと考える。

    私自身も、ボリュームの概念を理解するのに苦労した。

    そのうえで、結局単体試験環境は個人の開発PCでの作業になるので、わかりやすさのほうをあえて選んだ結果だと考える。ここは、複数人が接続する結合試験環境や本番環境において、この考え方を分けておくべき部分であると考える。

    【コラム②】Docker Composeから入るIaCの世界

    さて、上記で紹介している、「docker run」コマンドであるが、みなさまも感じているとおり、非常に長い。数えたら(改行用のバックスラッシュを除いて)230文字あった。vol.4で紹介した、「docker run」コマンドで78文字であるから、約3倍である。こんなに長いと、コマンドとはいえ、入力ミスも頻発しかねない。さらに、可読性も下がるので、コマンドを解読する気持ちも起きないかもしれない。

    ここで、Docker Composeを紹介したい。

    Docker Composeは、本来であれば、複数コンテナを一括で操作・管理するツールである。その定義をcompose.ymlに記述する。今回のような、「docker run」で複数のオプションを指定するケースでも、有効である。実際に、ボリュームマウントにおけるDBコンテナ作成・起動をDocker Composeを使って実行すると以下のとおりとなる。

    まず、compose.yamlを以下のとおり作成する。

    services:
        myMariaDb:
            image: mariadb:13.1.1-ubi10-rc
            ports:
                - "3306:3306"
            volumes:
                - myMariaDb-vol:/var/lib/mysql
            environment:
                - MARIADB_USER=KYONSTYLE
                - MARIADB_PASSWORD=P@ssw0rd
                - MARIADB_DATABASE=testDb
                - MARIADB_ROOT_PASSWORD=P@ssw0rd
                - TZ=Asia/Tokyo
    volumes:
        myMariaDb-vol:

    次に、以下のコマンドで、作成・起動を行う。

    $ docker compose up -d

    長ったらしいコマンドを覚えなくても、このcompose.ymlを配布し、上記の短いコマンドを実行するだけで、メンバー全員が同じDBコンテナ環境を構築することができる。

    ちなみに、停止や起動は以下のコマンドとなる。

    停止:docker compose stop
    起動:docker compose start

    【コラム③】捨てる身軽さが光る、ローカルDBコンテナ運用

    単体試験環境におけるDB構築をコンテナにする魅力は、その構築の手軽さにあるが、もうひとつ、伝えたいことがある。それは、テーブルの再構築が簡単であることになる。

    実際に開発現場で遭遇した事象である。新規開発案件において、データベースの仕様は追々にして変わる。このときも、単体試験が終わりを迎えて、結合試験に入ろうとしていたときに、プロジェクト全体で単体試験環境のテーブル定義の最新化をするよう、依頼が発生した。結合試験前に、手元の検証環境を統一するための自然な動きである。

    この依頼に対して、私たちがとった行動は、
    ①DBコンテナを停止する
    ②マウントしていたディレクトリもしくはボリュームを削除する
    ③マウントするディレクトリもしくはボリュームを再作成する
    ④DBコンテナを起動する
    ⑤テーブル定義(Create Table)を再実行する
    ⑥テストデータ登録(Insert)を再実行する
    であった。

    ものの数分ほどの作業である。


    補足1
    ②のディレクトリorボリュームの削除のコマンドは以下のとおりとなる。

    ディレクトリ削除 ※削除には管理者権限(sudo)が必要

    $ sudo rm -rf ~/database

    ボリューム削除

    $ docker volume rm myMariaDb-vol


    補足2
    コラム②で紹介したDocker Composeの場合ならば、以下のコマンド1発で①~⑤までを実行する。

    $ docker compose down -v && docker compose up

    このコマンドならば、ものの数秒でできてしまうのだ。


    これが、もし、DBをコンテナではなく、開発PCに直接インストールしていた場合、全テーブルをひとつづつDrop Tableして、その後、Create Tableする必要があった。

    それに比べれば、データすらも簡単に捨てて、手軽に再作成できる身軽さをもつコンテナは、従来にはない可能性を秘めていると考える。

    まとめ

    開発現場で実際に運用しているDBコンテナの活用について紹介した。Webサーバーコンテナ構築と違い、実際の開発現場での運用に即したものであり、Webシステム開発に携わる方には参考になったのではないかと思う。

    コンテナは、サーバーを手軽に構築できる、というだけではない。この記事で紹介した通り、開発におけるローカルDB環境構築という面倒な準備作業を簡単に、かつ、短時間で実行できるようにすることで、アプリケーション開発者が本来の開発業務に集中する場を生み出した。これは、チーム全体の生産性の向上や、いやな作業からの解放によるメンバーのモチベーション向上などに寄与していると考える。コンテナは、小さいながらも、確実なパラダイムシフトを、開発現場にもたらしていると考える。

    次回は、Dockerコンテナによって、実際に動くWebアプリケーションを、Webサーバー+APサーバー+DBサーバーの標準構成で実装するところをやってみようと考えている。

    ■前回記事
    vol.6 【40代の学び直し】コンテナは「使い捨て」が常識。破棄してもデータが残る仕組みを動かして検証

    ■マガジン紹介■
    一連の記事をマガジン化しました。他の記事もどうぞ。


    あなたへのおすすめ