SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

最短で使うDocker入門

Docker入門~Apacheコンテナを起動しよう

最短で使うDocker入門 第2回

  • X ポスト
  • このエントリーをはてなブックマークに追加

 前回はDockerの基本的な仕組みと基礎知識について説明しました。今回は、実際にApacheが入ったhttpdイメージを使って、Webサーバーを立てていきながら、Dockerの基本を習得しましょう。

  • X ポスト
  • このエントリーをはてなブックマークに追加

対象読者

  • Linuxの基礎コマンドを少し知っている方
  • 簡単にサーバーを構築したいインフラ技術者、開発者

httpdイメージを使ったWebサーバーを立てる

 今回は、実際にApacheが入ったコンテナであるhttpdイメージを使って、Webサーバーを立てていきながら、Dockerの基本を習得しましょう。

コンテナの設計

 ここでは下記の内容のコンテナを作ります。

1. イメージ名

 Apache入りのイメージの名前は「httpd」です。ここではタグは省略し、最新版を扱うことにします。

2. ポートのマッピング

 httpdコンテナは実行時にポート80で待ち受けるように構成されています(これはDocker Hubにあるドキュメントに記載されています)。そこでこのポートをマッピングする指定をします。

3. バインドマウント

 httpdコンテナは/usr/local/apache2/htdocs/がドキュメントルートとして構成されています(これもDocker Hubのドキュメントに記載されています)。今回は、このディレクトリをDockerホストの「/tmp」にバインドマウントします(これは例です。実際には/home以下などに配置するのがよいでしょう)。つまり「/tmp」に置いたコンテンツがWebのコンテンツとして見えるようにしてみます。

4. コンテナの名前

 「myapache」という名前にします。

5. サーバーとして使うコンテナ

 このコンテナはApacheが動くのでサーバーとして使うコンテナとして起動します。

コンテナの作成と実行

 コンテナを作成して実行するには、docker container runコマンドを使います。基本書式は、下記の通りです。

$ docker container run オプション イメージ名  実行したいコマンド

 (略して「docker run ・・・」とも書けます)。

 オプションのうち、ほとんどの場合、付けておいたほうがよいのが--nameオプションです。これは、コンテナに付ける名前を指定するオプションです。

$ docker container run --name コンテナ名 イメージ名  実行したいコマンド

 必須ではありませんが、省略するとランダムな名前で付けられてわかりにくいので、多くは明示的に指定します(例外的に、コンテナを1回実行したらすぐに破棄してしまう「-rオプション」を指定する場合は、この限りではありません)。

 なお、名前はすでにDockerホスト上に存在している他のコンテナと重複しない名前を指定しなければなりません。

 「実行したいコマンド」は、コンテナによっては、既定のコマンドが指定されていることがあり、その場合は省略できます。実際サーバーとして実行する場合は、ほとんど既定のコマンドが指定されています。

コンテナがサーバーとして動くような場合

 実際にdocker container runを実行する場合には、さまざまなオプションを指定しますが、中でもサーバーとして動くようなものの場合は、「-d」「-i」「-t」の3つのオプションを付けることがほとんどです。

$ docker container --name コンテナに付ける名前 -d -i -t run イメージ名 実行したいコマンド 
1. -d

 デタッチモードと呼ばれるモードで実行します。簡単に言うと、バックグラウンドで実行します。サーバーとして動くようなコンテナでは、この「-d」を指定しないと、コンテナが終了するまでプロンプトに戻ってこなくなってしまうので、これは指定必須です。

2. -iと-t

 指定しなくてもよいですが、指定しておいたほうが無難です。この連載では説明しませんが、docker container activateというコマンドを使って、コンテナにターミナルを接続して操作するときに必要です。-iは「インタラクティブ」、-tは「疑似端末」の指定ですがその意味の詳細は割愛します。

ポートマッピングやマウント、環境変数の指定

 ポートのマッピングやマウント、環境変数を設定するには、次のオプションを使います。どのオプションも複数個指定することもできます。

1. -p ホストのポート:コンテナのポート

 ホストのポートとコンテナのポートを「:」(コロン)でつなげて指定することでマッピングします。

2. -v マウント先やボリューム名:コンテナのディレクトリ

 -vオプション(または--volume)を使うと、コンテナのディレクトリを、特定のディレクトリやボリュームにマウントできます。バインドマウントするときは、マウント先として「/」から始まるパス名を指定します。そうではないときはボリュームが指定されたものとして扱われます。ボリュームがまだ作られていないときは、ボリュームが作られます。

3. -e 環境変数=値(または--env 環境変数=値)

 -eオプション(または--env)を指定すると、環境変数の値を指定できます。

 これらのオプションは、docker container runするとき(より正確にはdocker container createするとき)に指定するもので、コンテナの作成後に変更することはできません(変更したいときは、一度、コンテナからDockerイメージを作って待避し、そのDockerイメージから新しいコンテナを作ることで対処します)。

--mountオプション

 マウントでは、-v(もしくは--volume)オプションで指定する以外に、--mountオプションで指定する方法もあります。違いは、次の2点です。

1. 書き方が違う

 --mountオプションでは、次のように「src=」「dst=」などのようにして記述します。

 【ボリュームマウントの場合】

--mount type=volume,src=ボリューム名,dst=コンテナのディレクトリ

 【バインドマウントの場合】

--mount type=bind,src=Dockerホストのディレクトリ,dst=コンテナのディレクトリ
2. ボリュームが自動的に作成されない

 ボリュームがない場合は、ボリュームが自動作成されず、エラーとなります。そのためボリューム名をスペルミスしたときに、既存のボリュームに割り当てるのではなくて新しく作られてしまうといった凡ミスを誘発しないようになりました。

 挙動は同じなので、どちらを指定してもかまいません。最近では、--mountを使うことが推奨されています。

ボリュームの管理

 ボリュームは、docker volumeコマンドで操作します。主なコマンドを表にまとめておきます。

コマンド 意味
create ボリュームを作成する
ls 一覧取得
inspect 詳細確認
rm 削除
prune コンテナと結び付けられていないのもの全削除

Apacheが入ったコンテナを実行してみる

 実際にやってみます。httpdコンテナを起動するには、次のようにします。ここでは「myapache」という名前を付けました。-pオプションでポート番号を指定し、また-vオプションで、ドキュメントルートを/tmpに設定する指定もしています。

$ docker container run --name myapache -d -it -p 80:80 -v /tmp:/usr/local/apache2/htdocs httpd 

 実行に成功すると、もしイメージが手元になければ、Docker Hubからダウンロードされ、それからコンテナが作成されます(すでにダウンロード済み、つまり2回目以降の起動のときは、ダウンロードされません)。

 起動の際には、次のような16進数の羅列が表示されます。これはコンテナIDと呼ばれる番号で、コンテナを識別するときに使います。

4e25eb1ffa42316261a5bede586184472ba57ac0133466794d916559cb217d3c

Docker for Desktopの場合は?

 Docker for Desktopの場合も、起動方法は同じです。-vオプションのマウント先を、/tmpではなく、自分のドキュメントフォルダなどにmyexampleなどのフォルダを作っておき、そこを指定するとよいでしょう。

$C:\> docker container run --name myapache -d -it -p 80:80 -v C:\Users\yourname\Documents\myexample:/usr/local/apache2/htdocs httpd 

起動の確認と停止、再開

 作成したコンテナは、docker container psコマンド(またはdocker psやdocker container lsコマンド)で確認できます。

$ docker container ps

 実際、先のようにhttpdコンテナを起動したときは、次のような結果となるはずです。

CONTAINER ID        IMAGE               COMMAND              CREATED              STATUS              PORTS                NAMES
4e25eb1ffa42        httpd               "httpd-foreground"   About a minute ago   Up About a minute   0.0.0.0:80->80/tcp   myapache

 「CONTAINER ID」というのがコンテナIDで、先ほど起動時に表示された値の先頭何文字かを示したものです。「NAMES」には--nameオプションで指定した名前が設定されていることがわかります。「STATUS」は稼働状況です。「Up」は稼働中であることを示します。そしてPORTSが、ポートの割り当て情報で、Dockerホストの80番が、このコンテナの80番に割り当てられていることがわかります。

 なお、docker container psは、稼働中のコンテナしか表示しません。停止中のコンテナも含めて表示するには「-a」オプションを指定しますが、それについてあとで説明します。

実行の確認

 この時点でもう、Webサーバーが動いています。「http://サーバー名/」(Docker for Desktopで動かしているなら、自分のPCでhttp://localhost/)と入力すれば、マウントした/tmpの内容が見えるはずです。例えば、/tmpに次の内容のindex.htmlを置けば、ブラウザが、このページを見ることができます。

 【index.htmlの例(/usr/local/apache2/htdocsをバインドした先のディレクトリ。今回の流れでは/tmpに置く)】

<html>
<body>
<h1>Test Container</h1>
</body>
</html>

次のページ
コンテナのメンテナンス

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
最短で使うDocker入門連載記事一覧

もっと読む

この記事の著者

大澤 文孝(オオサワ フミタカ)

テクニカル・ライター、プログラマ/システムエンジニア。情報セキュリティスペシャリスト、ネットワークスペシャリスト。入門書からプログラミングの専門書まで幅広く執筆。   主な著作として、「Amazon Web Services 基礎からのネットワーク&サーバー構築(共著)」(...

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/12831 2020/12/04 11:00

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング