CI/CD / 系统课时
编写应用 Dockerfile
编写应用 Dockerfile
这一课把一个已有的 Node.js 示例应用封装成可重复构建的容器镜像,重点明确工作目录、依赖安装、文件复制、启动命令和非 root 运行用户,最终得到一份适合进入 CI 流水线的 Dockerfile。
学习目标
- 能写出职责清晰、可重复构建的基础 Dockerfile。
- 能区分构建阶段的 root 权限与运行阶段的普通用户权限。
- 能用镜像检查命令验证工作目录、运行用户和启动命令。
先确定镜像运行约束
Dockerfile 不是把本机环境“搬进镜像”,而是显式声明应用运行所需的最小环境。下面以使用 npm start 启动、监听 3000 端口的 Node.js 服务为例;如果你的项目使用其他运行时,只需替换基础镜像、依赖安装和启动命令。
运行镜像前至少要确认四件事:应用代码放在哪里、依赖如何安装、容器启动后执行什么命令,以及进程以什么用户身份运行。CI/CD 中常见的启动失败,往往来自这些约束没有被固定下来。
编写可维护的 Dockerfile
下面先复制依赖清单并安装生产依赖,再复制业务代码;应用最终使用基础镜像自带的 node 用户运行,避免让服务进程长期拥有 root 权限。
FROM node:22-alpine
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --omit=dev && npm cache clean --force
COPY --chown=node:node . .
USER node
EXPOSE 3000
CMD ["npm", "start"]WORKDIR 统一后续 COPY、RUN 和启动命令的相对路径。npm ci 按锁文件安装依赖,适合自动化构建;CMD 使用 JSON 数组形式,避免额外经过 shell 解析。EXPOSE 只是镜像元数据,不会自动把端口发布到宿主机。
为了避免本机依赖、仓库元数据和环境文件被复制进镜像,项目根目录至少应有一份 .dockerignore:
node_modules
.git
.env
npm-debug.log如果应用运行时需要写文件,不要因此改回 root 用户,而应为日志、缓存或上传目录单独准备可写路径并设置所有权。
构建并检查镜像
在包含 Dockerfile、.dockerignore、package.json 和 package-lock.json 的项目根目录执行:
docker build --quiet -t demo-app:local . && docker image inspect demo-app:local --format 'user={{.Config.User}} workdir={{.Config.WorkingDir}} cmd={{json .Config.Cmd}}'预期输出
sha256:<ID>
user=node workdir=/app cmd=["npm","start"]第一行镜像 ID 会随构建变化,实际值与 <ID> 不同。第二行说明镜像已经按预期固定普通运行用户、工作目录和启动命令。若构建失败,优先检查锁文件是否存在、依赖安装是否需要私有仓库凭据,以及被 .dockerignore 排除的文件是否其实是构建必需项。