Dockerfile 常用写法速查

常用命令

docker build -t app:1.0.0 .
docker build --target runtime -t app:runtime .
docker build --build-arg VERSION=1.0.0 -t app:1.0.0 .
docker buildx build --platform linux/amd64,linux/arm64 -t app:1.0.0 --push .
docker history app:1.0.0
docker run --rm -it app:1.0.0 sh

多阶段构建：

FROM golang:1.23 AS build
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o /out/app .

FROM gcr.io/distroless/static-debian12
COPY --from=build /out/app /app
USER 65532:65532
ENTRYPOINT ["/app"]

场景速查

易错点

• COPY . . 放在依赖安装之前，任何源码变更都会使缓存失效。
• 没有 .dockerignore，把 .git、node_modules、密钥打进镜像。
• 使用 latest 基础镜像，构建不可复现。
• 容器以 root 运行，被 Pod Security 拒绝。
• ARG 中的密钥会留在镜像历史里，不要在构建参数中传密钥。
• RUN apt-get update 和 install 分开写，缓存导致安装旧包。
• 多阶段构建忘记 COPY --from，运行阶段缺文件。
• 时区/证书/CA 没有安装，运行时报错。

相关命令

• docker — Docker 命令
• buildah — 无守护进程构建
• kaniko — Kubernetes 内构建
• trivy — 镜像扫描
• helm-cheatsheet — Helm 速查