
【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
$
前回記事の時点でも同じだが、コマンド実行後、端末(ターミナル)が、コマンドを受け付けてくれる状態となっている。これが「バックグラウドで実行する」状態である。
では、「-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'
「docker run」コマンド実行後、実際に動くWebサーバー(Aapche HTTP Server)プログラムのログが表示された状態となる。この状態では、端末(ターミナル)はコマンドを受け付けてくれない。
サーバープログラムにおいて、実行後、ログを常に表示させたい場合はよいが、基本はそうではない。サーバープログラムを実行中に、別の操作を実施したいのが常である。よって、「-d」オプションをつけることをオススメする。
オプション「--name web」
ここでは、「web」と名前をつけている。これをすると何が嬉しいのか。
コンテナは、生成・起動するだけでなく、使わないときは停止したり、再起動したり、不要になったら削除したり、と各種操作を行う。それら操作を行うためのコマンドがdockerにも備わっているが、その際に、コンテナを示す「なにか」が必要である。dockerコンテナでは以下の2つが用意されている。
ここで、「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の指定ポート番号へのリクエストを、コンテナの指定したポート番号に転送する、である。

「-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に接続すると以下のように表示される。

次に、設定しない場合で見てみよう。
$ docker run -d --name web httpd:latest同様に、スマホから、ノートPCに接続してみたが、以下のように表示することができない。

このように、ホスト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
自身が用意したWebページの内容が表示された。
次に、設定しない場合を見てみよう。
$ docker run -d --name web -p 80:80 httpd:latest
「-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 originalApache HTTP Serverの設定ファイルhttpd.confが見つかったので、中身をcatコマンドで表示する。
$ docker exec web cat ./conf/httpd.confhttpd.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サーバー構築
■マガジン紹介■
一連の記事をマガジン化しました。他の記事もどうぞ。