はじめに
以下の書籍の演習をやったので、そのまとめ。
Docker初心者でも実際に手を動かしながら、Dockerの概念や基本を学ぶことが出来るので良本だと思います。演習のホストOSはCentOS7で試しています。
書名：Dockerによるアプリケーション開発環境構築ガイド
著者：櫻井 洋一郎, 村崎 大輔 (著)
関連
[part1] part1 docker基本コマンド
[part3] Baseimage-dockerを使った1コンテナでの複数サービス管理
DockerfileによるDockerイメージの作成
docker buildコマンドにより、Dockerfileで定義した一連の手続きを実行してイメージ作成できる
FROM ベースとなるDockerイメージの指定
*タグ名やdigest名を指定しない場合、latestというタグ名が使われる
[root@testvm Dockerfile]# cat from/Dockerfile_simple
FROM ubuntu
RUN echo foo
RUN echo bar
[root@testvm Dockerfile]# docker build -f from/Dockerfile_simple -t build:from_simple .
Sending build context to Docker daemon 72.7 kB
Step 1/3 : FROM ubuntu
Trying to pull repository docker.io/library/ubuntu ...
latest: Pulling from docker.io/library/ubuntu
7ddbc47eeb70: Pull complete
c1bbdc448b72: Pull complete
8c3b70e39044: Pull complete
45d437916d57: Pull complete
Digest: sha256:6e9f67fa63b0323e9a1e587fd71c561ba48a034504fb804fd26fd8800039835d
Status: Downloaded newer image for docker.io/ubuntu:latest
---> 775349758637
Step 2/3 : RUN echo foo
---> Running in d3c97cc0ca90
foo
---> aa90c50f3a31
Removing intermediate container d3c97cc0ca90
Step 3/3 : RUN echo bar
---> Running in b18878ac3caa
bar
---> 3129b3f87c7b
Removing intermediate container b18878ac3caa
Successfully built 3129b3f87c7b
[root@testvm Dockerfile]# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
build from_simple 3129b3f87c7b 16 minutes ago 64.2 MB
sample/ubuntu_with_php 1_0 351b1877a1a0 About an hour ago 206 MB
docker.io/ubuntu 16.04 5f2bf26e3524 3 weeks ago 123 MB
docker.io/ubuntu latest 775349758637 3 weeks ago 64.2 MB
docker.io/hello-world latest fce289e99eb9 10 months ago 1.84 kB
digest名を指定したFROM
digest
- イメージの内容が完全に同一であることを保証したい場合に利用できる
- Dockerレジストリにpushされているものにしか付与されない
[root@testvm Dockerfile]# cat from/Dockerfile_digest
FROM ubuntu@sha256:e27e9d7f7f28d67aa9e2d7540bdc2b33254b452ee8e60f388875e5b7d9b2b696
RUN echo foo
RUN echo bar
[root@testvm Dockerfile]# docker images --digests
REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE
build from_simple <none> 3129b3f87c7b 18 minutes ago 64.2 MB
sample/ubuntu_with_php 1_0 <none> 351b1877a1a0 About an hour ago 206 MB
docker.io/ubuntu 16.04 sha256:bb5b48c7750a6a8775c74bcb601f7e5399135d0a06de004d000e05fd25c1a71c 5f2bf26e3524 3 weeks ago 123 MB
docker.io/ubuntu latest sha256:6e9f67fa63b0323e9a1e587fd71c561ba48a034504fb804fd26fd8800039835d 775349758637 3 weeks ago 64.2 MB
docker.io/hello-world latest sha256:4df8ca8a7e309c256d60d7971ea14c27672fc0d10c5f303856d7bc48f8cc17ff fce289e99eb9 10 months ago 1.84 kB
[root@testvm Dockerfile]# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
build from_digest 3129b3f87c7b 22 minutes ago 64.2 MB
build from_simple 3129b3f87c7b 22 minutes ago 64.2 MB
sample/ubuntu_with_php 1_0 351b1877a1a0 About an hour ago 206 MB
docker.io/ubuntu 16.04 5f2bf26e3524 3 weeks ago 123 MB
docker.io/ubuntu latest 775349758637 3 weeks ago 64.2 MB
docker.io/hello-world latest fce289e99eb9 10 months ago 1.84 kB
ENV 環境変数の指定
以下のどちらのファイルの書き方でも指定できる
[root@testvm Dockerfile]# cat env/Dockerfile_first
FROM ubuntu
ENV myName John Doe
ENV myDog Rex The Dog
ENV myCat fluffy
RUN echo "$myName, $myDog, $myCat"
[root@testvm Dockerfile]# cat env/Dockerfile_second
FROM ubuntu
ENV myName="John Doe" myDog=Rex\ The\ Dog \
myCat=fluffy
RUN echo "$myName, $myDog, $myCat"
[root@testvm Dockerfile]# docker build -f env/Dockerfile_second -t build:env_second .
Sending build context to Docker daemon 72.7 kB
Step 1/3 : FROM ubuntu
---> 775349758637
Step 2/3 : ENV myName "John Doe" myDog Rex\ The\ Dog myCat fluffy
---> Running in 5477587e40c4
---> 6ae375f8167e
Removing intermediate container 5477587e40c4
Step 3/3 : RUN echo "$myName, $myDog, $myCat"
---> Running in 4132c1dc3898
John Doe, Rex The Dog, fluffy
---> d521daf65407
Removing intermediate container 4132c1dc3898
Successfully built d521daf65407
[root@testvm Dockerfile]# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
build env_second d521daf65407 6 seconds ago 64.2 MB
step3/3で環境変数が正しくechoできていることがわかる。
またdocker historyコマンドでイメージの履歴も確認できる。
[root@testvm Dockerfile]# docker history build:env_second
IMAGE CREATED CREATED BY SIZE COMMENT
d521daf65407 About a minute ago /bin/sh -c echo "$myName, $myDog, $myCat" 0 B
6ae375f8167e About a minute ago /bin/sh -c #(nop) ENV myName=John Doe myD... 0 B
775349758637 3 weeks ago /bin/sh -c #(nop) CMD ["/bin/bash"] 0 B
<missing> 3 weeks ago /bin/sh -c mkdir -p /run/systemd && echo '... 7 B
<missing> 3 weeks ago /bin/sh -c set -xe && echo '#!/bin/sh' >... 745 B
<missing> 3 weeks ago /bin/sh -c [ -z "$(apt-get indextargets)" ] 987 kB
<missing> 3 weeks ago /bin/sh -c #(nop) ADD file:a48a5dc1b9dbfc6... 63.2 MB
LABEL メタデータの付与
[root@testvm Dockerfile]# cat label/Dockerfile
FROM ubuntu:16.04
LABEL maintainer="Image maintainer team <hogehoge@example.com>"
[root@testvm Dockerfile]# docker build -f label/Dockerfile -t build:label .
Sending build context to Docker daemon 72.7 kB
Step 1/2 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/2 : LABEL maintainer "Image maintainer team <hogehoge@example.com>"
---> Running in 9537e0b33209
---> 029aea12235a
Removing intermediate container 9537e0b33209
Successfully built 029aea12235a
docker inspectでイメージの詳細を確認できる
[root@testvm Dockerfile]# docker inspect build:label
[
{
"Id": "sha256:029aea12235a101dfd046e7824607026696caa70f0f3b082d72fbd95c5b0b51b",
"RepoTags": [
"build:label"
],
"RepoDigests": [],
"Parent": "sha256:5f2bf26e35249d8b47f002045c57b2ea9d8ba68704f45f3c209182a7a2a9ece5",
"Comment": "",
"Created": "2019-11-25T02:17:57.917903693Z",
"Container": "9537e0b332090b0fec319cf6a76cee190a2ef94580d0796bdb2bcc4f1416c005",
"ContainerConfig": {
"Hostname": "9537e0b33209",
"Domainname": "",
"User": "",
"AttachStdin": false,
"AttachStdout": false,
"AttachStderr": false,
"Tty": false,
"OpenStdin": false,
"StdinOnce": false,
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
],
"Cmd": [
"/bin/sh",
"-c",
"#(nop) ",
"LABEL maintainer=Image maintainer team <hogehoge@example.com>"
],
"ArgsEscaped": true,
"Image": "sha256:5f2bf26e35249d8b47f002045c57b2ea9d8ba68704f45f3c209182a7a2a9ece5",
"Volumes": null,
"WorkingDir": "",
"Entrypoint": null,
"OnBuild": [],
"Labels": {
"maintainer": "Image maintainer team <hogehoge@example.com>"
}
},
"DockerVersion": "1.13.1",
"Author": "",
(以下省略)
RUN shellの実行
書き方は以下の２種類(1. shell form と 2. exec form)
1.の場合,/bin/sh -cで実行される
2.の場合,SHELLの値は関係無く、実行可能コマンドを直接実行する
[root@testvm Dockerfile]# cat run/Dockerfile
FROM ubuntu:16.04
RUN echo $0
RUN ["sh", "-c", "echo $0"]
ubuntuでは/bin/bashがdashとなっており、()という表現を受け付けないため、以下のDockerfileではそれぞれ、成功・失敗する
[root@testvm Dockerfile]# cat run/shell/Dockerfile_success
FROM ubuntu:16.04
RUN ["/bin/bash", "-c", "FOO=(`ls`); echo $FOO"]
[root@testvm Dockerfile]#
[root@testvm Dockerfile]# cat run/shell/Dockerfile_with_error
FROM ubuntu:16.04
RUN FOO=(`ls`); echo $FOO
また、1.と2.で環境変数の展開も異なる
# 3のexec formではコマンドシェル経由ではなく、実行ファイルを直接実行されているため、環境変数は展開されない。
[root@testvm Dockerfile]# cat run/env/Dockerfile
FROM ubuntu:16.04
# 1. set environment variable.
ENV HOGE hoge
# 2. echo by "shell form".
RUN echo $HOGE
# 3. echo by "exec form", without shell.
RUN ["echo", "$HOGE"]
# 4. echo by "exec form", with shell.
RUN ["/bin/sh", "-c", "echo $HOGE"]
[root@testvm Dockerfile]# docker build -f run/env/Dockerfile -t build:run_env ./run/env/
Sending build context to Docker daemon 2.048 kB
Step 1/5 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/5 : ENV HOGE hoge
---> Running in a8da17cf3a87
---> 3580b7a865c6
Removing intermediate container a8da17cf3a87
Step 3/5 : RUN echo $HOGE
---> Running in b7c7dbb13af9
hoge
---> a1b63fac8a8e
Removing intermediate container b7c7dbb13af9
Step 4/5 : RUN echo $HOGE
---> Running in cb5081f725cf
$HOGE
---> 1e5e35162487
Removing intermediate container cb5081f725cf
Step 5/5 : RUN /bin/sh -c echo $HOGE
---> Running in 8447b4ad41ce
hoge
---> 425615fdbaec
Removing intermediate container 8447b4ad41ce
Successfully built 425615fdbaec
docker historyコマンドで確認すると、# 3の箇所(IMAGE ID=1e5e35162487の部分)では/bin/sh -c 経由ではなく、直接コマンド実行されているのが分かる。
[root@testvm Dockerfile]# docker history build:run_env
IMAGE CREATED CREATED BY SIZE COMMENT
425615fdbaec 5 minutes ago /bin/sh -c echo $HOGE 0 B
1e5e35162487 5 minutes ago echo $HOGE 0 B
a1b63fac8a8e 5 minutes ago /bin/sh -c echo $HOGE 0 B
3580b7a865c6 5 minutes ago /bin/sh -c #(nop) ENV HOGE=hoge 0 B
5f2bf26e3524 3 weeks ago /bin/sh -c #(nop) CMD ["/bin/bash"] 0 B
<missing> 3 weeks ago /bin/sh -c mkdir -p /run/systemd && echo '... 7 B
<missing> 3 weeks ago /bin/sh -c set -xe && echo '#!/bin/sh' >... 745 B
<missing> 3 weeks ago /bin/sh -c rm -rf /var/lib/apt/lists/* 0 B
<missing> 3 weeks ago /bin/sh -c #(nop) ADD file:9511990749b593a... 123 MB
SHELL [shell form]が利用された際に使用されるコマンドを指定
Linux：デフォルトは/bin/sh, -c
Windows：デフォルトはcmd, \S, \C
先ほどエラーになっていたDockerfileをSHELLコマンドでシェル指定することで、正しく実行できる
root@testvm Dockerfile]# cat shell/Dockerfile
FROM ubuntu:16.04
SHELL ["/bin/bash", "-c"]
RUN FOO=(`ls`); echo $FOO
[root@testvm Dockerfile]# docker build -f shell/Dockerfile -t build:shell .
Sending build context to Docker daemon 72.7 kB
Step 1/3 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/3 : SHELL /bin/bash -c
---> Running in 119915db64d1
---> a3de822059a0
Removing intermediate container 119915db64d1
Step 3/3 : RUN FOO=(`ls`); echo $FOO
---> Running in d30fec3eada9
bin
---> 7dfba7eb3110
Removing intermediate container d30fec3eada9
Successfully built 7dfba7eb3110
WORKDIR 相対パスを指定した時のディレクトリを指定
複数回記述した場合はその都度ワークディレクトリが変わる
[root@testvm Dockerfile]# cat workdir/Dockerfile
FROM ubuntu:16.04
WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
[root@testvm Dockerfile]# docker build -f workdir/Dockerfile -t build:workdir .
Sending build context to Docker daemon 72.7 kB
Step 1/5 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/5 : WORKDIR /a
---> 7b584249016a
Removing intermediate container d8c9f332724e
Step 3/5 : WORKDIR b
---> 9c6281858297
Removing intermediate container 2c8f90abb159
Step 4/5 : WORKDIR c
---> 557de1101958
Removing intermediate container fae71b6ce31d
Step 5/5 : RUN pwd
---> Running in e52da7fd8e55
/a/b/c
---> d85bec60cbbd
Removing intermediate container e52da7fd8e55
Successfully built d85bec60cbbd
ADD ファイル、ディレクトリ、URLリソースなどをコンテナ上にコピー
tarでアーカイブしたファイルを展開した状態でコピーする。
Linuxコンテナの場合のみ、--chown=<user>:<group>のオプションが可能。
[root@testvm Dockerfile]# cat add/Dockerfile
FROM ubuntu:16.04
# 1. Make work directory at first.
WORKDIR /add
# 2. Add normal file.
ADD ./files/not_archived_file .
RUN ls -al /add
# 3. Add remote resource to container.
ADD https://github.com/docker/docker-ce/blob/master/README.md .
RUN ls -al /add
# 4. Uncompress and unarchive tar files.
ADD ./files/tar_bzip2_file.tar.bzip2 ./files/tar_file.tar ./files/tar_file.tar ./files/tar_gz_file.tar.gz ./files/tar_xz_file.tar.xz ./
RUN ls -al /add
# 5. NOT unarchive compressed files.
ADD ./files/bzip2_file.bz2 ./files/gzip_file.gz ./files/xz_file.xz ./files/zip_file.zip ./
RUN ls -al /add
# 6. Add directory.
ADD ./files ./files
RUN ls -al /add/files
[root@testvm Dockerfile]# ll add/files/
total 32
-rw-r--r--. 1 root root 14 Mar 11 2018 bzip2_file.bz2
-rw-r--r--. 1 root root 30 Mar 11 2018 gzip_file.gz
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
-rw-r--r--. 1 root root 396 Mar 11 2018 tar_bzip2_file.tar.bzip2
-rw-r--r--. 1 root root 2560 Mar 11 2018 tar_file.tar
-rw-r--r--. 1 root root 354 Mar 11 2018 tar_gz_file.tar.gz
-rw-r--r--. 1 root root 368 Mar 11 2018 tar_xz_file.tar.xz
-rw-r--r--. 1 root root 32 Mar 11 2018 xz_file.xz
-rw-r--r--. 1 root root 166 Mar 11 2018 zip_file.zip
[root@testvm Dockerfile]# docker build -f add/Dockerfile -t build:add ./add/
Sending build context to Docker daemon 13.82 kB
Step 1/12 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/12 : WORKDIR /add
---> Using cache
---> 440865d619ab
Step 3/12 : ADD ./files/not_archived_file .
---> e4bf598e3a12
Removing intermediate container 4bdea1d3d886
Step 4/12 : RUN ls -al /add
---> Running in faf4dd8b160d
total 0
drwxr-xr-x. 1 root root 31 Nov 25 05:05 .
drwxr-xr-x. 1 root root 17 Nov 25 05:05 ..
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
---> 0015e1708251
Removing intermediate container faf4dd8b160d
Step 5/12 : ADD https://github.com/docker/docker-ce/blob/master/README.md .
Downloading 69.95 kB
---> 67462f31863f
Removing intermediate container a16cf375b2a1
Step 6/12 : RUN ls -al /add
---> Running in 94f495a81b87
total 72
drwxr-xr-x. 1 root root 23 Nov 25 05:05 .
drwxr-xr-x. 1 root root 6 Nov 25 05:05 ..
-rw-------. 1 root root 69950 Jan 1 1970 README.md
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
---> 19d1c776bb1f
Removing intermediate container 94f495a81b87
Step 7/12 : ADD ./files/tar_bzip2_file.tar.bzip2 ./files/tar_file.tar ./files/tar_file.tar ./files/tar_gz_file.tar.gz ./files/tar_xz_file.tar.xz ./
---> da128d3f06eb
Removing intermediate container fd468212c260
Step 8/12 : RUN ls -al /add
---> Running in f1b7f3f6342d
total 88
drwxr-xr-x. 1 root root 166 Nov 25 05:05 .
drwxr-xr-x. 1 root root 6 Nov 25 05:05 ..
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_bzip2_file
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_file
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_gz_file
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_xz_file
-rw-------. 1 root root 69950 Jan 1 1970 README.md
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_bzip2_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_gz_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_xz_file
---> 60f2893855fb
Removing intermediate container f1b7f3f6342d
Step 9/12 : ADD ./files/bzip2_file.bz2 ./files/gzip_file.gz ./files/xz_file.xz ./files/zip_file.zip ./
---> b9a584f7c670
Removing intermediate container 39c3bead5ed3
Step 10/12 : RUN ls -al /add
---> Running in 1c3c46862f65
total 104
drwxr-xr-x. 1 root root 86 Nov 25 05:05 .
drwxr-xr-x. 1 root root 6 Nov 25 05:05 ..
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_bzip2_file
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_file
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_gz_file
-rw-r--r--. 1 501 dialout 239 Feb 18 2018 ._tar_xz_file
-rw-------. 1 root root 69950 Jan 1 1970 README.md
-rw-r--r--. 1 root root 14 Mar 11 2018 bzip2_file.bz2
-rw-r--r--. 1 root root 30 Mar 11 2018 gzip_file.gz
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_bzip2_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_gz_file
-rw-r--r--. 1 501 dialout 0 Feb 18 2018 tar_xz_file
-rw-r--r--. 1 root root 32 Mar 11 2018 xz_file.xz
-rw-r--r--. 1 root root 166 Mar 11 2018 zip_file.zip
---> cf451a8b0cbb
Removing intermediate container 1c3c46862f65
Step 11/12 : ADD ./files ./files
---> 76a5e5890369
Removing intermediate container 0a11f98e0b9e
Step 12/12 : RUN ls -al /add/files
---> Running in f64b9cb5af2d
total 32
drwxr-xr-x. 2 root root 215 Nov 25 05:05 .
drwxr-xr-x. 1 root root 19 Nov 25 05:05 ..
-rw-r--r--. 1 root root 14 Mar 11 2018 bzip2_file.bz2
-rw-r--r--. 1 root root 30 Mar 11 2018 gzip_file.gz
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
-rw-r--r--. 1 root root 396 Mar 11 2018 tar_bzip2_file.tar.bzip2
-rw-r--r--. 1 root root 2560 Mar 11 2018 tar_file.tar
-rw-r--r--. 1 root root 354 Mar 11 2018 tar_gz_file.tar.gz
-rw-r--r--. 1 root root 368 Mar 11 2018 tar_xz_file.tar.xz
-rw-r--r--. 1 root root 32 Mar 11 2018 xz_file.xz
-rw-r--r--. 1 root root 166 Mar 11 2018 zip_file.zip
---> f1d67759af12
Removing intermediate container f64b9cb5af2d
Successfully built f1d67759af12
COPY ※ADDコマンドと同様
ADDコマンドとの違いは
- multi staging docker機能で作成した別のコンテナの中にあるファイルをコピーする
- URLリソースの指定不可
- tarでアーカイブしたファイルを展開しない
以下の例では、一つのDockerfile内で2つのイメージをベースに使い、イメージ間（コンテナ間）でファイルのコピーをしている
[root@testvm Dockerfile]# cat copy/Dockerfile
# Use multi stage docker feature.
FROM busybox AS build_env
# 1. Make work directory at first.
WORKDIR /multistage
# 2. Copy
COPY ./files/multi_stage_docker_file .
RUN ls -al /multistage
# Second docker definition.
FROM ubuntu:16.04
# 3. Make work directory at first.
WORKDIR /copy
# 4. Copy normal file.
COPY ./files/not_archived_file .
RUN ls -al /copy
# 5. Copy normal file.
COPY --from=build_env /multistage/multi_stage_docker_file .
RUN ls -al /copy
# 6. NOT Uncompress and unarchive tar files.
COPY ./files/tar_bzip2_file.tar.bzip2 ./files/tar_file.tar ./files/tar_file.tar ./files/tar_gz_file.tar.gz ./files/tar_xz_file.tar.xz ./
RUN ls -al /copy
# 7. NOT unarchive compressed files.
COPY ./files/bzip2_file.bz2 ./files/gzip_file.gz ./files/xz_file.xz ./files/zip_file.zip ./
RUN ls -al /copy
# 8. Copy directory.
COPY ./files ./files
RUN ls -al /copy/files
[root@testvm Dockerfile]# ll copy/files/
total 32
-rw-r--r--. 1 root root 14 Mar 11 2018 bzip2_file.bz2
-rw-r--r--. 1 root root 30 Mar 11 2018 gzip_file.gz
-rw-r--r--. 1 root root 0 Mar 11 2018 multi_stage_docker_file
-rw-r--r--. 1 root root 0 Mar 11 2018 not_archived_file
-rw-r--r--. 1 root root 396 Mar 11 2018 tar_bzip2_file.tar.bzip2
-rw-r--r--. 1 root root 2560 Mar 11 2018 tar_file.tar
-rw-r--r--. 1 root root 354 Mar 11 2018 tar_gz_file.tar.gz
-rw-r--r--. 1 root root 368 Mar 11 2018 tar_xz_file.tar.xz
-rw-r--r--. 1 root root 32 Mar 11 2018 xz_file.xz
-rw-r--r--. 1 root root 166 Mar 11 2018 zip_file.zip
[root@testvm Dockerfile]# docker build -f copy/Dockerfile -t build:copy ./copy/
Sending build context to Docker daemon 14.34 kB
Step 1/16 : FROM busybox AS build_env
Error parsing reference: "busybox AS build_env" is not a valid repository/tag: invalid reference format
(buildでエラーが出たため以下省略)
EXPOSE コンテナが利用するポートの宣言（実行上、意味はない）
実際にコンテナの特定ポートにアクセスするためには、docker runコマンドでコンテナ作成の際に-pオプションによるホスト・コンテナ間のポート接続が必要
[root@testvm Dockerfile]# cat expose/Dockerfile
FROM nginx
EXPOSE 443
ENTRYPOINT コンテナ起動時の実行コマンドを指定
RUNコマンドと同様に２種類（1.shell form, 2. exec form(推奨)）の書き方がある。
docker run実行時に引数が設定された場合、EXTRYPOINTのコマンドの引数となって実行される。
ENTRYPOINTを複数記述した場合は最後の記述のみ有効となる。
例えば、以下の通り1.shell formでは記述したコマンドはPID 1以外、 2.exec formで記述したコマンドはPID 1となる。
しかし、docker stopやdocker killではPID 1のプロセスに対してSIGTERMやSIGKILLが送信されるため、実行した本来のコマンドがSIGNALを受信できないため、1.shell formは非推奨となっている。
~ENTRYPOINT実行コマンドのSIGNALのハンドリングについて~
下記のSIGNALを受け取るスクリプトを用意して動作確認する。
※3秒毎にrunning...と表示して、SIGTERMもしくは(SIGHUP/SIGINT/SIGQUIT)を受け取るとメッセージを表示する（SIGTERMの場合はそれに加えて終了する）
[root@testvm Dockerfile]# cat entrypoint/signal/sample.sh
#!/bin/sh
trap_term_signal() {
echo "trapped SIGTERM"
exit 0
}
trap_some_signal() {
echo "trapped 1 or 2 or 3 SIGNAL"
}
trap "trap_term_signal" TERM
trap "trap_some_signal" 1 2 3
while :
do
echo "running..."
sleep 3
done
2.exec formの場合
[root@testvm Dockerfile]# cat entrypoint/signal/Dockerfile_exec
FROM ubuntu:16.04
COPY sample.sh /sample.sh
ENTRYPOINT ["/sample.sh"]
[root@testvm Dockerfile]# docker build -f entrypoint/signal/Dockerfile_exec -t build:entrypoint_signal_exec ./entrypoint/signal/
Sending build context to Docker daemon 4.096 kB
Step 1/3 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/3 : COPY sample.sh /sample.sh
---> 2a264ecbfe21
Removing intermediate container a4ba48b86e68
Step 3/3 : ENTRYPOINT /sample.sh
---> Running in 5c9871565f00
---> 17a857ae75e7
Removing intermediate container 5c9871565f00
Successfully built 17a857ae75e7
[root@testvm Dockerfile]# docker run --name entrypoint_signal_exec --rm -it build:entrypoint_signal_exec
running...
running...
別のターミナルで以下を実行
[root@testvm ~]# docker kill -s SIGHUP entrypoint_signal_exec
entrypoint_signal_exec
すると、はじめのターミナル上で以下のように表示される。SIGHUPなので終了しない。
running...
trapped 1 or 2 or 3 SIGNAL
running...
running...
次に、以下の通り、docker stopでSIGTERMをコンテナに送信する
[root@testvm ~]# docker stop entrypoint_signal_exec
entrypoint_signal_exec
すると、はじめのターミナルで動作が終了する
running...
trapped SIGTERM
[root@testvm Dockerfile]#
1.shell formの場合
同様にコンテナ起動＆SIGNAL送信すると以下のようになる
[root@testvm Dockerfile]# cat entrypoint/signal/Dockerfile_shell
FROM ubuntu:16.04
COPY sample.sh /sample.sh
ENTRYPOINT /sample.sh
[root@testvm Dockerfile]# docker build -f entrypoint/signal/Dockerfile_shell -t build:entrypoint_signal_shell ./entrypoint/signal/
Sending build context to Docker daemon 4.096 kB
Step 1/3 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/3 : COPY sample.sh /sample.sh
---> Using cache
---> 53543e654866
Step 3/3 : ENTRYPOINT /sample.sh
---> Running in aa143a231c49
---> e7872e3206a0
Removing intermediate container aa143a231c49
Successfully built e7872e3206a0
[root@testvm Dockerfile]#
[root@testvm Dockerfile]# docker run --name entrypoint_signal_shell --rm -it build:entrypoint_signal_shell
running...
この場合、別ターミナルで以下の通りSIGTERMを送信してもrunningのまま表示は変わらない。
これはshell formの場合はPID1のプロセスがsample.shではないため、SIGNALが届いていないことに起因する。
[root@testvm ~]# docker kill -s SIGHUP entrypoint_signal_shell
entrypoint_signal_shell
以下のようにdocker stopを実行した場合は10秒ほど経った後にコンテナが停止し、entrypoint_signal_shellと表示される。
これはdocker stopの仕様によるものであり、
PID1のプロセスにSIGTERMを送信して10秒ほど反応が返らない場合、SIGKILLを送信し強制終了する。
[root@testvm ~]# docker stop entrypoint_signal_shell
entrypoint_signal_shell
~ENTRYPOINTとRUNの違いについて~
RUN：イメージをbuild（作成）するために実際にコンテナでコマンドを実行する。
ENTRYPOINT：docker run（起動）する際にコマンドを実行する。つまり、動作しないコマンドでもbuildは成功してしまう。
CMD コンテナ起動時の実行コマンドを指定
※ENTRYPOINTとの違い：
docker runの際に実行されるデフォルトコマンドを指定するために使う
例えば以下のように使う
[root@testvm Dockerfile]# cat cmd/parameter/Dockerfile
FROM ubuntu:16.04
ENTRYPOINT ["top"]
CMD ["-H"]
[root@testvm Dockerfile]# docker build -f cmd/parameter/Dockerfile -t build:cmd_parameter ./cmd/parameter/
Sending build context to Docker daemon 2.048 kB
Step 1/3 : FROM ubuntu:16.04
---> 5f2bf26e3524
Step 2/3 : ENTRYPOINT top
---> Running in 72b1284dd07c
---> 86cfbe89f68e
Removing intermediate container 72b1284dd07c
Step 3/3 : CMD -H
---> Running in 9692599383c8
---> 332002a8f056
Removing intermediate container 9692599383c8
Successfully built 332002a8f056
[root@testvm Dockerfile]# docker run --rm -it build:cmd_parameter
top - 07:13:27 up 9:25, 0 users, load average: 0.07, 0.07, 0.06
Threads: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie
%Cpu(s): 0.1 us, 0.2 sy, 0.0 ni, 99.6 id, 0.0 wa, 0.0 hi, 0.0 si, 0.0 st
KiB Mem : 498736 total, 24964 free, 185872 used, 287900 buff/cache
KiB Swap: 2097148 total, 1986556 free, 110592 used. 264796 avail Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
1 root 20 0 36692 1720 1256 R 6.2 0.3 0:00.04 top
docker runの実行時に引数を与えると、CMDの内容を上書きできる。
以下ではbuild時の-H（スレッド単位での表示）を-b（バッチモード）で上書きしている。
[root@testvm Dockerfile]# docker run --rm -it build:cmd_parameter -b
top - 07:21:13 up 9:32, 0 users, load average: 0.01, 0.06, 0.05
Tasks: 1 total, 1 running, 0 sleeping, 0 stopped, 0 zombie
%Cpu(s): 0.1 us, 0.2 sy, 0.0 ni, 99.6 id, 0.0 wa, 0.0 hi, 0.0 si, 0.0 st
KiB Mem : 498736 total, 24720 free, 183884 used, 290132 buff/cache
KiB Swap: 2097148 total, 1986556 free, 110592 used. 266728 avail Mem
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
1 root 20 0 36520 1596 1236 R 0.0 0.3 0:00.02 top