Dockerfile.fnpack 解析
三个平台各一份:.cnb/docker/Dockerfile.fnpack、.github/docker/Dockerfile.fnpack 与 .gitlab/docker/Dockerfile.fnpack,内容一致、各自维护。整个文件只做两件事——下载 fnpack、打 OCI 标签,其余全部继承基座;基座镜像的 Dockerfile(工具链、镜像源、层拆分)见 ../golang/dockerfile.md。
基座
ARG GOLANG_IMAGE=golang:1-trixie
FROM ${GOLANG_IMAGE}
ARG GOLANG_IMAGE
- CI 里
GOLANG_IMAGE由构建脚本传成上一步刚推好的<golang 镜像>:<go 版本>,所以 fnpack 产物 = 基座 + 一层。 - 默认值
golang:1-trixie只用于脱离本仓库的裸构建;此时镜像里没有本仓库预装的 UPX / nfpm / Node / Go 工具链,只够验证 fnpack 下载本身。 FROM之后重新声明ARG GOLANG_IMAGE,是为了让下面的org.opencontainers.image.base.name标签能引用它的实际值。- 其余 build-arg(
FNPACK_VERSION/IMAGE_VERSION/VCS_REF/BUILD_DATE/BASE_DIGEST/IMAGE_SOURCE)与基座镜像同名同义,由构建脚本传入。
fnpack 安装层
RUN set -eux; \
ARCH="$(uname -m)"; \
case "$ARCH" in \
x86_64) FNPACK_ARCH="amd64" ;; \
aarch64) FNPACK_ARCH="arm" ;; \
*) echo "不支持的架构: $ARCH" >&2; exit 1 ;; \
esac; \
FNPACK_URL="https://static2.fnnas.com/fnpack/fnpack-${FNPACK_VERSION}-linux-${FNPACK_ARCH}"; \
curl -fsSL -o /usr/local/bin/fnpack "${FNPACK_URL}"; \
chmod +x /usr/local/bin/fnpack; \
test -x /usr/local/bin/fnpack; \
fnpack --help >/dev/null 2>&1 || true
逐点看:
- 下载地址:
https://static2.fnnas.com/fnpack/fnpack-<版本>-linux-<arch>,直连官方站,不走 GitHub Release,所以三个平台都没有镜像前缀开关(对比基座镜像的GITHUB_MIRROR/NODE_MIRROR)。 - 架构映射是这里唯一的坑:fnpack 上游的 ARM 产物文件名是
arm,不是arm64;而uname -m在 arm64 上返回aarch64,必须映射成arm才能拼出正确的 URL。amd64 是平凡的x86_64→amd64。映射错了会 404,构建直接失败。 - 安装即校验:
chmod +x→test -x→ 跑一次fnpack --help。部分版本的--help返回非 0,所以加了|| true——这一步只验证「二进制能执行」,不校验退出码;更完整的断言在构建脚本的冒烟测试里(检查fnpack存在且可执行、Go 版本一致、基座工具链齐全)。 - 缓存友好:这一层只依赖
GOLANG_IMAGE与FNPACK_VERSION两个 build-arg。基座 digest 没变、fnpack 版本没升时,层缓存全命中,构建接近瞬时;机制见 ../cache-implementation.md。
版本:默认值 + 手动覆盖
FNPACK_VERSION 与基座镜像里其它工具 ARG 的行为不同:
| 对比项 | 基座工具(UPX、nfpm、Go 工具…) | fnpack |
|---|---|---|
| 默认值 | latest,CI 解析成具体版本再传回 |
写死的语义版本(当前 1.2.3) |
| 自动追新 | 是(每日构建重新解析) | 否,上游没有可查询 latest 的接口 |
| 手动覆盖 | 手动触发时传 version |
手动触发时传 fnpack_version |
| 原因 | 上游有可查询的版本渠道 | 下载地址不支持 latest 语义 |
脚本先用 read_arg 从 Dockerfile.fnpack 读出 FNPACK_VERSION 作为默认值:定时任务、以及手动触发时留空的 fnpack_version,都用这个值(当前 1.2.3,暂作为最新版本)。手动填了 fnpack_version(如 1.2.3)就直接覆盖,原样传给 --build-arg,不经转换。升级默认版本仍要改三份 Dockerfile,流程见 ../golang/maintenance.md 的「升级 fnpack」:先 curl -sI 确认对应产物存在。
OCI 标签
LABEL org.opencontainers.image.source="${IMAGE_SOURCE}" \
...
org.opencontainers.image.base.name="${GOLANG_IMAGE}" \
org.opencontainers.image.base.digest="${BASE_DIGEST}"
- 标签放在文件最后,与基座镜像同样的理由:
BUILD_DATE/VCS_REF/IMAGE_VERSION每次构建都变,放前面会让 fnpack 下载层的缓存键跟着每次提交一起变。 base.name记录本次实际使用的基座引用,base.digest记录其 index digest——脚本用imagetools inspect读出后传入,与元数据的fnpack_base_image/fnpack_base_digest同源,可互相核对。org.opencontainers.image.version等于解析出的 Go 版本(与基座一致),冒烟测试会校验这个标签。CMD ["bash"],与基座一致。