forked from JavaDevTeam/notes
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathdocker-Dockerfile.java
More file actions
195 lines (160 loc) · 5.72 KB
/
Copy pathdocker-Dockerfile.java
File metadata and controls
195 lines (160 loc) · 5.72 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
------------------------
Dockerfile |
------------------------
# Dockerfile基于DSL(Domain Specifile Language)语法的指令来构建一个Docker镜像
# Docker大体上按照如下流程执行Dockerfile中的命令
* Docker 从基础镜像运行一个人容器
* 执行一条指令,对容器做出修改
* Docker再基于刚才提交的镜像运行一个新容器
* 执行Dockerfile中的下一条指令直到所有指令都执行完毕
# 如果Dockerfile由于一些原因没有正常结束,还是可以得到一个可以使用的镜像
* 可以基于该镜像生成一个容器,进入交互式环境查看排查原因
# 以 # 开头表示注释
# 第一条之类必须是: FROM
* 表示基础镜像,它必须指定一个已经存在的镜像
# 参数可以通过 $ 引用
ENV DIR /opt/app
WORKDIR $DIR
------------------------
Dockerfile |
------------------------
FROM
* 基本的镜像
FROM centos:7
* FROM 其实可以出现多次,表示多个阶段的构建
* 可以为某个阶段起别名
FROM golang:1.9-alpine as builder
docker build --target builder -t username/imagename:tag .
MAINTAINER
* 作者信息
ENV
* 环境变量
ENV JAVA_HOME /usr/local/java
* 也可以一次性设置多个
ENV JAVA_HOM=/home/java PYTHON_HOME=/home/python
* 也可以在其他的指令中引用该变量
ENV DIR /opt/app
WORKDIR $DIR
* 这些环节变量会持久保存到镜像创建的容器,可以用过 env 指令查看
RUN
* 构建时候,执行的shell命令
RUN yum -y install git
EXPOSE
* 对外公开的端口
EXPOSE 80
CMD
* 容器启动时运行的命令
COM ["/bin/true","-l"]
* 跟 docker run 指令后指定的命名一样的,而且该指令指定的命名会覆盖它
* 整个文件中只能定义一个CMD指令,如果定义了多个,那么只有最后一个生效
ENTRYPOINT
* 类似于 CMD 指令,也是用来执行命令的
ENTRYPOINT ["/usr/sbin/nginx"]
* 它不会被 docker run 指令的命令覆盖
* docker run 指令的的命令参数会作为值,传递给这个命令
ENTRYPOINT ["/usr/sbin/nginx"]
+
docker run ... nginx-image -g "daemon off"
=
/usr/sbin/nginx -g "daemon off"
* 实在需要覆盖该命令,可以通过 --entrypoint 来覆盖
* 可以配合CMD使用生成一条指令
ENTRYPOINT ["/usr/sbin/nginx"]
+
CMD ["-h"]
=
/usr/sbin/nginx -h
WORKDIR
* 在从镜像创建一个新的容器时,会在容器内部内置一个工作目录
WORKDIR /usr/local/webapp
* CMD 和 ENTRYPOINT 指令都会在这个目录下执行
* 该命令可以出现多次,表示目录切换
WORKDIR /usr/local/db
RUN mysql install
WORKDIR /usr/local/webapp
ENTRYPOINT ["setup"]
* 可以在docker run时通过 -w 参数来覆盖该配置
docer run ... -w /var/log ...
USER
* 指镜像会以哪个用户去执行
USER root
* 用户必须先建立好,可以使用 RUN 指令先创建用户
* 可以指定用户名,uid,用户组,gid,以及各种组合
USER user
USER user:group
* 如果未指定,默认为 root
VOLUME
* 基于镜像创建的容器,添加卷
* 一个卷可以存在一个或者多个容器内特定的目录,这个目录可以绕过联合文件系统,并且提供如下共享数据或者对数据进行持久化的功能
* 卷可以在容器之间共享和重用
* 对卷的修改是立即生效的
* 对卷的修改,不会对更新镜像产生影响
* 卷会一直存在,直到没有容器使用它
* 可以一致性指定一个或者多个卷
VOLUME ["/opt/project","/data"]
ADD
* 把构建环境下的文件和目录复制到镜像中
* 需要指定源文件和目标文件的位置
ADD software.lic /opt/application/software.lic
* 源文件也可以是一个url,但是不能对构建目录外的文件进行操作
* 通过结尾来判断是文件还是文件夹,如果结尾以 / 字符结尾,表示为一个文件夹,反之则为一个文件
* 如果源文件是压缩文件(zip),而目标是一个目录,则会主动解压
ADD a.zip /usrl/local/a/
* 该指令会让构建缓存失效,如果通过ADD指令向镜添加一个文件或者目录,那么Df文件中的后续指令不能继续使用之前的缓存
COPY
* 跟ADD一样,唯一不同的时候,如果cp的时候压缩文件,不会进行解压操作
* 支持通配符,规则要满足 Go 的 filepath.Match 规则
COPY hom* /mydir/
COPY hom?.txt /mydir/
* 不仅仅是从文件目录,还可以从其他的镜像复制文件
COPY --from=imgae:tag /source /target
COPY --from=nginx:latest /etc/nginx/nginx.conf /nginx.conf
* 也可以从指定的构建阶段复制
COPY --from=buildName /source /target
LABEL
* 为Docker镜像添加元数据信息,k=v形式展示
LABEL version="10.1"
LABEL location="中国 - 重庆" type="DLK" role="ADMIN"
* 可以通过 docker inspect 来查看 Docker 镜像中的标签信息
STOPSIGNAL
* 停止容器的时候,发送指定的系统信号给容器
* 信号必须是内核系统调用中的合法数(数字或者名称)
STOPSIGNAL 9
STOPSIGNAL SIGKILL
ARG
* 可以在docker build命令运行时候传递构建运行时的变量
* 它的作用就是定义一了一堆变量,这些变量可以在df文件中被引用
* 但是它们的值,是在执行构建的时候才通过命名来初始化
* 在构建时使用 --build-arg,用户只能在构建时指定Df文件中定义过的参数
ARG build
docker build ... --build-arg build=1234 ....
* 也可以有默认值,如果build时没指定,则使用默认值
ARG webapp_usr=user
* Docker预定义了N多ARG变量,可以直接赋值使用
HTTP_PROXY
ONBUILD
* 为镜像添加触发器,当该镜像被其他镜像当作基础镜像的时候,该镜像中的触发器会被执行
* 触发器会在构建过程中插入新指令,这些指令是跟在FROM之后执行的(FROM 哪个镜像,哪个镜像的触发器就会执行)
* 触发器可以是任何构建之类
ONBUILD ADD . /app/src/
ONBUILD RUN cd /app/src && make && make install
* 触发器会按照父级镜像中的指定顺序执行,并且只能被继承一次(只能在子镜像中运行,不能在孙子镜像中运行)
HEALTHCHECK
* 设置检查容器健康状况的命令,告诉 Docker 应该如何进行判断容器的状态是否正常
HEALTHCHECK [options] CMD [命令]
* 如果基础镜像有健康检查指令,设置为NULL可以屏蔽掉其健康检查指令
HEALTHCHECK NONE
* 一个镜像指定了 HEALTHCHECK 指令后,用其启动容器,初始状态会为 starting,在 HEALTHCHECK 指令检查成功后变为 healthy,如果连续一定次数失败,则会变为 unhealthy
* 支持下列选项：
--interval=<间隔>
两次健康检查的间隔，默认为 30 秒
--timeout=<时长>
健康检查命令运行超时时间,如果超过这个时间,本次健康检查就被视为失败，默认 30 秒
--retries=<次数>
当连续失败指定次数后,则将容器状态视为 unhealthy,默认 3 次
* 该指令只能出现一次,如果出现多次的话,只有最后一个生效
------------------------------
scratch |
------------------------------
# 元镜像