你必须知道的Dockerfile
转载 自 https://www.cnblogs.com/edisonchou/p/dockerfile_inside_introduction.html
1. 关于Dockerfile
在Docker中创建镜像最常用的方式,就是使用Dockerfile。Dockerfile是一个Docker镜像的描述文件,我们可以理解成火箭发射的A、B、C、D…的步骤。Dockerfile其内部包含了一条条的指令,每一条指令构建一层,因此每一条指令的内容,就是描述该层应当如何构建。
2. Dockerfile 结构
dockerfile结构大致分为4个部分
-
基础镜像信息
-
维护者信息
-
镜像操作指令
-
容器启动时执行的指令
Dockerfile每行支持一条指令,每条指令可带多个参数,支持使用以#号开头的注释。
Dockerfile的一个例子
#基于centos镜像
FROM centos
#维护人的信息
MAINTAINER The CentOS Project <303323496@qq.com>
#安装httpd软件包
RUN yum -y update
RUN yum -y install httpd
#开启80端口
EXPOSE 80
#复制网站首页文件至镜像中web站点下
ADD index.html /var/www/html/index.html
#复制该脚本至镜像中,并修改其权限
ADD run.sh /run.sh
RUN chmod 775 /run.sh
#当启动容器时执行的脚本文件
CMD ["/run.sh"]
3.Dockerfile常用的指令
FROM
- 作用: 指明构建的新镜像是来自于哪个基础镜像
- 例子:
FROM centos:6
MAINTAINER
- 作用: 指明镜像维护着及其联系方式 (一般是邮箱地址)
- 例子:
MAINTAINER Edison Zhou <edisonchou@hotmail.com>
- 警示: 通常并不推荐使用, 更加推荐使用LABEL来指定镜像作者, 比如
LABEL maintainer="edisonzhou.cn"
RUN
-
作用: 构建镜像时运行的Shell命令
-
例子:
RUN ["yum", "install", "httpd"] RUN yum install httpd
CMD
-
作用: 启动容器时执行的Shell命令
-
例子:
CMD ["-C", "/start.sh"] CMD ["/usr/sbin/sshd", "-D"] CMD /usr/sbin/sshd -D
EXPOSE
-
作用: 声明容器运行的服务端口
-
例子:
EXPOSE 80 8080
ENV
-
作用: 设置镜像内环境变量
-
例子:
ENV MYSQL_ROOT_PASSWORD 123456 ENV JAVA_HOME /usr/local/jdk1.8.0_45
ADD
-
作用: 拷贝文件或目录到镜像中
-
例子:
ADD <src>...<dest> ADD html.tar.gz /var/www/html ADD https://xxx.com/html.tar.gz /var/www/html
-
额外: 如果是URL或者压缩包, 会自动下载或自动解压
COPY
- 作用: 和ADD指令类似 ( 但是不会自动下载和解压缩 )
- 例子:
COPY ./start.sh /start.sh
ENTRYPOINT
-
作用: 启动容器时执行的Shell命令,同CMD类似,只是由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖,而且,这些命令行参数会被当作参数传递给ENTRYPOINT指定指定的程序
-
例子:
ENTRYPOINT ["/bin/bash", "-C", "/start.sh"] ENTRYPOINT /bin/bash -C '/start.sh'
-
警告: Dockerfile文件中也可以存在多个ENTRYPOINT指令,但仅有最后一个会生效。
VOLUME
-
作用: 指定容器挂载点到宿主机自动生成的目录或其他容器
-
例子:
VOLUME ["/var/lib/mysql"]
-
警告: 一般不会在Dockerfile中用到,更常见的还是在docker run的时候指定-v数据卷
USER
-
作用: 为RUN、CMD和ENTRYPOINT执行Shell命令指定运行用户
-
例子:
USER <user>[:<usergroup>] USER <UID>[:<UID>] USER edisonzhou
WORKDIR
-
作用: 与 linux 中的 cd命令 类似 ,切换到 xxx目录 作为当前工作目录
-
例子:
WORKDIR /data
HEALTHCHECK
-
作用: 告诉Docker如何测试容器以检查它是否仍在工作,即健康检查
-
例子:
HEALTHCHECK --interval=5m --timeout=3s --retries=3 \ CMD curl -f http:/localhost/ || exit 1
-
参数:
- –interval=DURATION (default: 30s):每隔多长时间探测一次,默认30秒
- – timeout= DURATION (default: 30s):服务响应超时时长,默认30秒
- –start-period= DURATION (default: 0s):服务启动多久后开始探测,默认0秒
- –retries=N (default: 3):认为检测失败几次为宕机,默认3次
-
返回值:
- 0:容器成功是健康的,随时可以使用
- 1:不健康的容器无法正常工作
- 2:保留不使用此退出代码
ARG
-
作用: 在构建镜像时,指定一些参数
-
例子:
FROM centos:6 ARG user # ARG user=root USER $user
-
使用: docker build 就可以带上参数了
docker build --build-arg user=edisonzhou Dockerfile .
4. 使用案例
下面是一个Java Web应用的镜像Dockerfile,综合使用到了上述介绍中最常用的几个命令:
FROM centos:7
MAINTANIER www.edisonchou.com
ADD jdk-8u45-linux-x64.tar.gz /usr/local
ENV JAVA_HOME /usr/local/jdk1.8.0_45
ADD apache-tomcat-8.0.46.tar.gz /usr/local
COPY server.xml /usr/local/apache-tomcat-8.0.46/conf
RUN rm -f /usr/local/*.tar.gz
WORKDIR /usr/local/apache-tomcat-8.0.46
EXPOSE 8080
ENTRYPOINT ["./bin/catalina.sh", "run"]
有了Dockerfile,就可以创建镜像了:
docker build -t tomcat:v1 .
最后,可以通过以下命令创建容器:
docker run -itd --name=tomcate -p 8080:8080 \
-v /app/webapps/:/usr/local/apache-tomcat-8.0.46/webapps/ \
tomcat:v1
5. 最后
感谢观看!
来自一个萌新的日常摘抄~~~~