Dockerfile 多阶段构建、Docker Compose 与私有仓库
一、USER:以普通用户运行容器
1. 手动测试命令
adduser -u 2024 demo -D
sed -i '/^user/s#nginx#demo#' /etc/nginx/nginx.conf
要点:
adduser -u 2024 demo -D创建 UID 为 2024 的普通用户;- 普通用户启动 nginx 前,要先准备好运行所需的目录和日志文件,例如
/var/lib/nginx/tmp/client_body、/var/lib/nginx/logs/error.log,并把属主改成该用户。
2. Dockerfile 示例
FROM alpine:3.20.2
LABEL school=demo \
class=demo-class \
auther=demo
WORKDIR /usr/share/nginx/html
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/*
EXPOSE 80 22
ADD code/demo-chengbao.tar.gz /usr/share/nginx/html/chengbao
COPY config/games.conf /etc/nginx/http.d/default.conf
COPY config/nginx.conf /etc/nginx/nginx.conf
# 创建普通用户,并准备 nginx 运行所需的目录、日志及属主
RUN adduser -u 2024 demo -D && \
install -d /var/lib/nginx/tmp/client_body -o demo -g demo && \
touch /var/lib/nginx/logs/error.log /var/log/nginx/access.log && \
chown demo:demo -R /run/nginx/ /var/lib/nginx/logs/error.log \
/var/log/nginx/access.log /var/lib/nginx/
# 指定容器进程的运行用户(默认 root),指定普通用户前要确保该用户已存在
USER demo
COPY scripts/start.sh /
HEALTHCHECK --interval=1s \
--timeout=1s \
--start-period=10s \
--retries=5 \
CMD curl -H "host: game01.example.com" 127.0.0.1
ENTRYPOINT ["/bin/sh", "-x", "/start.sh"]
3. nginx 配置
config/games.conf:
server {
listen 0.0.0.0:80;
root /usr/share/nginx/html/chengbao;
server_name game01.example.com;
}
config/nginx.conf 第一行指定运行用户:
user demo;
worker_processes auto;
# 其余为 nginx 默认配置...
4. 验证
docker exec -it c1 sh
whoami
# demo
ps -ef
# PID USER COMMAND
# 1 demo /bin/sh -x /start.sh
# 12 demo nginx: master process nginx
# 13 demo tail -f /etc/hosts
# 14 demo nginx: worker process nginx
nginx 以普通用户可以正常启动;但 sshd 用普通用户启动可能存在问题,需要进一步排查(如 22 端口需要 root 权限绑定、sshd 需要特权等)。
二、ONBUILD:子镜像构建时触发
1. 指令说明
ONBUILD 定义的指令在当前镜像构建时不执行,只有当其他镜像以当前镜像为基础镜像(FROM 引用它)时才会触发。
父镜像 Dockerfile 末尾:
ONBUILD RUN mkdir /demo-tiaoyitiao && \
touch /demo-tiaoyitiao/xixi.log && \
touch /demo-tiaoyitiao/haha.log
ONBUILD LABEL blog=https://www.example.com/blog
子镜像 haha.dockerfile:
FROM demo-games:v2.19
RUN mkdir /demo-class
2. 用 -f 同时构建多个 Dockerfile
#!/bin/bash
# 不指定 -f 时,默认使用名为 Dockerfile 的文件
docker image build -t demo-games:v2.19 ..
# -f 指定 Dockerfile 的名称
docker image build -t demo-games:v2.20 -f ../haha.dockerfile ..
docker container rm -f `docker container ps -qa` 2>/dev/null
3. 查看 OnBuild 与 Labels 的差异
docker inspect -f "{{.Config.OnBuild}}" demo-games:v2.19
# [RUN mkdir /demo-tiaoyitiao && ... LABEL blog=https://www.example.com/blog]
docker inspect -f "{{.Config.OnBuild}}" demo-games:v2.20
# []
docker inspect -f "{{.Config.Labels}}" demo-games:v2.20
# map[auther:demo blog:https://www.example.com/blog class:demo-class ...]
解释:v2.19 是父镜像,本身带 OnBuild 指令;v2.20 以它为基镜像构建,OnBuild 指令被触发执行,所以 v2.20 的 OnBuild 为空,而 Labels 里多出了 blog。
4. 容器验证
docker run -d --name c1 demo-games:v2.19
docker run -d --name c2 demo-games:v2.20
docker exec c1 ls -l /
# 根目录没有 /demo-tiaoyitiao、/demo-class
docker exec c2 ls -l /
# 根目录多出 /demo-tiaoyitiao 和 /demo-class
三、用 -f 指定多个 Dockerfile
docker image build -t demo-games:v2.20 -f ../xixi.dockerfile ..
docker image build -t demo-games:v2.21 -f ../haha.dockerfile ..
说明:-f 指定要使用的 Dockerfile 文件名,不指定时默认找 Dockerfile。
四、多阶段构建
1. 目的
把「编译/准备阶段」和「最终运行阶段」拆开,最终镜像只保留运行需要的产物,从而显著减小镜像体积。
2. 示例 Dockerfile
# 阶段一:准备 bigfile 和日志
FROM alpine:3.20.2 AS xixi
RUN mkdir /demo-xixi && \
dd if=/dev/zero of=/demo-xixi/bigfile.txt count=1024 bs=1M && \
echo "xixi ~" > /demo-xixi/xixi.log
# 阶段二:准备另一个大文件
FROM alpine:3.20.2 AS haha
RUN mkdir /demo-haha && \
dd if=/dev/zero of=/demo-haha/bigfile.txt count=2048 bs=1M && \
echo "haha ~" > /demo-haha/haha.log
# 最终阶段:只拷贝前两个阶段里需要的小文件
FROM alpine:3.20.2
LABEL school=demo class=demo-class office=www.example.com
RUN mkdir /demo-hehe
COPY --from=xixi /demo-xixi/xixi.log /demo-hehe
COPY --from=haha /demo-haha/haha.log /demo-hehe
ENTRYPOINT ["tail", "-f", "/etc/hosts"]
3. 结果
docker image build -t demo-games:v3.0 .
docker image ls demo-games:v3.0
# REPOSITORY TAG SIZE
# demo-games v3.0 7.8MB
虽然前两个阶段各自生成了 1GB、2GB 的 bigfile.txt,但最终阶段没有拷贝它们,所以最终镜像只有 7.8MB。
五、多阶段构建案例:Golang SDK
1. 只放 SDK 的镜像
FROM alpine:3.20.2
LABEL auther=demo school=demo class=demo-class office=www.example.com
ADD go1.22.5.linux-amd64.tar.gz /demo/softwares
RUN ln -svf /demo/softwares/go/bin/* /usr/local/bin/
CMD ["tail", "-f", "/etc/hosts"]
这种写法只验证了 SDK 能解压、工具能链接,最终镜像约 230MB,没有实际意义,真正有价值的是下一节的两阶段编译。
六、多阶段构建案例:Golang 二进制程序
1. Go 源码(开发人员提供)
package main
import "fmt"
type School struct {
Name string
Office string
}
func (s *School) SayHi() {
fmt.Printf("%s的公司官网是%s\n", s.Name, s.Office)
}
func main() {
school := &School{}
school.Name = "示例"
school.Office = "https://www.example.com"
school.SayHi()
}
2. 两阶段 Dockerfile
# 编译阶段:装 Go 工具链,编译出二进制
FROM alpine:3.20.2
ADD go1.22.5.linux-amd64.tar.gz /demo/softwares
RUN ln -svf /demo/softwares/go/bin/* /usr/local/bin/ && \
mkdir /demo/code
COPY hello.go /demo/code
RUN go build -o /demo/src/hello /demo/code/hello.go
# 运行阶段:只拷贝编译产物
FROM alpine:3.20.2
LABEL auther=demo school=demo class=demo-class office=www.example.com
COPY --from=0 /demo/src/hello /
CMD ["tail", "-f", "/etc/hosts"]
3. 镜像大小对比
docker image ls demo-games:v3.1
# 230MB (只装 SDK 的版本)
docker image ls demo-games:v3.2
# 9.71MB (两阶段构建,只保留二进制)
4. 验证二进制
docker exec -it go sh
./hello
# 示例的公司官网是https://www.example.com
七、容器日志输出到 stdout / stderr
容器内的服务尽量把日志写到标准输出、标准错误,这样 docker logs 才能看到。
在 Dockerfile 里用软链接把 nginx 日志指向 stdout / stderr:
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/* && \
ln -svf /dev/stderr /var/log/nginx/error.log && \
ln -svf /dev/stdout /var/log/nginx/access.log
之后访问 nginx,docker logs <容器> 就能看到访问日志。
八、docker-compose 基础
1. 什么是 docker-compose
docker-compose 是用来管理一组容器运行的工具:一个 docker-compose.yaml 定义多个服务,一条命令统一编译镜像、启动/停止/重启容器。
2. 实战案例:斗地主 + 摩托两个服务
version: '3.8'
services:
doudizhu:
image: demo-games:doudizhu-v0.1
build:
context: ./dockerfile
dockerfile: doudizhu.dockerfile
motuo:
image: demo-games:motuo-v0.1
build:
context: ./dockerfile
dockerfile: motuo.dockerfile
字段说明:
| 字段 | 含义 |
|---|---|
version | Compose 文件版本 |
services | 定义的服务集合 |
image | 服务使用的镜像名 |
build.context | 构建上下文,相当于 docker build 的 PATH |
build.dockerfile | Dockerfile 文件名,相当于 -f |
3. 常用命令
| 命令 | 作用 |
|---|---|
docker-compose build | 编译配置中声明的镜像 |
docker-compose up -d | 后台创建并启动容器 |
docker-compose ps | 查看服务状态 |
docker-compose stop -t 0 | 停止服务,-t 0 不等待 |
docker-compose start | 启动已存在的服务 |
docker-compose restart <服务名> | 重启指定服务 |
docker-compose down -t 0 | 停止并删除容器和网络 |
docker-compose build
docker-compose up -d
docker-compose ps
docker-compose stop -t 0
docker-compose start
docker-compose restart doudizhu
docker-compose down -t 0
restart后面跟的是docker-compose.yaml里定义的服务名(如doudizhu),不是容器名。
九、docker-compose 端口映射和重启策略
services:
doudizhu:
image: demo-games:doudizhu-v0.1
ports:
- 2481:80
- 2422:22
restart: always
build:
context: ./dockerfile
dockerfile: doudizhu.dockerfile
motuo:
image: demo-games:motuo-v0.1
ports:
- :80
- :22
build:
context: ./dockerfile
dockerfile: motuo.dockerfile
说明:
2481:80表示宿主机 2481 映射容器 80;:80表示宿主机随机端口映射容器 80;restart: always配置容器重启策略。
十、docker-compose 一键启动 Zabbix
version: '3.8'
services:
mysql-server:
image: mysql:8.3.0-oracle
container_name: mysql-server
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: demo
MYSQL_DATABASE: zabbix
MYSQL_USER: demo-class
MYSQL_PASSWORD: "123456"
networks:
- zabbix-net
command: ["--character-set-server=utf8", "--collation-server=utf8_bin", "--default-authentication-plugin=mysql_native_password"]
zabbix-java-gateway:
container_name: zabbix-java-gateway
image: zabbix/zabbix-java-gateway:alpine-6.4-latest
restart: unless-stopped
networks:
- zabbix-net
zabbix-server:
container_name: zabbix-server-mysql
depends_on:
- mysql-server
image: zabbix/zabbix-server-mysql:alpine-6.4-latest
restart: unless-stopped
environment:
DB_SERVER_HOST: mysql-server
MYSQL_DATABASE: zabbix
MYSQL_USER: demo-class
MYSQL_PASSWORD: "123456"
MYSQL_ROOT_PASSWORD: demo
ZBX_JAVAGATEWAY: zabbix-java-gateway
networks:
- zabbix-net
ports:
- "10051:10051"
zabbix-web-nginx-mysql:
container_name: zabbix-web-nginx-mysql
depends_on:
- zabbix-server
image: zabbix/zabbix-web-nginx-mysql:alpine-6.4-latest
ports:
- "80:8080"
restart: unless-stopped
environment:
DB_SERVER_HOST: mysql-server
MYSQL_DATABASE: zabbix
MYSQL_USER: demo-class
MYSQL_PASSWORD: "123456"
MYSQL_ROOT_PASSWORD: demo
networks:
- zabbix-net
networks:
zabbix-net:
name: demo-zabbix
ipam:
driver: default
config:
- subnet: 172.20.100.0/16
gateway: 172.20.100.254
关键点:
depends_on声明启动顺序依赖;- 各服务通过自定义网络
zabbix-net互联,可直接用服务名(如mysql-server)作为主机名; ipam配置网络子网和网关。
十一、私有镜像仓库
1. 为什么要用私有仓库
- 拉取镜像速度快;
- 便于内部用户统一获取镜像;
- 安全,部分镜像只允许内部使用。
2. 私有仓库方案对比
| 方案 | 说明 | 建议 |
|---|---|---|
| Docker Hub(官方) | 国内访问受限 | 一般不建议直接使用 |
| docker registry | Docker 官方开源,启动约 20MB,轻量但管理不便 | 不推荐 |
| VMware Harbor | 基于 registry 二次开发,带 WebUI、权限、项目等 | 企业使用推荐 |
| 第三方云仓库 | 阿里云、华为云等 | 按需选择 |
十二、docker registry 搭建与使用
1. 部署
docker run -dp 5000:5000 \
--restart=always \
--name demo-registry \
-v /var/lib/registry \
registry
访问 WebUI 查看仓库目录:
http://10.0.0.101:5000/v2/_catalog
2. 客户端配置不安全的存储库
registry 默认走 HTTP,Docker 默认走 HTTPS,需要在客户端配置信任:
{
"insecure-registries": ["10.0.0.101:5000"]
}
systemctl restart docker
docker info | grep "Insecure Registries" -A 2
常见报错
http: server gave HTTP response to HTTPS client,就是没配insecure-registries。
3. 打包并推送镜像
镜像名格式:私有仓库地址/项目地址/镜像名称:版本号。
docker tag mysql:8.3.0-oracle 10.0.0.101:5000/demo-db/mysql:8.3.0-oracle
docker push 10.0.0.101:5000/demo-db/mysql:8.3.0-oracle
再次访问 http://10.0.0.101:5000/v2/_catalog,能看到:
{"repositories":["demo-db/mysql"]}
4. 下载镜像
docker pull 10.0.0.101:5000/demo-db/mysql:8.3.0-oracle
registry 本身不带友好的 Web 管理界面,删除、浏览镜像都比较麻烦,这也是企业更倾向 Harbor 的原因。
5. 删除镜像
先删除元数据,再执行垃圾回收释放存储:
docker exec -it demo-registry sh
cd /var/lib/registry/docker/registry/v2/
rm -rf repositories/demo-db/
registry garbage-collect /etc/docker/registry/config.yml
十三、部署 Harbor(HTTP)
1. 下载并解压
wget http://<下载服务器>/softwares/harbor-offline-installer-v2.7.4.tgz
tar xf harbor-offline-installer-v2.7.4.tgz -C /demo/softwares/
mkdir -pv /demo/data/harbor
2. 配置 harbor.yml
cd /demo/softwares/harbor/
cp harbor.yml{.tmpl,}
vim harbor.yml
关键配置:
# Harbor 服务器地址
hostname: harbor.example.com
# 注释掉 https 配置(走 http)
#https:
# port: 443
# admin 用户密码
harbor_admin_password: 1
# 数据存储目录
data_volume: /demo/data/harbor
3. 安装
./install.sh --with-chartmuseum
安装过程会:检查 docker / docker-compose 环境 → 导入 Harbor 镜像 → 准备配置 → 启动 docker-compose。
4. 访问 WebUI
http://10.0.0.102/harbor/projects
用户名 admin,密码为 harbor.yml 中配置的密码。
十四、Harbor 推送镜像
1. 配置 hosts 解析
echo 10.0.0.102 harbor.example.com >> /etc/hosts
不配 hosts 会报
dial tcp: lookup harbor.example.com ... no such host。
2. 配置 HTTP 信任
{
"insecure-registries": ["harbor.example.com"]
}
systemctl restart docker
3. 在 WebUI 新建项目
略(新建一个项目,例如 demo)。
4. 打包并登录
docker tag demo-games:motuo-v0.1 harbor.example.com/demo/demo-games:motuo-v0.1
docker login harbor.example.com
# Username: admin
# Password: 1
也可用:
echo 1 | docker login -u admin --password-stdin harbor.example.com
不登录直接 push 会报
unauthorized。登录后密码会以明文形式存到/root/.docker/config.json,用完记得docker logout。
5. 推送
docker push harbor.example.com/demo/demo-games:motuo-v0.1
6. 退出登录
docker logout harbor.example.com
十五、Harbor 下载镜像
在另一台节点上:
echo "10.0.0.102 harbor.example.com" >> /etc/hosts
# daemon.json 中加入 insecure-registries
systemctl restart docker
docker pull harbor.example.com/demo/demo-games:motuo-v0.1
Harbor 镜像删除通过 WebUI 操作(略)。
十六、总结
USER让容器以普通用户运行,使用前要确保用户存在,并准备好所需目录和日志的属主;ONBUILD定义的指令只在子镜像构建时触发,配合-f可以实现一次构建多个镜像;- 多阶段构建把编译和运行分离,最终镜像只保留产物,能把体积从几百 MB 降到几 MB;
- 容器日志应输出到 stdout / stderr,
docker logs才能查看; - docker-compose 用一份 YAML 统一管理多服务:
build/up -d/ps/stop/start/restart/down; - 私有仓库选择:轻量场景用 registry,企业生产推荐 Harbor;
- 使用 HTTP 私有仓库要配置
insecure-registries,使用域名要配置 hosts 解析,推送前要docker login,用完要docker logout。