Mac OS X¶

動作条件¶

Docker Toolbox を Mac にインストールするには、 OS X 10.8 “Mountain Lion” 以上が必要です。

インストール前に重要な概念を学ぶ¶

Linux 上への Docker のインストールにおいて、自分の物理マシンとはローカルホストと Docker ホストの両方を意味します。ネットワークでは、ローカルホストは自分のコンピュータを意味します。Docker ホストはコンテナを実行するためのコンピュータです。

典型的な Linux インストールは、自分のローカルホスト上で直接 Docker クライアント、Docker デーモン、そして、あらゆるコンテナを動かします。つまり、Docker コンテナは localhost:8000 や 0.0.0.0:8376 のような一般的なポートを割り当てて使います。

OS X でのインストールは、 default という名前の Linux 仮想マシン内で docker デーモンを実行します。 default とは軽量な Linux 仮想マシンであり、とりわけ Mac OS X 上で Docker デーモンを実行するために作られました。仮想マシンは RAM から実行され、24MB 程度をダウンロードし、起動まで約５秒です。

OS X では、Docker ホストのアドレスは Linux VM のアドレスです。仮想マシンを docker-machine で開始すると、IP アドレスが割り当てられます。コンテナを起動すると、コンテナ上のポートは仮想マシン上のポートに割り当てられます。このページの練習を通して、この仕組みに慣れましょう。

インストール¶

VirtualBox を実行中の場合、インストーラを実行する前に停止する必要があります。

1. Docker Toolbox のページに移動します。

2. インストーラのリンクをクリックします。

3. Docker Toolbox をインストールするために、パッケージをダブルクリックするか、右クリックして出てくるポップアップ・メニューから「開く」を選びます。

インストーラーは「Docker Toolbox のインストール」ダイアログを開きます。

4. 「続ける」を押して Toolbox をインストールします。

インストーラは標準インストールに対するカスタマイズ用オプションを提供しています。

デフォルトは、標準 Docker Toolbox の標準インストールです。

• Docker ツールのバイナリを /usr/local/bin にインストールします。
• バイナリを全てのユーザが使えるようにします。
• VirtualBox をインストールします。あるいは、インストール済みであればバージョンアップを行います。

変更したい場合は「カスタマイズ」や「インストール先を変更」します。

5. 「インストール」を押すと、標準インストールが始まります。

システム・プロンプトがパスワード入力を促します。

6. インストールを続けるには、パスワードを入力します。

完了すると、インストーラーは一般的な作業に関する表示を行います。

7. 「閉じる」をクリックすると終了します。

Docker Quickstart Terminal から使う¶

1. 「アプリケーション」フォルダから「Launchpad」を開きます。

2. Docker Quickstart Terminal を探し、クリックして起動します。

アプリケーションは次の動作をします：

• ターミナル用のウインドウを開く
• default 仮想マシンが無ければ作成し、仮想マシンを起動
• ターミナルの環境がこの仮想マシンを示す

起動が完了すると、Docker Quickstart Terminal は次のように表示します。

これで docker コマンドが実行できます。

3. セットアップの成功を確認するため、 hello-world コンテナを実行します。

$ docker run hello-world
Unable to find image 'hello-world:latest' locally
511136ea3c5a: Pull complete
31cbccb51277: Pull complete
e45a5af57b00: Pull complete
hello-world:latest: The image you are pulling has been verified.
Important: image verification is a tech preview feature and should not be
relied on to provide security.
Status: Downloaded newer image for hello-world:latest
Hello from Docker.
This message shows that your installation appears to be working correctly.

このメッセージ表示にあたり、Docker は次のステップを踏んでいます。

1. Docker クライアントは Docker デーモンに接続します。

2. Docker デーモンは「hello-world」イメージを Docker Hub から取得します（まだローカルにイメージがないのを想定しています）。

3. そのイメージを使い、Docker デーモンは新しいコンテナを作成します。コンテナを実行すると、先ほど見たような出力をします。

4. Docker デーモンは Docker クライアントに出力を流し込み、自分のターミナル上に送ります。

では、期待を持ちながら Ubuntu コンテナを実行しましょう。

$ docker run -it ubuntu bash

更なる例や考え方については、 ユーザガイド をご覧ください。

もう１つの典型的な Docker ツールを使う方法が、通常のシェル・コマンドラインからです。

シェルから使う¶

このセクションでは、Bash シェルの実行を想定しています。C シェルのような別のシェルでも、コマンドは同じです。

1. 新しい Docker 仮想マシンを作成します。

$ docker-machine create --driver virtualbox default
Creating VirtualBox VM...
Creating SSH key...
Starting VirtualBox VM...
Starting VM...
To see how to connect Docker to this machine, run: docker-machine env default

ここでは VirtualBox に新しい default 仮想マシンを作成します。

また、このコマンドはマシンの設定を ~/.docker/machine/machines/default ディレクトリに作成します。必要なのは、実行時に create コマンドを一度実行するだけです。あとは、 docker-machine を使って開始、停止、問い合わせできます。それだけでなく、コマンドライン上から仮想マシンを管理します。

2. 利用可能なマシン一覧を表示します。

$ docker-machine ls
NAME                ACTIVE   DRIVER       STATE     URL                         SWARM
default             *        virtualbox   Running   tcp://192.168.99.101:2376

廃止予定の Boot2Docker アプリケーションをインストールしているか、あるいは Docker Quickstart Terminal を実行している場合は dev 仮想マシンが同様に表示されます。 default 仮想マシンを作成したら、 docker-machine コマンドを通して仮想マシンへの接続方法を確認します。

3. 新しい仮想マシンに対応する環境変数を取得します。

$ docker-machine env default
export DOCKER_TLS_VERIFY="1"
export DOCKER_HOST="tcp://192.168.99.101:2376"
export DOCKER_CERT_PATH="/Users/mary/.docker/machine/machines/default"
export DOCKER_MACHINE_NAME="default"
# Run this command to configure your shell:
# eval "$(docker-machine env default)"

4. シェルから default マシンに接続します。

$ eval "$(docker-machine env default)"

5. hello-world コンテナを実行し、セットアップが正常かどうか確認します。

$ docker run hello-world

$ docker-machine create -d virtualbox --virtualbox-import-boot2docker-vm boot2docker-vm docker-vm

$ docker-machine ls
NAME                ACTIVE   DRIVER       STATE     URL                         SWARM
default             *        virtualbox   Running   tcp://192.168.99.100:2376

コンテナのポートに接続¶

1. DOCKER_HOST 上で NGINX コンテナを開始します。

$ docker run -d -P --name web nginx

通常の docker run コマンドは、コンテナを起動し、実行して、終了します。 -d フラグは docker run コマンドを実行したあとも、バックグラウンドでコンテナを実行し続けます。 -P フラグはコンテナ内の露出用ポートをローカルのホスト上に公開します。つまり、自分の Mac からアクセスできるようにします。

2. 実行中のコンテナを docker ps コマンドで表示します。

CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                                           NAMES
5fb65ff765e9        nginx:latest        "nginx -g 'daemon of   3 minutes ago       Up 3 minutes        0.0.0.0:49156->443/tcp, 0.0.0.0:49157->80/tcp   web

今まさに nginx がデーモンとして実行中なのが分かります。

3. コンテナのポートを表示します。

$ docker port web
443/tcp -> 0.0.0.0:49156
80/tcp -> 0.0.0.0:49157

この表示の意味は、 web コンテナのポート 80 番を Docker ホスト側のポート 49157 に割り当てています。

4. ブラウザで http://localhost:49157 アドレス（ localhost は 0.0.0.0 ）を開きます。

これは動作しません。理由は、 DOCKER_HOST のアドレスはローカルホストのアドレス（0.0.0.0）ではないためです。そのかわり Docker 仮想マシンのアドレスを使います。

5. default VM のアドレスを取得します。

$ docker-machine ip default
192.168.59.103

6. ブラウザのアドレスに http://192.168.59.103:49157 を入力します。

成功です！

7. 実行している nginx コンテナを停止・削除するには、次のように実行します。

$ docker stop web
$ docker rm web

コンテナにボリュームをマウント¶

コンテナを実行すると、自動的に /Users/ユーザ名 ディレクトリを仮想マシンと共有します。この共有ポイントを使い、コンテナの中にディレクトリとしてマウントできます。以下の例では、実際に動くのを確認します。

1. $HOME ディレクトリに移動します。

$ cd $HOME

2. 新しく site ディレクトリを作成します。

$ mkdir site

3. site ディレクトリに移動します。

$ cd site

4. 新しく index.html ファイルを作成します。

$ echo "my new site" > index.html

5. 新しく nginx コンテナを開始し、 html ディレクトリを site ディレクトリに置き換えます。

$ docker run -d -P -v $HOME/site:/usr/share/nginx/html \
  --name mysite nginx

6. mysite コンテナのポートを取得します。

$ docker port mysite
80/tcp -> 0.0.0.0:49166
443/tcp -> 0.0.0.0:49165

7. サイトをブラウザで開きます。

8. $HOME/site ディレクトリに新しいページをリアルタイムに追加します。

$ echo "This is cool" > cool.html

9. 新しいページをブラウザで開きます。

10. 実行している mysite コンテナを停止・削除します。

$ docker stop mysite
$ docker rm mysite

$ docker-machine ls
NAME                ACTIVE   DRIVER       STATE     URL                         SWARM
dev                 *        virtualbox   Running   tcp://192.168.99.100:2376
my-docker-machine            virtualbox   Stopped
default                      virtualbox   Stopped

$ docker-machine rm dev
Successfully removed dev

$ rm /usr/local/bin/docker