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

【40代の学び直し】設定なしだとどうなるのか。「docker run」主要オプションを動かして検証 | 40代マネージャーのDocker学習録 vol.5

    はじめに

    40になり、中堅SIerのマネージャー職を配している私だが、昨今の基礎技術を学ぶ中で、Dockerに魅了された(vol.2「【40代の学び直し】「テストで動くのに本番で動かない」を解決。「Docker」に魅了された理由)。現在、概要を把握するだけでなく、実際に動くモノを作っていくことで、開発現場に取り残されない知識を身につけようとしている。前回のvol.4「【40代の学び直し】まずは動かして感動。10分でつくるDocker Webサーバー構築」ではWebサーバー構築に挑戦した。今回の記事では、その記事の中で登場した docker run コマンドを対象に、特に概要しか触れなかったオプションについて、その動きを解説するものである。

    他の入門記事に比べれば、全然網羅的ではない。しかしながら、docker run コマンドの中でも実務でも頻出する重要なオプションを実際に動かしたログとともに、徹底的に検証・解説している。よって、教科書的ではないものの、忙しい方にとっては最も効率よく「動く仕組み」を体感できるガイドとなるとはずだ。

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

    ■前回の記事■
    vol.4 【40代の学び直し】まずは動かして感動。10分でつくるDocker Webサーバー構築

    今回解説するコマンド

    この記事で解説するコマンドは以下である。

    $ docker run -d --name web -p 80:80 -v .:/usr/local/apache2/htdocs httpd:latest

    ちなみに、実行環境は、前回の記事と同様、私のノートPC(OS:open.Yellow.os)である。

    各オプションの意味と設定しないときの挙動

    docker run とオプション「-d」

    まずは、基本である「docker run」コマンドと、付随する「-d」オプションについてである。
    「docker run」コマンドの一般的な構文は以下である。

    docker run [オプション] [コンテナイメージ] [実行コマンド]

    「docker run」は、指定する「コンテナイメージ」から、実際に動くコンテナの実体を生成し、実行するコマンドである。

    よって、必須なのは「コンテナイメージ」である。今回の解説コマンドでいうと「httpd:latest」となる。  
    「オプション」と「実行コマンド」部分は必須ではない。今回の解説コマンドでも「実行コマンド」はない。サーバープログラムのコンテナであれば、「実行コマンド」を設定しないケース多い。

    「オプション」について、まずは「-d」オプションについて、解説する。

    意味は、docker runコマンドの結果、生成するコンテナをバックグラウンドで実行する、である。

    バックグラウンドで実行する、とはどういうことか。

    まず、端末(ターミナル)で、「-d」オプション付きで実行すると以下のとおりとなる。

    $ docker run -d httpd:latest
    934de9d1f99826401f543bf26d6a303ffd4a8ca08ae2ec43ca81a847b6e6a5df
    $
    画像
    図1.「-d」オプション付きコマンド実行後のターミナル状態

    前回記事の時点でも同じだが、コマンド実行後、端末(ターミナル)が、コマンドを受け付けてくれる状態となっている。これが「バックグラウドで実行する」状態である。

    では、「-d」オプションをつけない場合はどのようになるのか。実行すると以下のとおりである。

    $ docker run httpd:latest
    AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 172.17.0.3. Set the 'ServerName' directive globally to suppress this message
    AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 172.17.0.3. Set the 'ServerName' directive globally to suppress this message
    [Sat Sep 05 00:50:07.612925 2026] [mpm_event:notice] [pid 1:tid 1] AH00489: Apache/2.4.68 (Unix) configured -- resuming normal operations
    [Sat Sep 05 00:50:07.614008 2026] [core:notice] [pid 1:tid 1] AH00094: Command line: 'httpd -D FOREGROUND'
    画像
    図2.「-d」オプションなしコマンド実行後のターミナル状態

    「docker run」コマンド実行後、実際に動くWebサーバー(Aapche HTTP Server)プログラムのログが表示された状態となる。この状態では、端末(ターミナル)はコマンドを受け付けてくれない。

    サーバープログラムにおいて、実行後、ログを常に表示させたい場合はよいが、基本はそうではない。サーバープログラムを実行中に、別の操作を実施したいのが常である。よって、「-d」オプションをつけることをオススメする。

    オプション「--name web」

    ここでは、「web」と名前をつけている。これをすると何が嬉しいのか。
    コンテナは、生成・起動するだけでなく、使わないときは停止したり、再起動したり、不要になったら削除したり、と各種操作を行う。それら操作を行うためのコマンドがdockerにも備わっているが、その際に、コンテナを示す「なにか」が必要である。dockerコンテナでは以下の2つが用意されている。

    項目概要CONTAINER IDコンテナに自動付与されるID(12桁の英数字)NAMESコンテナに付与できる名前。任意に設定可能。\newcommand{\arraystretch}{1.5} % \begin{array}{|l|l|} \hline \mathbf{項目}&\mathbf{概要}\cr \hline \textsf{CONTAINER ID}&\textsf{コンテナに自動付与されるID(12桁の英数字)}\cr \hline \textsf{NAMES}&\textsf{コンテナに付与できる名前。任意に設定可能。}\cr \hline \end{array}

    ここで、「NAMES」を指定するのが、「--name」オプションである。

    では、設定した場合、しない場合でそれぞれで見てみよう。

    ① $ docker run -d --name web httpd:latest
    ② $ docker run -d httpd:latest

    実行したコンテナの状態を見ると以下のとおりである。

       $ docker container ls -a
       CONTAINER ID   IMAGE          COMMAND              CREATED          STATUS          PORTS     NAMES
    ① 428e5b0e85fd   httpd:latest   "httpd-foreground"   29 seconds ago   Up 28 seconds   80/tcp    web
    ② 5af82e1c93ff   httpd:latest   "httpd-foreground"   18 seconds ago   Up 17 seconds   80/tcp    quirky_dewdney

    便宜上、①②をつけた。①では、コンテナの「NAMES」に設定した「web」が設定されている。対して、設定していない②では、コンテナの「NAMES」に、自動生成された名前がついている。

    たとえば、起動したコンテナを停止する場合は、「NAMES」を指定すると以下のようになる。

    ① $ docker container stop web
    ② $ docker container stop quirky_dewdney

    もしくは、「CONTAINER ID」を指定すると以下のようになる。

    ①' $ docker container stop 428e5b0e85fd
    ②' $ docker container stop 5af82e1c93ff

    「NAMES」を指定するのがわかりやすい。その指定する名前が、自分が指定した名前か、自動で指定された名前かで、操作するときの障壁が大きく違うと考える。個人的の感覚として、②は「CONTAINER ID」と変わらない。

    また、今回は、Webサーバー1つの構築だけだからよいが、複数のコンテナを立ち上げて、アプリケーションを構成していくとき、自身で名前をつけていないと、コンテナ管理が煩雑になってしまう。

    それらを含めて考慮すると、「--name」で任意の名前をつけるのをオススメする。

    1点、注意ポイントがある。「--name」で設定する名前は、自由につけていいのだが、必ずユニークである必要がある。すでに「web」という名前でコンテナを作成しているのに、別に「web」というコンテナを作成しようとすると、エラーとなってしまう。コンテナ作成前に、「docker container ls -a」(停止しているものも含めてすべてのコンテナを表示するコマンド)にて、同じ名前をつけようとしていないか確認するクセをつけることをオススメする。

    オプション「-p 80:80」

    「-p」オプションは、ホストPCの指定ポート番号へのリクエストを、コンテナの指定したポート番号に転送する、である。

    画像
    図3.ネットワーク接続図

    「-p」オプションの構文は以下のとおりである。

    -p [ホストPCのポート番号]:[コンテナのポート番号]

    よって、今回のコマンドにおける「-p 80:80」は、ホストPC(=ノートPC)に80番ポートへの接続(=http通信)を、コンテナの80番ポート(=http通信)に転送する、という意味となる。
    これがないと、外部からノートPCに接続したとしても、コンテナ側のWebサーバーに接続できない、という状況になる。

    まずは、設定した場合で見てよう。

    $ docker run -d --name web -p 80:80 httpd:latest

    前回記事でも実施したように、スマホから、ノートPCに接続すると以下のように表示される。

    画像
    図4.スマホからWebページ表示①

    次に、設定しない場合で見てみよう。

    $ docker run -d --name web httpd:latest

    同様に、スマホから、ノートPCに接続してみたが、以下のように表示することができない。

    画像
    図5.スマホから接続できなかった結果

    このように、ホストPCでサーバーを構築するならば、「-p」オプション指定は必要となってくる。

    オプション「-v .:/usr/local/apache2/htdocs」

    「-v」の意味は、「ホストPC側のディレクトリと、コンテナ側のディレクトリを共有する」、である。

    「-v」オプションの構文は以下のとおりである。

    -v [ホスト側のディレクトリパス(相対パス/絶対パス)]:[コンテナ側のディレクトリパス(絶対パス)]

    コンテナは、共有したホストPC側のディレクトリに対して、自身の共有したディレクトリと同じように、ファイルを参照したり、操作したりすることができる。

    よくあるのは、データベースコンテナで、データ本体の保管場所をホストPCディレクトリと共有することで、コンテナを削除してもデータを保持することができる。データの永続化という。

    今回のWebサーバーコンテナの場合、表示するWebページの資材(HTML/CSS/Javascript)を保管するホストPC側のディレクトリを共有した。自身の表示したいHTMLファイルの格納ディレクトリ(.)を、Webサーバー(Apache HTTP Server)が表示する資材を配置するディレクトリ(ドキュメントルート=/usr/local/apache2/htdocs)を共有している。

    実際に、設定している場合と、設定しない場合とで、スマホからノートPCにアクセスしたときの表示を見てみる。

    まずは、設定している場合を見てみよう。

    $ docker run -d --name web -p 80:80 -v .:/usr/local/apache2/htdocs httpd:latest
    画像
    図6.スマホからWebページ表示②

    自身が用意したWebページの内容が表示された。

    次に、設定しない場合を見てみよう。

    $ docker run -d --name web -p 80:80 httpd:latest
    画像
    図4.スマホからWebページ表示①

    「-p」オプション説明のときにも示したとおり、Webサーバー(Apache HTTP Server)コンテナが最初から用意されていたHTMLページ(It works!)が表示された。

    この状態で、自身のWebページを表示させようとするならば、コンテナ内のディレクトリに、自身のHTMLファイルを配置する必要がある(WebサーバへFTPツールでファイルを配置するみたいに)。面倒くさい。

    【コラム】コンテナ内のドキュメントルートの調べ方

    Webサーバーコンテナのドキュメントルート(/usr/local/apache2/htdocs)は、コンテナイメージごとに違う。私の場合は、事前にコンテナを作ってみて、コンテナ内の設定ファイルを確認して調べる。

    これは「サーバーに入って設定を見る」という当たり前の作業である。

    アプリケーション開発経験者ならば、テスト環境や本番環境でエラーが起きたときに、サーバーにログイン(SSH等)し、アプリケーションサーバーのログや時には設定ファイルを確認したりして、障害原因調査をした経験が一度はあるはずだ。それは開発者にとってごく普通の、日常的な作業である。

    実は、Dockerコンテナになってもこの本質は何も変わらない。「サーバーの中に入ってログや設定を確認する」というおなじみの調査作業が、Dockerの世界では、「docker exec」というコマンドでの作業に置き換わっただけである。

    そう考えてみると、新しいようで、Dockerも本質的なところは変わらず、いままでと同じ、身近な存在に感じられないだろうか。

    さて、それでは、実際にWebサーバーコンテナを立ち上げ、「中に入って」設定ファイルを確認してみよう。

    $ docker run -d --name web httpd:latest

    「docker exec」コマンドを利用して、立ち上げたコンテナ内にてコマンド入力を行い、Webサーバーコンテナの設定ファイルを確認していく。

    まずは、カレントディレクトリを確認する。

    $ docker exec web pwd      
    /usr/local/apache2

    カレントディレクトリを起点に、設定ファイル(confディレクトリ配下)を探す。(「docker exec」コマンドではカレントディレクトリを変更するcdコマンドが使えない)

    $ docker exec web ls -l
    total 0
    drwxr-xr-x 1 root root  268 Aug 25 00:22 bin
    drwxr-xr-x 1 root root  178 Aug 25 00:22 build
    drwxr-xr-x 1 root root   80 Aug 25 00:22 cgi-bin
    drwxr-xr-x 1 root root   76 Aug 25 00:22 conf
    drwxr-xr-x 1 root root 1124 Aug 25 00:22 error
    drwxr-xr-x 1 root root   20 Aug 25 00:22 htdocs
    drwxr-xr-x 1 root root 3488 Aug 25 00:22 icons
    drwxr-xr-x 1 root root 1520 Aug 25 00:22 include
    drwxr-xr-x 1 root root   18 Sep  5 11:40 logs
    drwxr-xr-x 1 root root 4254 Aug 25 00:22 modules
    
    $ docker exec web ls -l ./conf
    total 100
    drwxr-xr-x 1 root root   422 Aug 25 00:22 extra
    -rw-r--r-- 1 root root 20822 Aug 25 00:22 httpd.conf
    -rw-r--r-- 1 root root 13064 Aug 25 00:22 magic
    -rw-r--r-- 1 root root 61109 Aug 25 00:22 mime.types
    drwxr-xr-x 1 root root    30 Aug 25 00:22 original

    Apache HTTP Serverの設定ファイルhttpd.confが見つかったので、中身をcatコマンドで表示する。

    $ docker exec web cat ./conf/httpd.conf

    httpd.confの中に、「DocumentRoot」の記述がある。

    DocumentRoot "/usr/local/apache2/htdocs"

    上記から、「/usr/local/apache2/htdocs」が、HTMLファイルを格納している場所であることがわかった。

    まとめ

    前回記事で紹介したdocker runコマンドについて、詳細に分解し、解説した。今回挙げたオプションは、正直、結構な頻度で登場する。他によく見るのは、環境変数を与える「-e」くらいだ。

    当記事は、ただ読むだけでなく、お手持ちのLinux環境で実際に動かして確かめてみることをオススメする。同じ体験、そして深い理解を得られるものと期待する。さらに、ここまでやれば、過去の経験から応用も見えてくるものと思われる。是非、自身の技術知識の糧としてもらいたい。

    前回・今回とコンテナをつくることに注力した。次はつくったコンテナをどう操作するのか?である。停止する、再起動する、廃棄する、といったライフサイクルは、ソフトウェアの世界では重要である。よって、次回は、コンテナのライフサイクルについて、解説する。

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

    ■前回の記事■
    vol.4 【40代の学び直し】まずは動かして感動。10分でつくるDocker Webサーバー構築

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


    あなたへのおすすめ