CI/CD / 系统课时

编写应用 Dockerfile

编写应用 Dockerfile

这一课把一个已有的 Node.js 示例应用封装成可重复构建的容器镜像,重点明确工作目录、依赖安装、文件复制、启动命令和非 root 运行用户,最终得到一份适合进入 CI 流水线的 Dockerfile。

学习目标

  • 能写出职责清晰、可重复构建的基础 Dockerfile。
  • 能区分构建阶段的 root 权限与运行阶段的普通用户权限。
  • 能用镜像检查命令验证工作目录、运行用户和启动命令。

先确定镜像运行约束

Dockerfile 不是把本机环境“搬进镜像”,而是显式声明应用运行所需的最小环境。下面以使用 npm start 启动、监听 3000 端口的 Node.js 服务为例;如果你的项目使用其他运行时,只需替换基础镜像、依赖安装和启动命令。

运行镜像前至少要确认四件事:应用代码放在哪里、依赖如何安装、容器启动后执行什么命令,以及进程以什么用户身份运行。CI/CD 中常见的启动失败,往往来自这些约束没有被固定下来。

编写可维护的 Dockerfile

下面先复制依赖清单并安装生产依赖,再复制业务代码;应用最终使用基础镜像自带的 node 用户运行,避免让服务进程长期拥有 root 权限。

dockerfile
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:

text
node_modules
.git
.env
npm-debug.log

如果应用运行时需要写文件,不要因此改回 root 用户,而应为日志、缓存或上传目录单独准备可写路径并设置所有权。

构建并检查镜像

在包含 Dockerfile、.dockerignore、package.json 和 package-lock.json 的项目根目录执行:

bash
docker build --quiet -t demo-app:local . && docker image inspect demo-app:local --format 'user={{.Config.User}} workdir={{.Config.WorkingDir}} cmd={{json .Config.Cmd}}'

预期输出

text
sha256:<ID>
user=node workdir=/app cmd=["npm","start"]

第一行镜像 ID 会随构建变化,实际值与 <ID> 不同。第二行说明镜像已经按预期固定普通运行用户、工作目录和启动命令。若构建失败,优先检查锁文件是否存在、依赖安装是否需要私有仓库凭据,以及被 .dockerignore 排除的文件是否其实是构建必需项。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写应用 Dockerfile

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通