docker-alpine 极简镜像实战指南:5 MB 基础镜像的构建原理与 apk 包管理用法
docker-alpine 极简镜像实战指南:5 MB 基础镜像的构建原理与 apk 包管理用法
docker-alpine 是 Glider Labs 维护的一个基于 Alpine Linux 的超级精简 Docker 基础镜像项目,镜像体积仅约 5 MB,却拥有远比 BusyBox 系镜像完整的软件包仓库。本文以仓库根目录的 README.md 为主线,结合 docs 文档、builder 构建脚本与 test 测试用例,完整讲解该镜像的体积优势、apk 包管理实操、已知注意事项以及底层构建流程,读完即可上手用它替换臃肿的传统基础镜像。
镜像定位:极简主义的基础镜像
项目在 README.md 中这样定位自己:这是一个基于 Alpine Linux] 的超级小型 Docker 镜像,镜像本身只有 5 MB,并且可以访问一个远比其他 BusyBox 系镜像更完整的软件包仓库。仓库根目录的 [README-short.txt 也以一句话概括了核心卖点:
A minimal Docker image based on Alpine Linux with a complete package index and only 5 MB in size!
这句话包含两个关键承诺:体积极小(约 5 MB)与 包索引完整(apk 可以安装大量日常软件包)。这两点分别解决了 Docker 镜像"过大"与"最小化但装不了东西"两个痛点。
为什么选择 Alpine:与主流基础镜像的体量对比
当前 Docker 生态中大量项目仍习惯以 ubuntu 作为基础镜像,但镜像体积往往远超实际需求。README 中给出了一组当时的直接对比数据(数据来源于 README.md,对应 Alpine 3.x 时代):
REPOSITORY TAG IMAGE ID VIRTUAL SIZE
gliderlabs/alpine latest 9cfff538e583 4.803 MB
debian latest 19134a8202e7 123.1 MB
ubuntu latest 104bec311bcd 129 MB
centos latest 67591570dd29 191.8 MB
可见 gliderlabs/alpine 的体积约为 ubuntu 的 1/27、centos 的 1/40。镜像更小意味着 push、pull、启动与分发都更快,在 CI 流水线和多节点集群场景下收益尤其明显。
包管理对比:BusyBox/OpenWRT 索引 vs Alpine 的 apk
体积小是一方面,能否方便地安装软件是另一方面。README 指出,像 progrium/busybox 这类镜像虽然也能做到接近极简,但其依赖 OpenWRT 的软件包索引,索引往往不完整、更新不及时,也不适合日常通用应用。而 Alpine Linux 拥有更完整、更新更及时的软件包索引。README 给出了同一操作在两类镜像上的直接对比(README.md):
$ docker run progrium/busybox opkg-install nodejs
Unknown package 'nodejs'.
Collected errors:
* opkg_install_cmd: Cannot install package nodejs.
$ docker run gliderlabs/alpine apk add --no-cache nodejs
fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz
fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz
(1/4) Installing libgcc (5.3.0-r0)
(2/4) Installing libstdc++ (5.3.0-r0)
(3/4) Installing libuv (1.7.5-r0)
(4/4) Installing nodejs (4.2.3-r0)
Executing busybox-1.24.1-r7.trigger
OK: 29 MiB in 15 packages
同样的需求,opkg-install 直接报 "Unknown package",而 apk add 能自动解析依赖(libgcc、libstdc++、libuv)并成功安装 nodejs。这正是"最小体积 + 完整包索引"的组合价值,也让 Alpine 成为工具类容器乃至生产应用的理想基础镜像。
技术基石:musl libc 与 BusyBox 的组合
镜像为什么能做到这么小?答案在 docs/about.md 中:Alpine Linux 是一个基于 musl libc 和 BusyBox 的轻量级 Linux 发行版。
- musl libc:从嵌入式小系统到完整服务器都能保持一致的实现质量;机器相关代码极少,在少数架构上出问题的概率更低;从设计上就为静态链接优化,不会拖入应用用不到的代码和数据。用 musl 静态链接出的二进制没有任何外部依赖,甚至 DNS 查询、字符集转换这类在 glibc 上需要动态加载实现的功能也被包含在内,应用可以真正以"单个二进制文件"部署到任意指令集架构匹配的 Linux 机器上。
- BusyBox:把大量常见 UNIX 工具压缩进一个很小的可执行文件,作为 GNU fileutils、shellutils 等工具集的替代品。其选项通常比完整版 GNU 工具少,但包含的选项行为与 GNU 对应工具高度一致;它以体积优化和资源受限为前提编写,且高度模块化,可在编译时按需裁减命令。
正如 docs/about.md 所总结的,将 musl libc 与 BusyBox 配对,让基础镜像只有约 5 MB,直接缩短了 push 与 pull 的时间——"天作之合"(Match made in heaven)。
上手用法:用 Dockerfile 替换传统基础镜像
README 的 Usage 一节给出了最直观的迁移示范(README.md)。先看传统写法:
FROM ubuntu-debootstrap:14.04
RUN apt-get update -q \
&& DEBIAN_FRONTEND=noninteractive apt-get install -qy mysql-client \
&& apt-get clean \
&& rm -rf /var/lib/apt
ENTRYPOINT ["mysql"]
这段 Dockerfile 需要约 19 秒构建,产出 164 MB 的镜像。而换用 Alpine 之后:
FROM gliderlabs/alpine:3.4
RUN apk add --no-cache mysql-client
ENTRYPOINT ["mysql"]
只需约 3 秒构建,最终镜像仅 36 MB(以上构建时间与体积数据来源于 README.md)。差异来自两个方面:基础镜像本身小,且 apk add --no-cache 免去了 apt-get update 与后续缓存清理步骤。
apk 包管理详解:update-cache、no-cache 与虚拟包
镜像内部使用 apk 管理软件包,其用法与 apt、yum 类似。详细说明见 docs/usage.md。
为什么默认没有包索引
镜像内不预置软件包索引——因为索引很容易过期。因此安装软件时需要通过标志位显式拉取最新索引:
apk add --update-cache nginx:先获取当前包索引再安装(docs/usage.md)。- 从 Alpine Linux 3.3 开始新增的
--no-cache:索引在安装时即时更新、即时使用,且不写入本地缓存,从根本上免去了--update-cache加rm -rf /var/cache/apk/*的清理组合(docs/usage.md)。
完整示例:Python 运行时 Dockerfile
docs/usage.md 给出了一个安装 Python 运行时及构建依赖的完整示例:
FROM gliderlabs/alpine:3.3
RUN apk add --update-cache \
python \
python-dev \
py-pip \
build-base \
&& pip install virtualenv \
&& rm -rf /var/cache/apk/*
WORKDIR /app
ONBUILD COPY . /app
ONBUILD RUN virtualenv /env && /env/bin/pip install -r /app/requirements.txt
EXPOSE 8080
CMD ["/env/bin/python", "main.py"]
注意这里使用了 --update-cache 并在安装完成后手动 rm -rf /var/cache/apk/* 清理索引缓存。改用 --no-cache 可以简化这一过程:
FROM gliderlabs/alpine:3.3
RUN apk --no-cache add nginx
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
便利脚本 apk-install(gliderlabs 变体专属)
gliderlabs/alpine 变体曾附带一个非官方的便利脚本 apk-install,其实现位于 builder/scripts/apk-install,内容非常简短:
#!/bin/sh
apk add --update-cache "$@" && rm -rf /var/cache/apk/*
即"安装 + 自动清理缓存"的一行封装。不过随着 Alpine 3.2 起 apk 原生支持 --no-cache,该脚本已属冗余,官方文档(docs/usage.md 与 docs/build.md)均说明它已被标记为 deprecated,并推荐优先使用 apk --no-cache,该脚本未来可能从镜像中移除。
虚拟包:一次删除一组构建依赖
apk add --virtual(简写 -t)允许把多个包归入一个虚拟包名下,之后可用 apk del <虚拟包名> 一次性整体卸载,非常适合"装一组编译依赖、用完即清"的场景(docs/usage.md):
FROM gliderlabs/alpine:3.3
WORKDIR /myapp
COPY . /myapp
RUN apk --update-cache add python py-pip openssl ca-certificates
RUN apk --update-cache add --virtual build-dependencies python-dev build-base wget \
&& pip install -r requirements.txt \
&& python setup.py install \
&& apk del build-dependencies
CMD ["myapp", "start"]
build-dependencies 下的 python-dev、build-base、wget 在编译完成后随 apk del build-dependencies 整体移除,而运行所需的 python、py-pip 等保留不动。
使用注意事项:musl 与 glibc 的差异
由于镜像基于 musl libc,部分行为与你熟悉的 glibc 环境不同。完整说明见 docs/caveats.md,这里总结最常见的两类问题。
DNS 解析差异
- musl libc 不读取
/etc/resolv.conf中的domain与search指令。例如 Docker daemon 以--dns-search=service.consul启动后,容器内解析consul不会自动尝试consul.service.consul,必须使用完整限定域名。 - musl 会并行查询多个 name server。如果第一个 DNS 服务器承担服务发现等不同解析视图,且 Docker daemon 配置了
--dns=172.17.42.1 --dns=10.0.2.15,则无法保证172.17.42.1总被优先查询,可能出现间歇性失败。
这两种场景的通用解法是引入本地缓存 DNS 服务器(如 dnsmasq),同时承担缓存与搜索路径路由,例如 dnsmasq --server /consul/10.0.0.1 将 .consul 域的查询转发给 10.0.0.1。
二进制兼容性
部分二进制依赖 glibc 特有符号,在 musl 环境会启动失败(如依赖 glibc 特定符号的 Oracle Java)。可用 ldd 定位具体符号(示例来自 docs/caveats.md):
# ldd bin/java
/lib64/ld-linux-x86-64.so.2 (0x7f542ebb5000)
libpthread.so.0 => /lib64/ld-linux-x86-64.so.2 (0x7f542ebb5000)
libjli.so => bin/../lib/amd64/jli/libjli.so (0x7f542e9a0000)
libdl.so.2 => /lib64/ld-linux-x86-64.so.2 (0x7f542ebb5000)
libc.so.6 => /lib64/ld-linux-x86-64.so.2 (0x7f542ebb5000)
Error relocating bin/../lib/amd64/jli/libjli.so: __rawmemchr: symbol not found
遇到这类情况,需要上游移除对问题符号的依赖,或在 musl 上原生编译;也可以先在 Alpine Linux 包索引中查找是否有现成的替代包。
镜像是如何构建出来的:builder 与 mkimage-alpine 脚本
镜像并非手工制作,而是由一个基于 Alpine 的 builder 镜像自动化产出 rootfs 归档。整个流程在 docs/build.md 有详细说明,源码位于 builder。
Builder 镜像
builder/Dockerfile 内容如下:
FROM alpine:latest
COPY scripts/mkimage-alpine.bash scripts/apk-install /
RUN apk add --no-cache bash tzdata xz
ENTRYPOINT ["/mkimage-alpine.bash"]
它把核心脚本 builder/scripts/mkimage-alpine.bash 与 apk-install 便利脚本拷入镜像,并安装 bash(脚本运行需要)、tzdata(时区配置需要)与 xz(压缩 rootfs 需要)。该脚本是 Docker 官方 contrib/mkimage-alpine.sh 的修改版,修改灵感来自 Eivind Uggedal 与 Luis Lavena 的 mini-containers 工作(脚本头注释与 README.md 均有说明)。
mkimage-alpine.bash 的构建选项
脚本(builder/scripts/mkimage-alpine.bash)通过 getopts 解析参数,完整选项列表(对应 builder/README.md)如下:
| 选项 | 作用 | 默认值 |
|---|---|---|
-r <release> |
发行版标签,如 edge、v3.1 |
edge |
-m <mirror> |
镜像源 URL 基址 | http://nl.alpinelinux.org/alpine |
-s |
将 rootfs.tar.xz 输出到 stdout |
无 |
-c |
向 rootfs 中加入 apk-install 脚本 |
无 |
-e |
在 repositories 文件中追加 edge/main、edge/testing 源 |
无 |
-d |
禁用 root 空密码(移除可 su 到 root 的空密码) | 无 |
-E |
不向 repositories 文件添加 community 源(无 community 仓库的版本必需) |
无 |
-t <timezone> |
设置时区 | 无 |
-p <packages> |
逗号分隔的包列表 | alpine-base |
-b |
无依赖地解包 alpine-base(供用 -p 精简后仍需要 /etc/*-release、/etc/issue 的场景) |
无 |
-a <architecture> |
下载 rootfs 的架构 | x86_64 |
脚本内部还会参考若干环境变量:OMIT_COMMUNITY(对应 -E)、REPO_EXTRA(对应 -e)、TIMEZONE(对应 -t)、ADD_APK_SCRIPT(对应 -c)、ADD_BASELAYOUT(对应 -b)、DISABLE_ROOT_PASSWD(对应 -d)、STDOUT(对应 -s)以及 TRACE(开启 set -x 调试)。
核心构建流程(builder/scripts/mkimage-alpine.bash)大致为:
- 在临时目录创建
etc/apk/repositories,写入${mirror}/${rel}/main(及可选的community、edge等源); - 用
apk --root <rootfs> --update-cache add --initdb初始化数据库并安装基础包; - 按需处理 baselayout、时区、root 密码禁用等定制项;
- 清理
/var/cache/apk/*,可选复制apk-install; - 以
tar -J打包出rootfs.tar.xz,-s时直接输出到 stdout。
versions 目录与多架构配置
每个版本的构建参数以 options 文件 形式保存在 versions 目录。以 versions/gliderlabs-3.4/options 为例:
export RELEASE="v3.4"
export MIRROR="http://alpine.gliderlabs.com/alpine"
export PACKAGES="alpine-baselayout,alpine-keys,apk-tools,libc-utils"
export BUILD_OPTIONS=(-b -s -c -t UTC -r $RELEASE -m $MIRROR -p $PACKAGES)
export TAGS=(gliderlabs/alpine:3.4)
export PUSH_IMAGE="true"
而官方 Docker Library 镜像(alpine)的配置则不同,例如 versions/library-3.1/options:
export RELEASE="v3.1"
export MIRROR="http://dl-cdn.alpinelinux.org/alpine"
export BUILD_OPTIONS=(-d -s -E -t UTC -r $RELEASE -m $MIRROR)
export TAGS=(alpine:3.1)
官方镜像配置不含 -c(不加入 apk-install 脚本),且早期版本使用 -E(3.1 尚无 community 仓库)、默认包列表(alpine-base)。
多架构支持体现在 library-3.6 之后的目录结构上:每个架构(aarch64、armhf、ppc64le、s390x、x86、x86_64)各有独立的 Dockerfile 与 options。这类配置不再走 builder 脚本,而是直接用 PULL_URL 下载官方发布的 alpine-minirootfs 归档,例如 http://dl-cdn.alpinelinux.org/alpine/v3.6/releases/aarch64/alpine-minirootfs-3.6.3-aarch64.tar.gz。架构差异还可以从 build 脚本中的架构名映射函数看到:Alpine 的 x86_64、x86、armhf、aarch64、ppc64le、s390x 分别对应 Docker 生态的 amd64、i386、arm32v6、arm64v8、ppc64le、s390x。
无论哪种方式,最终产物 Dockerfile 都非常简洁,例如 versions/gliderlabs-3.4/Dockerfile:
FROM scratch
ADD rootfs.tar.xz /
CMD ["/bin/sh"]
FROM scratch 配合 ADD 将 rootfs 自动解包,这是镜像体积能压到 5 MB 的关键——最终镜像只包含 Alpine rootfs 本身。
构建与测试:build 脚本与 bats 用例
仓库根目录的 build 脚本封装了镜像的构建、测试、提交与推送流程,包含 build、test、commit、push、library 五个子命令(build)。常用方式:
$ ./build # 构建 versions/**/options 对应的全部镜像
$ ./build versions/library-3.2/options versions/gliderlabs-3.2/options # 只构建指定版本
$ ./build test # 运行全部测试
$ ./build test versions/gliderlabs-3.2/options # 测试单个镜像
$ parallel -m ./build ::: versions/**/options # 有 parallel 时并行构建
测试基于 bats 框架,每个镜像 tag 对应 test 目录下一个 test_*.bats 文件。以 test/test_gliderlabs_alpine-3.6.bats 为例,覆盖的断言包括:
- 版本正确:
cat /etc/os-release输出VERSION_ID=3.6.5; - 包可正常安装:
apk add --update-cache openssl退出码为 0; - 时区为 UTC:
date +%Z输出UTC; apk-install脚本存在(gliderlabs 变体)或缺失(官方镜像,见 test/test_alpine-3.6.bats);- repositories 列表指向正确的 main/community 源;
- 缓存为空:
ls -1 /var/cache/apk | wc -l为 0; - root 密码已禁用:以
--user nobody运行su应失败(退出码 1); - 镜像内不含
/dev/null设备节点。
官方镜像与 gliderlabs 镜像的差异
根据 docs/build.md,gliderlabs/alpine 与 Docker Library 官方 alpine 镜像唯一的差异是:gliderlabs 变体多了一个 apk-install 便利脚本。由于该功能已被 apk --no-cache 原生取代,官方文档明确推荐优先使用官方 alpine 镜像,除非你已经在使用 gliderlabs/alpine。这也解释了为什么两个变体在 test 目录下各有独立的测试文件,且对 apk-install 的断言恰好相反。
小结
从 README.md 的核心主张出发,docker-alpine 项目用约 5 MB 的镜像体量,换来了远胜 BusyBox 系的完整包索引、以 musl libc + BusyBox 为基石的极简设计,以及一套完整可复现的自动化构建体系(builder 脚本 + versions 配置 + build 流水线 + test bats 用例)。对于想要缩小镜像体积、加快构建与分发速度的团队,将它作为基础镜像、配合 apk --no-cache 与虚拟包机制,即可获得既小又实用的容器基础环境。更深入的背景可继续阅读仓库内的 docs/about.md、docs/usage.md、docs/caveats.md 与 docs/build.md。