前文中,罗列了docker使用中用到的基本命令
此文,将会对怎样使用Dockerfile去创建一个镜像做简单的介绍
Dockerfile命令
要开始编写Dockerfile,首先要对相关的命令有个清晰的认识
下面列出了部分Dockerfile命令的功能以及使用方法,供参考:
1. FROM
Dockerfile的第一条指定必须是FROM,用于指定基础镜像。
用法:FROM [image]:[tag]
2. MAINTAINER
用于指定此Dockerfile维护者信息。
用法:MAINTAINER <name> <email>
3. ADD
复制指定内容到镜像中,指定内容可以是一个相对或绝对路径,也可以是一个url(此时相当于wget),如果添加的文件是个tar压缩文件,文件在复制的时候会自动解压。
用法:ADD <src> <dest>
4. COPY
与ADD命令用法相同,区别是COPY只能复制本地文件
用法:COPY <src> <dest>
5. RUN
构建镜像时运行指定命令,建议多个命令尽量写在同一个RUN中,用&&
分割或使用\
换行。
用法:RUN <command>
RUN ["executable", "param1", "param2"]
前者在shell终端上运行,后者使用exec运行。
6. CMD
容器启动时运行指定命令,每个容器只能执行一条CMD命令,多个CMD命令时,只最后一条被执行。
用法:CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD <command> <param1> <param2>
7. ENV
指定一个环境变量,可以被RUN,WORKDIR命令使用,并在容器运行时保持。
用法:ENV <key> <value>
ENV <key1>=<value1> <k2>=<v2> <k3>=<v3> ...
8. ENTRYPOINT
配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖,每个Dockerfile中只能有一个 ENTRYPOINT ,当指定多个时,只有最后一个起效。
用法:ENTRYPOINT [“executable”, “param1”, “param2”]
ENTRYPOINT <command> <param1> <param2>
9. WORKDIR
设置工作目录,对RUN,CMD,ENTRYPOINT,COPY,ADD生效。如果不存在则会创建。
用法:WORKDIR <path>
10. EXPOSE
功能为暴漏容器运行时的监听端口给外部
用法:EXPOSE <port>
Dockerfile实践
通读过上面的Dockerfile命令,相信对编写一个Dockerfile有了一个初步的认识
接着,我们来通过一个具体的需求,来看一个完整的镜像是怎么通过Dockerfile生成的
1. 需求
使用32位的jre环境运行一个dubbo服务的jar包
2. 编写Dockerfile
首先,我们需要一个32位的jre环境,你可以从镜像仓库找一个,但此处,我们选择通过Dockerfile自己创建
# 指定基础镜像
FROM i386/centos:6
# 作者信息
MAINTAINER trainoo "trainoo@163.com"
# 添加jre环境,add会自动解压
ADD jre-8u211-linux-i586.tar.gz /opt/docker/java/jre8
# 设置java环境变量
ENV JAVA_HOME=/opt/docker/java/jre8/jre1.8.0_211 \
CLASSPATH=$JAVA_HOME/bin \
PATH=.:$JAVA_HOME/bin:$PATH
# 容器启动后执行,显示java版本号,可以查看环境是否安装成功
CMD ["java","-version"]
问:为什么使用 i386/centos:6 作为基础镜像?
答:因为32位的jre当然是使用32位的环境运行比较方便
如果使用64位的环境运行32位jre也是可以的,但是需要安装如下依赖:RUN yum update && yum -y install glibc.i686 zlib.i686 libstdc++.i686
如果打包的是64位的jre,那么基础镜像可以换成:frolvlad/alpine-glibc
问:jre-8u211-linux-i586.tar.gz 这个包从哪下载?
答:你可以从官网下载,当然,你看到此文章时,可能网址已经变化。
3. 构建
如上,我们写好了一个Dockerfile,只需把jre包跟Dockerfile放在同一路径
即可开始构建,命令如下:docker build -t jre8-64:second .
ps: 此处应该贴32位的运行过程的,但是64位的跟32位没太大区别,所以就这样吧
[root@xxx jre8-x32]# ll
total 89060
-rw-r--r--. 1 root root 369 Jun 27 18:38 Dockerfile
-rw-r--r--. 1 root root 91192891 Jun 26 14:52 jre-8u211-linux-i586.tar.gz
[root@xxx jre8-x64]# docker build -t jre8-64:second .
Sending build context to Docker daemon 87.86MB
Step 1/5 : FROM frolvlad/alpine-glibc:alpine-3.10
---> 74b43ef19206
Step 2/5 : MAINTAINER trainoo "trainoo@163.com"
---> Using cache
---> 1257f5f17f2a
Step 3/5 : ADD jre-8u211-linux-x64.tar.gz /opt/docker/java/jre8
---> Using cache
---> 10692b79be49
Step 4/5 : ENV JAVA_HOME=/opt/docker/java/jre8/jre1.8.0_211 CLASSPATH=$JAVA_HOME/bin PATH=.:$JAVA_HOME/bin:$PATH
---> Running in 1710cc8fd3aa
Removing intermediate container 1710cc8fd3aa
---> 5dd2f0ae922c
Step 5/5 : CMD ["java","-version"]
---> Running in 368238c0940b
Removing intermediate container 368238c0940b
---> e6e9cf729e37
Successfully built e6e9cf729e37
Successfully tagged jre8-64:second
[root@xxx jre8-x64]# docker images -f reference=jre8*
REPOSITORY TAG IMAGE ID CREATED SIZE
jre8-64 second e6e9cf729e37 53 seconds ago 251MB
jre8-32 base 9035f0dcd0ed 20 hours ago 433MB
jre8-64 base ce0823b7fdc3 47 hours ago 251MB
由上面的构建步骤可以看出,每运行一个命令,都会产生一个临时镜像,所以为了避免产生多余的临时镜像,我们要尽量的把多个相同指令的的构建步骤,写在同一行里。
4. 运行项目
假设我们把项目打包好了,打包好的jar包为:my-service-1.0.jar。
FROM jre8-32:base
MAINTAINER trainoo "trainoo@163.com"
COPY ./jar/ /opt/dubbo-server/
RUN cd /opt/dubbo-server/ && mv $(ls | grep jar) app.jar
WORKDIR /opt/dubbo-server/
CMD ["java","-Xms512M","-Xmx512M","-jar","app.jar"]
// 为了通用性,这里把jar文件(如果不是springboot项目,还有lib等依赖包)放在jar目录下,COPY时一起复制过去
// 同样目的,使用 mv $(ls | grep jar) app.jar 将需要被执行的jar文件统一命名成 app.jar
# 构建镜像
[root@xxx jre8-x64]# docker build -t myservice:v1 .
.....此处省略部分.....
# 启动容器
[root@xxx jre8-x64]# docker run -d --name myservice myservice:v1
# 查看容器
[root@xxx jre8-x64]# docker ps
后续总结
事情总是不会这么顺利,中途总是会有一些小插曲,所以下面是可能遇到的问题的解决方案
docker 批量删除产生的缓存镜像
# 第一种风格
docker ps -a | grep "Exited" | awk '{print $1 }'|xargs docker stop
docker ps -a | grep "Exited" | awk '{print $1 }'|xargs docker rm
docker images | grep none | awk '{print $3}' | xargs docker rmi
# 第二种风格
docker rm $(docker ps -aq -f status=exited)
docker rmi $(docker images -qa -f reference=*:v1)
container 时区跟 host 不一致
# Dockerfile中添加
RUN echo "Asia/Shanghai" > /etc/timezone
# 启动时添加:-v /etc/localtime:/etc/localtime:ro
docker run -d -v /etc/localtime:/etc/localtime:ro --net mynet --name myservice myservice:v1
docker运行项目,日志中文显示???
# Dockerfile中添加,指定语言环境
RUN localedef -i en_US -f UTF-8 en_US.UTF-8
ENV LANG en_US.UTF-8
ENV LANGUAGE en_US:en
ENV LC_ALL en_US.UTF-8