Dockerfile 镜像制作与相关优化
一、本文说明
整理 Dockerfile 常用指令(ADD、MAINTAINER、LABEL、EXPOSE、VOLUME、ENV、ARG、ENTRYPOINT、HEALTHCHECK 等)的使用方法,以及基于 Dockerfile 构建多游戏镜像、镜像打标签、构建优化和多服务启动的实践。示例中的镜像名、路径和密码均为演示值。
二、ADD 指令:构建多游戏镜像
1. 关键结论
ADD 与 COPY 都是把本地文件复制到镜像,但 ADD 多两个能力:
源文件是
.tar.gz/.tar压缩包时,会自动解压到目标目录;源文件可以是 URL(会先下载再复制)。
推荐用法:复制普通文件优先用 COPY,只在需要自动解压 tar 包时才用 ADD。
2. Dockerfile 示例
# 指定基础镜像,后续操作都在该镜像之上进行
FROM alpine:3.20.2
# 更换软件源并安装 nginx,安装完成后清理缓存
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
/etc/apk/repositories && \
apk update && \
apk add nginx && \
rm -rf /var/cache/* /usr/share/nginx/* && \
mkdir -pv /usr/share/nginx/html/huangjinkuanggong && \
mkdir -pv /usr/share/nginx/html/killbird
# ADD 会把 tar 包内容自动解压到指定路径,
# 可以理解为:先拷贝到容器,再解压,最后删除源文件
ADD demo-huangjinkuanggong.tar.gz /usr/share/nginx/html/huangjinkuanggong
ADD demo-killbird.tar.gz /usr/share/nginx/html/killbird
# 把本地配置拷贝到容器并覆盖原文件
COPY games.conf /etc/nginx/http.d/default.conf
# 指定容器启动命令
CMD ["nginx", "-g", "daemon off;"]原课堂记录里清理缓存的写法是
rm -rf /var/cache/ rm -f /usr/share/nginx/*。这种写法把rm和-f当成了路径参数,属于笔误,建议改为rm -rf /var/cache/* /usr/share/nginx/*。
3. 编写编译脚本
#!/bin/bash
TAG=$1
docker image build -t demo-games:v2.${TAG:-4} .
docker container rm -f `docker container ps -qa`
docker container run -d --name games --network host demo-games:v2.${TAG:-4}
docker container ps -l执行:
./build.sh 6脚本说明:
${TAG:-4}:不传参数时默认标签为4,传6则为v2.6;--network host:容器共享宿主机网络,nginx 直接监听宿主机的 80 端口;docker container rm -f \docker container ps -qa``:先清掉所有容器避免名称冲突。没有容器时会报 "requires at least 1 argument",可在末尾加2>/dev/null消除提示。
4. 观察中间层镜像
每一条 Dockerfile 指令都会产生一个新的镜像层。构建完成后用 docker image ls -a 可以看到中间层:
docker image ls -a | grep 324bc02ae123
# alpine 3.20.2 324bc02ae123 ... 7.8MB
docker image ls -a | grep 6ac145279d85
# <none> <none> 6ac145279d85 ... 9.25MB
docker image ls -a | grep bd8b482ff427
# demo-games v2.6 bd8b482ff427 ... 15.6MB<none> 就是没有被最终打标签的中间层,最终镜像由这些层叠加而成。
5. 访问测试
宿主机 /etc/hosts 增加:
10.0.0.101 game01.example.com
10.0.0.101 game02.example.com浏览器访问对应域名即可。
三、MAINTAINER 与 LABEL:给镜像打标签
1. 指令说明
MAINTAINER 用于声明作者信息,但可读性较差,已被官方弃用;官方推荐用 LABEL 以键值对的形式声明元数据。
# 已弃用
MAINTAINER demo demo@example.com www.example.com
# 推荐
LABEL school=demo \
class=demo-class \
auther=demo \
email=demo@example.com \
office=www.example.com2. 查看镜像信息
docker image inspect -f "{{.Author}}" demo-games:v2.8
# demo
docker image inspect -f "{{.Config.Labels.auther}}" demo-games:v2.8
# demo四、构建优化:缓存与 .dockerignore
1. 观察缓存命中
再次执行构建时,没变化的指令会显示 Using cache:
Step 2/7 : RUN sed -i ... apk add nginx ...
---> Using cache因此把不经常改动的指令放前面、经常改动的放后面,可以充分利用缓存,加快构建速度。
2. 构建上下文过大
Docker 构建时会把当前目录(构建上下文)整体发给守护进程:
dd if=/dev/zero of=./bigfile bs=1M count=1024
# 生成了一个 1GB 的无用文件再构建时:
Sending build context to Docker daemon 1.087GB目录里的无关大文件会严重影响构建速度。
3. 使用 .dockerignore
在构建目录创建 .dockerignore:
big*
*.exe
*.txt
*.log被匹配的文件不会进入构建上下文。
4. 优化思路总结
编译速度:
不常改的指令放上面、常改的放下面,利用层缓存;
用
.dockerignore忽略无关文件;使用国内软件源或本地仓库,提升下载速度;
较大的软件包放到本地或内网文件站点,避免每次下载。
镜像大小:
删除缓存和无用软件包;
尽量合并指令,减少中间层(
docker image ls -a可以看到每层);使用较小的基础镜像(如 Alpine)。
五、启动容器技巧
1. 进入容器时指定工作目录
docker exec -it -w /usr/share/nginx/html games sh2. 运行容器时指定匿名存储卷
docker run -d --name game -v /usr/share/nginx/html demo-games:v2.9查看卷落在宿主机的位置:
docker inspect -f "{{range .Mounts}}{{.Source}}{{end}}" game
# /var/lib/docker/volumes/<随机ID>/_data3. 随机端口映射
docker run -dp :80 --name c2 demo-games:v2.9
docker ps -l示例结果:
PORTS
0.0.0.0:32770->80/tcp, :::32770->80/tcp-p :80 让宿主机随机分配高位端口映射到容器 80 端口。
六、VOLUME / EXPOSE / WORKDIR 案例
FROM alpine:3.20.2
LABEL school=demo class=demo-class auther=demo
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
/etc/apk/repositories && \
apk update && \
apk add nginx && \
rm -rf /var/cache/* /usr/share/nginx/*
ADD code/demo-pingtai.tar.gz /usr/share/nginx/html/pingtai
COPY config/games.conf /etc/nginx/http.d/default.conf
# 指定工作目录,连接容器时自动切换到该目录
WORKDIR /usr/share/nginx/html
# 声明暴露的端口
EXPOSE 80
# 将容器指定目录创建为存储卷
VOLUME /usr/share/nginx/html
CMD ["nginx", "-g", "daemon off;"]指令说明:
验证:
docker run -dP --name c1 demo-games:v2.13
docker ps -l
docker inspect -f "{{range .Mounts}}{{.Source}}{{end}}" c1
docker exec -it c1 sh
pwd
# /usr/share/nginx/html七、ENV / ARG 案例:多服务启动
1. 指令区别
2. 手动启动 openssh 的关键命令
apk add openssh-server # 安装 sshd
ssh-keygen -A # 生成主机密钥
sed -i 's@#PermitRootLogin prohibit-password@PermitRootLogin yes@' /etc/ssh/sshd_config
/usr/sbin/sshd # 启动 sshd
echo root:123456 | chpasswd # 免交互修改 root 密码3. Dockerfile
FROM alpine:3.20.2
WORKDIR /usr/share/nginx/html
EXPOSE 80
VOLUME /usr/share/nginx/html
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
/etc/apk/repositories && \
apk update && \
apk add nginx openssh-server curl && \
sed -i 's@#PermitRootLogin prohibit-password@PermitRootLogin yes@' /etc/ssh/sshd_config && \
ssh-keygen -A && \
rm -rf /var/cache/* /usr/share/nginx/html/*
# 运行时变量,构建和运行阶段都有效
ENV DEMO_USERNAME=root \
DEMO_PASSWORD=321
# 构建期变量,仅构建阶段有效
ARG DEMO_SCHOOL=demo \
DEMO_CLASS=demo-class
RUN touch /demo-${DEMO_USERNAME} && \
touch /demo-${DEMO_PASSWORD} && \
touch /demo-xixi-${DEMO_SCHOOL} && \
touch /demo-haha-${DEMO_CLASS}
ADD code/demo-zhiwu.tar.gz /usr/share/nginx/html/zhiwu
COPY config/games.conf /etc/nginx/http.d/default.conf
COPY scripts/start.sh /
CMD ["/bin/sh", "-x", "/start.sh"]4. 启动脚本 start.sh
#!/bin/sh
USERNAME=${DEMO_USERNAME:-root}
PASSWORD=${DEMO_PASSWORD:-123}
id ${USERNAME} || adduser ${USERNAME} -D
echo $USERNAME:$PASSWORD | chpasswd
/usr/sbin/sshd
nginx -g 'daemon off;'5. 运行时用 -e 覆盖 ENV
docker run -dP --name c1 \
-e DEMO_USERNAME=xixi \
-e DEMO_PASSWORD=haha \
demo-games:v2.14进入容器验证:
docker exec -it c1 sh
env | grep DEMO_
# DEMO_USERNAME=xixi
# DEMO_PASSWORD=haha6. 构建时用 --build-arg 覆盖 ARG
docker build -t demo-games:v2.15 \
--build-arg DEMO_SCHOOL=demo-school \
--build-arg DEMO_CLASS=demo-class .验证构建期变量已生效:
docker run --rm -it demo-games:v2.15 sh
ls /demo-*
# /demo-321
# /demo-haha-demo-class
# /demo-root
# /demo-xixi-demo-school八、HEALTHCHECK:健康检查
HEALTHCHECK 用来判断容器内服务是否正常。指定健康检查后,容器除了正常状态外,还有健康状态:
初始为
starting;检查通过后变为
healthy;连续失败一定次数后变为
unhealthy。
HEALTHCHECK --interval=1s \
--timeout=1s \
--start-period=10s \
--retries=5 \
CMD curl -H "host: game01.example.com" 127.0.0.1参数说明:
九、ENTRYPOINT:指定启动命令
1. CMD 与 ENTRYPOINT 的区别
2. 示例
ENTRYPOINT ["/bin/sh", "-x", "/start.sh"]两者混用时,CMD 的内容会作为参数传给 ENTRYPOINT:
ENTRYPOINT ["/bin/sh", "-c"]
CMD ["tail -f /etc/hosts"]十、Dockerfile 指令速查表
十一、总结
ADD能自动解压 tar 包,但普通文件复制优先用COPY;MAINTAINER已弃用,作者信息改用LABEL;构建优化围绕两条主线:编译速度(缓存、
.dockerignore、国内源)和镜像大小(清理缓存、合并层、小基础镜像);ENV运行时和构建时都有效,ARG仅构建时有效;EXPOSE只是声明端口,真正映射靠-p;VOLUME用于声明匿名卷;CMD可被覆盖,ENTRYPOINT固定入口,两者可混用;HEALTHCHECK让容器具备starting/healthy/unhealthy状态。