Docker Engine クイックスタート¶

構築済みイメージのダウンロード¶

ubuntu イメージをダウンロード（pull）するには、次のように実行します。

# ubuntu イメージのダウンロード（pull）
$ docker pull ubuntu

このコマンドは Docker Hub 上の ubuntu イメージをローカルのイメージ・キャッシュにダウンロードします。 イメージを検索するには docker search コマンドを実行します。詳しい情報は イメージの検索 をご覧ください。

ダウンロードしたイメージの一覧を表示するには docker images を実行します。

対話型シェルの実行¶

Ubuntu イメージの対話型シェルを使うには、次のように実行します：

$ docker run -i -t ubuntu /bin/bash

-i フラグは対話型 (interactive；インタラクティブ) のコンテナを起動します。-t フラグは疑似ターミナル (pseudo-TTY) を起動し、stdin と stdout （標準入出力）をアタッチ（接続）します。イメージ名は ubuntu です。コマンド /bin/bash を使ってログインできます。

シェルを終了せずに tty をデタッチ（取り外し）するには、エスケープ・シーケンス Ctrl-p + Ctrl-q を使います。コンテナから出たあとも、停止するまでコンテナは存在し続けます。

Docker を他のホスト・ポートや Unix ソケットに接続¶

Docker デーモンで -H オプション使用すると、指定した IP アドレスとポートをリッスンします（ポートを開きます）。標準では、unis:///var/run/docker.sock をリッスンし、ローカルの root ユーザのみ接続できます。これを 0.0.0.0:2375 や特定のホスト IP を指定することで、誰でもアクセス可能にできましたが、推奨されていません。理由は、デーモンが稼働しているホスト上の root アクセスを誰もが簡単に得られるためです。

同様に、Docker クライアントは -H を使い、任意のポートに接続可能です。Docker クライアントは、Linux 版では unix:///var/run/docker.sock に接続し、Windows 版では tcp://127.0.0.1:2376 に接続します。

-H は次の書式でホストとポートを割り当てます：

tcp://[host]:[port][path] or unix://path

例：

• tcp:// → 127.0.0.1 に TCP 接続時、TLS 暗号化が有効であればポート 2376 を、通信がプレーンテキストの場合（暗号化していない）はポート 2375 を使います。
• tcp://host:2375 → 対象ホスト:2375 に TCP 接続します。
• tcp://host:2375/path → 対象ホスト:2375 に TCP 接続し、あらかじめリクエストのパスを追加します。
• unix://path/to/socket → path/to/socket にある Unix ソケットに接続します。

-H の後に何も指定しないと、標準では -H を指定していないのと同じ挙動になります。

また、-H は TCP の指定を省略できます：

`host:` または `host:port` または `:port`

Docker をデーモン・モードで起動する：

$ sudo <path to>/docker daemon -H 0.0.0.0:5555 &

ubuntu イメージをダウンロードする：

$ docker -H :5555 pull ubuntu

複数の -H を使えます。例えば TCP と Unix ソケットの両方をリッスンしたい場合です。

# docker をデーモン・モードで実行
$ sudo <path to>/docker daemon -H tcp://127.0.0.1:2375 -H unix:///var/run/docker.sock &
# 標準の Unix ソケットを使い、Ubuntu イメージをダウンロード
$ docker pull ubuntu
# あるいは、TCP ポートを使用
$ docker -H tcp://127.0.0.1:2375 pull ubuntu

長時間動作するワーカー・プロセスの開始¶

# とても便利な長時間動作プロセスの開始
$ JOB=$(docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done")

# これまでのジョブの出力を収集
$ docker logs $JOB

# ジョブの停止(kill)
$ docker kill $JOB

コンテナの一覧¶

$ docker ps # 実行中のコンテナのみリスト表示
$ docker ps -a # 全てのコンテナをリスト表示

コンテナの制御¶

# 新しいコンテナの起動
$ JOB=$(docker run -d ubuntu /bin/sh -c "while true; do echo Hello world; sleep 1; done")

# コンテナの停止
$ docker stop $JOB

# コンテナの起動
$ docker start $JOB

# コンテナの再起動
$ docker restart $JOB

# コンテナを SIGKILL で停止
$ docker kill $JOB

# コンテナを削除
$ docker stop $JOB # Container must be stopped to remove it
$ docker rm $JOB

TCP ポートにサービスを割り当て¶

# コンテナにポート 4444 を割り当て、netcat でリッスンする
$ JOB=$(docker run -d -p 4444 ubuntu:12.10 /bin/nc -l 4444)

# どの外部ポートがコンテナに NAT されているか？
$ PORT=$(docker port $JOB 4444 | awk -F: '{ print $2 }')

# 公開ポートに接続
$ echo hello world | nc 127.0.0.1 $PORT

# ネットワーク接続の動作を確認
$ echo "Daemon received: $(docker logs $JOB)"

コンテナの状態をコミット（保存）¶

現在のコンテナの状態をイメージとして保存するには、 docker commit コマンドを使います。

$ docker commit <コンテナ> <何かの名前>

コンテナのコミットとは、元になったイメージと現在のコンテナの差分情報のみを、Docker Engine が保存します。どのようなイメージがあるかを確認するには、次のコマンドを実行します。

# List your images
$ docker images

コミットによって新しいイメージを手に入れました。これを使い、新しいインスタンス（訳者注：コンテナのこと）を作成可能でうｓ。

次はどこに行きますか¶

• Docker ユーザ・ガイド の中に進む
• リポジトリを通したイメージの共有 について読む
• コマンドラインの練習 を参照