コンテナで Hello world

目次

Docker とは一体何なのでしょうか？

Docker はコンテナ内に作成した世界で、アプリケーションを実行可能にします。コンテナ内でアプリケーションを実行するには、docker run コマンドを実行するだけです。

注釈

Docker システムの設定によっては、ガイドにおける各ページの docker コマンドで sudo が必要になる場合があります。この挙動を回避するには、システム管理者に対して docker という名称の Unix グループを作成し、そこにユーザを追加するようご依頼ください。

Hello world の実行

まず hello world コンテナを実行しましょう。

$ docker run ubuntu:14.04 /bin/echo 'Hello world'
Hello world

初めてコンテナを実行しました！

この例では以下の作業を行いました。

  • docker run でコンテナを実行します（runは「実行」の意味）。
  • ubuntu は実行するイメージです。この例では Ubuntu オペレーティング・システムのイメージです。イメージを指定したら、Docker はまずホスト上にイメージがあるかどうか確認します。イメージがローカルに存在していなければ、パブリック・イメージ・レジストリである Docker Hub からイメージを取得（pull）します。
  • /bin/echo は新しいコンテナ内で実行するコマンドです。

コンテナを起動するとは、Docker が新しい Ubuntu 環境を作成し、その中で /bin/echo コマンドを実行し、その結果を出力します。

Hello world

それでは、表示後のコンテナはどのような状況でしょうか。Docker コンテナが実行されていたのは、指定したコマンドを処理していた間のみです。この例では、コマンドを実行したのち、直ちにコンテナが停止しました。

インタラクティブなコンテナを実行

新しいコマンドを指定して、別のコンテナを起動しましょう。

$ docker run -t -i ubuntu:14.04 /bin/bash
root@af8bae53bdd3:/#

この例は、次の処理を行います。

  • docker run コマンドでコンテナを実行します。
  • ubuntu イメージを使って起動します。
  • -t フラグは新しいコンテナ内に疑似ターミナル (pseudo-tty) を割り当てます。
  • -i フラグはコンテナの標準入力 (STDIN)を取得し、双方向に接続できるようにします（訳者注：正確には標準エラー STDOUT も含めた標準入出力を扱います）。
  • /bin/bash はコンテナ内で Bash シェルを起動します。

コンテナを起動したら、次のようなコマンド・プロンプトが表示されます。

root@af8bae53bdd3:/# pwd
/
root@af8bae53bdd3:/# ls
bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr var

この例は：

  • pwd を実行し、現在のディレクトリが表示されます。ここでは / ルート・ディレクトリにいることが分かります。
  • ls はルートディレクトリ以下のディレクトリ一覧を表示します。典型的な Linux ファイル・システムのように見えます。

これで、コンテナ内で遊べます。終わったら exit コマンドまたは Ctrl-D を入力して終了できます。

root@af8bae53bdd3:/# exit

注釈

先ほど作成したコンテナと同様に、Bash シェルのプロセスが終了すると、コンテナは停止します。

Docker 化した Hello world の起動

デーモンとして実行するコンテナを作成しましょう。

$ docker run -d ubuntu:14.04 /bin/sh -c "while true; do echo hello world; sleep 1; done"
1e5535038e285177d5214659a068137486f96ee5c2e85a4ac52dc83f2ebe4147

この例では：

  • docker run はコンテナを実行します。
  • -d フラグはバックグラウンドで（デーモン化して）コンテナを実行します。
  • ubuntu は実行しようとしているイメージです。

最後に、実行するコマンドを指定します：

/bin/sh -c "while true; do echo hello world; sleep 1; done"

出力は先ほどのように hello world を表示せず、文字列を表示します。

1e5535038e285177d5214659a068137486f96ee5c2e85a4ac52dc83f2ebe4147

注釈

コンテナ ID は長くて扱いにくいものです。あとで短い ID を扱います。こちらを使えば、コンテナをより簡単に操作できます。

このコンテナ ID を使い、hello world デーモンで何が起こっているのかを調べます。

はじめに、コンテナが実行中であることを確認しましょう。 docker ps コマンドを実行します。docker ps コマンドは、Docker デーモンに対し、デーモンが知っている全てのコンテナ情報を問い合わせます。

$ docker ps
CONTAINER ID  IMAGE         COMMAND               CREATED        STATUS       PORTS NAMES
1e5535038e28  ubuntu:14.04  /bin/sh -c 'while tr  2 minutes ago  Up 1 minute        insane_babbage

この例はデーモン化したコンテナを見ています。 docker ps は便利な情報を返します。

  • 1e5535038e28 はコンテナ ID の短いバージョンです。
  • ubuntu は使用したイメージです。
  • コマンド、状態、コンテナに自動で割り当てられた名前は insane_babbage です。

注釈

Docker はコンテナ開始する時、自動的に名前を作成します。自分自身で名前を指定する方法は、後ほど紹介します。

これでコンテナが実行中だと分かりました。しかし、実行時に指定した処理が正しく行われているでしょうか。コンテナの中でどのような処理が行われているか確認するには、docker logs を使います。

コンテナ名 insane_babbage を指定しましょう。

$ docker logs insane_babbage
hello world
hello world
hello world
. . .

この例では：

  • docker logs でコンテナ内をのぞき込んだら、 hello world を返します。

すばらしいです！ デーモンとして動いています。初めて Docker 化（Dockerized）したアプリケーションを作成しました！

次は docker stop コマンドでデタッチド・コンテナ（バックグラウンドで動作しているコンテナ）を停止します。

$ docker stop insane_babbage
insane_babbage

docker stop コマンドは、Docker に対して丁寧にコンテナを停止するよう命令します。処理が成功したら、停止したコンテナ名を表示します。

docker ps コマンドを実行して、動作確認しましょう。

$ docker ps
CONTAINER ID  IMAGE         COMMAND               CREATED        STATUS       PORTS NAMES

素晴らしいですね。コンテナが停止しました。

次のステップ

ここまでは docker run コマンドを使い、初めてのコンテナを起動しました。フォアグラウンドで動作する、双方向に操作可能なコンテナを実行しました。また、バックグラウンドで動作するデタッチド・コンテナも実行しました。この過程で、複数の Docker コマンドを学びました。

  • docker ps - コンテナの一覧を表示。
  • docker logs - コンテナの標準出力を表示。
  • docker stop - 実行中のコンテナを停止。

以上で、Docker の基本と高度な処理を学びました。次は シンプルなアプリケーションの実行 に移動し、Docker クライアントを使って実際のウェブアプリケーションを構築しましょう。

参考

Hello world in a container
https://docs.docker.com/engine/userguide/containers/dockerizing/