やること
Mac上でDockerを使いNginx環境を作りつつDockerをそれとなく理解していく。ある程度の流れと雰囲気が掴めればOK。
Dockerのインストール
今回はHomebrewを使ってインストールしていく。
$ brew install docker
$ brew install docker-compose
$ brew cask install docker
でインストールして、
$ open /Applications/Docker.app
で、Dockerアプリケーションを起動。起動が終わったら
$ docker ps
で、
CONTAINER ID IMAGE COMMAND...
みたいなヘッダーが表示されればOK。
/ApplicationsにFinderのアプリケーションに表示されている色々なものがあります。open /Applications/any.appは覚えておくと良いかもしれない。
NginxをインストールしてHTMLを表示して遊ぶ
Nginxのイメージを取得する。
イメージというのはコンテナを作る元になるもの。イメージはDocker Hubっていうところから取得可能。docker searchコマンドでイメージを検索できる。
$ docker search nginx
を叩くと、
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
nginx Official build of Nginx. 11305 [OK]
jwilder/nginx-proxy Automated Nginx reverse proxy for docker con… 1588 [OK]
richarvey/nginx-php-fpm Container running Nginx + PHP-FPM capable of… 709 [OK]
jrcs/letsencrypt-nginx-proxy-companion LetsEncrypt container to use with nginx as p… 506 [OK]
webdevops/php-nginx Nginx with PHP-FPM 125 [OK]
こんな感じで利用可能なNginxイメージが表示されます。イメージは純粋にそれそのものだったりNginxであればいい感じに設定してくれているものがあったり等々。今回は一番上のnginx(Official build of Nginx.)をpullする。
$ docker pull nginx
Using default tag: latestと表示される。これはデフォルトで最新を取ってくるよって意味。バージョン指定が必要ならイメージ名の後ろにタグを付与する。pullが終わったらdocker imagesでpull済みのイメージ一覧を表示してNginxがpullされていることを確認する。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx latest 27a188018e18 11 days ago 109MB
こんな感じで表示されればOK。
イメージからコンテナを起動する
以下のコマンドで先程pullしたイメージからコンテナを生成/起動します。
$ docker run -d -p 8080:80 --name test-webserver nginx
-dはバックグラウンド起動でそのままterminalを使う場合は設定しておいた方が良い。iTermとか使ってればオプション指定しなくても良いかも。オプションを省略した時はctrl+cでコンテナを 停止 させられます。バックグラウンド起動した時はdocker stop [name]で停止します。
-pはポート転送設定オプションになります。[ホストPort]:[コンテナ:Port]の形で指定する。8080:80であれば0.0.0.0:8080にアクセスするとそのままcontainer:80にアクセスするよって感じ。
--nameはコンテナの名前。適当にわかりやすい名前を付けると良い。
nginxはpullしたイメージ名。
コマンドを実行したら実行中コンテナ一覧を表示してみる。
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
f8fda9e72931 nginx "nginx -g 'daemon of…" 12 seconds ago Up 11 seconds 0.0.0.0:8080->80/tcp test-webserver
こんな感じで表示されてればOK。
アクセスしてみる
0.0.0.0:8080とcontainer:80がつながっているのでlocalhost:8080にアクセスすればEginxのデフォルトページが表示されるはず。ってことで、
$ curl localhost:8080
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
:
:
<h1>Welcome to nginx!</h1>
<p>If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.</p>
:
:
</body>
</html>
と返ってくればOK、成功。
HTMLを書き換える
コンテナにログインして書き換える
以下のコマンドでログイン。rootでログインした状態になる。自分の環境がfishでもコンテナ内にfishが無いのでbashプロセスを起動。
$ docker exec -it test-webserver /bin/bash
root@xxxxxxxxxxxx:/#
-itは手元のterminalで操作するよ、的な意味。
/bin/bashはbashプロセス立ち上げて、それを操作するよの意味。
pwdとかlsとかやってみる。
$ pwd
/
$ ls -la
total 72
drwxr-xr-x 1 root root 4096 Apr 28 04:48 .
drwxr-xr-x 1 root root 4096 Apr 28 04:48 ..
-rwxr-xr-x 1 root root 0 Apr 28 04:48 .dockerenv
drwxr-xr-x 2 root root 4096 Mar 26 12:00 bin
drwxr-xr-x 2 root root 4096 Feb 3 13:01 boot
drwxr-xr-x 5 root root 340 Apr 28 04:48 dev
drwxr-xr-x 1 root root 4096 Apr 28 04:48 etc
drwxr-xr-x 2 root root 4096 Feb 3 13:01 home
drwxr-xr-x 1 root root 4096 Mar 26 12:00 lib
drwxr-xr-x 2 root root 4096 Mar 26 12:00 lib64
drwxr-xr-x 2 root root 4096 Mar 26 12:00 media
drwxr-xr-x 2 root root 4096 Mar 26 12:00 mnt
drwxr-xr-x 2 root root 4096 Mar 26 12:00 opt
dr-xr-xr-x 183 root root 0 Apr 28 04:48 proc
drwx------ 2 root root 4096 Mar 26 12:00 root
drwxr-xr-x 1 root root 4096 Apr 28 04:48 run
drwxr-xr-x 2 root root 4096 Mar 26 12:00 sbin
drwxr-xr-x 2 root root 4096 Mar 26 12:00 srv
dr-xr-xr-x 13 root root 0 Apr 28 05:08 sys
drwxrwxrwt 1 root root 4096 Apr 16 21:20 tmp
drwxr-xr-x 1 root root 4096 Mar 26 12:00 usr
drwxr-xr-x 1 root root 4096 Mar 26 12:00 var
おー...。ってことでindex.htmlを触ってみる。
$ cd /usr/share/nginx/html
$ vim index.html
bash: vim: command not found
$ vi index.html
bash: vi: command not found
なるほど。viも無い。Vimである必要性は無いけど...
$ apt-get update
$ apt-get install vim
でインストールして、index.htmlを編集。タイトルとか本文とかを適当に編集。こんな感じに書き換えた。
<h1>Welcome to Docker!</h1>
<p>If you see this page, the docker and nginx web server is successfully installed and
working. Further configuration is required.</p>
curl localhost:8080にアクセスして修正した場所が反映されていればOK。やったね。
とは言え、ファイル修正するのにコンテナにログインしないとダメなの？ってことは開発環境はコンテナの中に作るの？え？Vim？死にそう...ってなる。
ホストOSののディレクトリをコンテナにマウントしてよしなにやる
「おっ？何言ってるかわからねぇな＾＾」って感じですが、簡単に言うとホストOS（例：Mac）のディレクトリをコンテナのディレクトリ（例：公開ディレクトリ）にしちゃう、的な感じです。コンテナのこのディレクトリはホストOSのこのディレクトリな、以上。って感じです。百聞は一見に如かず、やってみよう。
まずは起動中のコンテナを停止。停止は起動方法により異なる（先述の通り）。
# バックグラウンド起動時
$ docker stop [name]
# フォアグラウンド起動時
$ (ctrl + c)
マウントするディレクトリを作る。
$ pwd
/Users/[user-name]
$ mkdir sample-docker
$ cd sample-docker/
$ mkdir test-webserver2
次にコンテナを作る。さっき作ったコンテナ使えば良いじゃんって思うんですけど、ちょろっと調べた感じrunオプションは変更できないっぽい。コンテナをcommitしてイメージにしてrunする時にオプション追加して...とかはできるっぽい。雰囲気掴むだけの記事だから細かいところは見て見ぬ振り。
$ docker run -d -p 8080:80 -v (pwd)/sample-docker/test-webserver2:/usr/share/nginx/html --name test-webserver2 nginx
fish環境なので(pwd)としていますが、bash環境の方は$(pwd)としないとエラーになると思います。
-vが先程の「ホストOSののディレクトリをコンテナにマウント」になる。ポート指定と同じ感じ。
早速/Users/[user-name]/sample-docker/test-webserver2にindex.htmlを作成する。中身はとりあえず何でも良い。とりあえずhogeとか書いておけば良い。curlでlocalhost:8080にアクセス。
$ curl localhost:8080
<html>
<head><title>403 Forbidden</title></head>
<body>
<center><h1>403 Forbidden</h1></center>
<hr><center>nginx/1.15.12</center>
</body>
</html>
...(´・ω・｀)ｱﾚ????
docker execで中に入って確認してもindex.htmlができてない。入ったついでに/usr/share/nginx/htmlに移動して、中身はhageの4文字のindex.htmlを作成してホストOSの方からcurl localhost:8080で確認。
$ curl localhost:8080
hage
(´・ω・｀)ははははハゲちゃうわ
という冗談は置いといて、原因調査。
Docker for Macでコンテナとのボリュームマウントに苦労した話を見つつ/Users/[user name]/を参照する時は~/で指定しないとダメってことを理解。
~/sample-docker/test-webserver3ディレクトリを作成して以下のコマンドでコンテナを起動。
$ docker run -p 8080:80 -v ~/sample-docker/test-webserver3:/usr/share/nginx/html --name test-webserver3 nginx
curl localhost:8080でhogeが返ってくることを確認。やったね。
複数ディレクトリをコンテナにマウントする
複数マウントする場合は-vオプションを複数設定すれば良さそう。
$ mkdir test-webserver4
$ mkdir test-webserver4-log
$ docker run -p 8080:80 -v ~/sample-docker/test-webserver4:/usr/share/nginx/html -v ~/sample-docker/test-webserver4-log:/var/log/nginx --name test-webserver4 nginx
test-webserver4にindex.htmlを作って反映、test-webserver4-logにaccess.logとerror.logができることが確認できる。
覚えておくと良いdockerコマンド
docker search
search — Docker-docs-ja 17.06.Beta ドキュメント
Docker Hubにあるイメージを検索できる。とりあえずこれ欲しいなって思ったらsearchで漁る感じになりそう。
Tagの一覧を取得するコマンドは無さそう。curl https://registry.hub.docker.com/v2/repositories/library/anyで取ってくるかshell script書くかですかね。
docker pull
pull — Docker-docs-ja 17.06.Beta ドキュメント
Docker Hubからイメージを取得する。タグを指定＝バージョン指定のイメージでOK。
docker run
Docker run リファレンス — Docker-docs-ja 17.06.Beta ドキュメント
コンテナプロセスの起動。
ディレクトリのマウントとかバックグラウンド起動とかできる。
docker ps
ps — Docker-docs-ja 17.06.Beta ドキュメント
コンテナ一覧を取得する。オプションを付けないと動いているコンテナ一覧で、-aを付けると起動してないコンテナも取得できる。
docker start [container name] / docker stop [container name]
start — Docker-docs-ja 17.06.Beta ドキュメント
stop — Docker-docs-ja 17.06.Beta ドキュメント
コンテナの起動/停止。
docker exec
exec — Docker-docs-ja 17.06.Beta ドキュメント
コンテナにログインする。terminalを引き続き使う場合は-itオプションを付与する。
最後に
単独での使い方は何となくわかったので、次は複数コンテナを連携させて遊ぶ。
Dockerfileとかdocker-composeとかは追々。