Dockerfile极简入门与实践

Posted 2022-02-28 trainoo

前文中，罗列了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 "[email protected]"
# 添加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位没太大区别，所以就这样吧

[[email protected] 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

[[email protected] 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 "[email protected]"
 ---> 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

[[email protected] 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 "[email protected]"
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

# 构建镜像
[[email protected] jre8-x64]# docker build -t myservice:v1 .
.....此处省略部分.....
# 启动容器
[[email protected] jre8-x64]# docker run -d --name myservice myservice:v1
# 查看容器
[[email protected] 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