- 一、Dockerfile 核心语法规则
- 二、常用指令详解
- 三、典型使用场景示例
- 设置工作目录
- 复制 package.json 并安装依赖
- 复制应用代码
- 暴露应用端口
- 定义启动命令
- 设置环境变量
- 创建工作目录
- 安装系统依赖
- 复制依赖文件并安装
- 复制应用代码
- 启动命令
- 最终阶段
记录一下Dockerfile的语法和命令
一、Dockerfile 核心语法规则
- 指令大写：所有指令必须大写（如
FROM,RUN） - 顺序执行：指令按顺序从上到下执行
- 分层构建：每条指令生成一个镜像层，修改上层不会影响下层
- 注释支持：使用
#符号添加注释 - 基础镜像：必须包含
FROM指令作为第一条指令
二、常用指令详解
| 指令 | 作用 | 示例 |
|---|---|---|
| FROM | 指定基础镜像 | FROM ubuntu:20.04 |
| RUN | 执行命令并提交结果 | RUN apt-get update && apt-get install -y curl |
| COPY | 复制本地文件到镜像 | COPY ./app /app |
| ADD | 复制文件并支持自动解压（推荐优先使用 COPY） | ADD https://example.com/file.tar.gz /tmp |
| CMD | 定义容器启动默认命令（可被覆盖） | CMD ["python", "app.py"] |
| ENTRYPOINT | 定义容器启动主命令（不可被覆盖，可组合使用） | ENTRYPOINT ["python"] |
| WORKDIR | 设置工作目录 | WORKDIR /app |
| EXPOSE | 声明容器监听端口 | EXPOSE 80 |
| ENV | 设置环境变量 | ENV NODE_ENV=production |
| VOLUME | 创建挂载点 | VOLUME /data |
| ARG | 定义构建参数（仅在构建时有效） | ARG USER_ID=1000 |
| USER | 指定运行用户 | USER root |
| LABEL | 添加元数据 | LABEL maintainer="your@email.com" |
| ONBUILD | 定义镜像作为其他镜像基础时执行的指令（较少使用） | ONBUILD RUN echo "Building child image" |
三、典型使用场景示例
示例1：构建 Node.js 应用镜像s
# 使用官方 Node.js 镜像作为基础 FROM node:18-alpine
设置工作目录
WORKDIR /app
复制 package.json 并安装依赖
COPY package*.json ./ RUN npm install --production
复制应用代码
COPY . .
暴露应用端口
EXPOSE 3000
定义启动命令
CMD [“npm”, “start”]
构建命令：
docker build -t my-node-app .
运行命令：
docker run -p 3000:3000 my-node-app
示例2：Python Web 服务镜像
# 使用 Python 官方镜像 FROM python:3.11-slim
设置环境变量
ENV PYTHONUNBUFFERED=1
创建工作目录
WORKDIR /code
安装系统依赖
RUN apt-get update && apt-get install -y –no-install-recommends
gcc
python3-dev
&& rm -rf /var/lib/apt/lists/*
复制依赖文件并安装
COPY requirements.txt . RUN pip install –no-cache-dir -r requirements.txt
复制应用代码
COPY . .
启动命令
CMD [“gunicorn”, “–bind”, “0.0.0.0:8000”, “myapp.wsgi”]
2.构建优化技巧：
- 使用
.dockerignore文件排除无关文件 - 合并 RUN 指令减少层数：
RUN apt-get update
&& apt-get install -y package
&& rm -rf /var/lib/apt/lists/*
3.多阶段构建（减小最终镜像体积）：
# 构建阶段 FROM golang:1.21 as builder WORKDIR /app COPY . . RUN go build -o myapp
最终阶段
FROM alpine:latest COPY --from=builder /app/myapp /app/ CMD [“/app/myapp”]
四、关键注意事项
- 层缓存机制：Dockerfile 修改后，只有修改后的指令及其后续指令会重新执行
- 安全最佳实践：
- 避免以 root 用户运行最终容器
- 使用最小基础镜像（如 alpine）
- 定期更新基础镜像
- 多阶段构建：适用于需要编译环境但运行时不需要的情况（如 Go/C++ 应用）
-
健康检查：
HEALTHCHECK –interval=30s –timeout=3s
CMD curl -f http://localhost/ || exit 1
五、调试技巧
-
进入容器调试：
docker run -it my-image /bin/bash
-
查看构建历史：
docker history my-image
-
查看镜像详细信息：
docker inspect my-image