Mao-Design的博客

外观

Dockerfile

1465字约5分钟

2026-01-22

Dockerfile

# 基于centos
FROM centos
# 设置环境目录
ENV MYPATH /usr/local
# 设置工作目录，就是进入终端之后默认进入的目录
WORKDIR $MYPATH
# 下载软件
RUN yum -y install vim
# 映射端口
EXPOSE 8080:80
[root@hadoop01 dockerDemo]# docker build -f Dockerfile文件名 -t 自定义镜像名:自定义版本号 .

[root@hadoop01 dockerDemo]# docker build -f Dockerfile -t nginx66:0.1 .

1. FROM

作用：指定基础镜像，是 Dockerfile 的必需首行指令。 语法：

FROM <image>[:<tag>] [AS <name>]
FROM python:3.9-slim-buster  # 使用Python官方轻量级镜像
  • 最佳实践
    • 使用官方镜像或经过验证的第三方镜像。
    • 始终指定标签（如python:3.9），避免使用latest导致版本不稳定。
    • 使用AS为阶段命名，支持多阶段构建（如AS builder）。

2. LABEL

作者信息，名字+邮箱

语法：

LABEL maintainer="John Doe <john@example.com>"

  • 扩展标签

    可添加更多镜像信息。

    LABEL version="1.0" description="My application"

3. RUN

作用：在构建镜像时执行命令，常用于安装软件或配置环境。 两种形式：

  • shell 形式

    直接执行命令（默认使用/bin/sh -c）

    RUN apt-get update && apt-get install -y python3-pip

  • exec 形式

    以数组形式执行命令，避免 shell 解析。

    RUN ["pip", "install", "flask"]

  • 最佳实践

    • 合并多条命令以减少镜像层数（如&&连接）。

    • 清理临时文件以减小镜像体积：

      RUN apt-get update && apt-get install -y python3-pip \
    && rm -rf /var/lib/apt/lists/*  # 清除APT缓存

4. ADD

作用：复制文件或目录到镜像中，支持 URL 和自动解压。 语法：

ADD <src>... <dest>
ADD app.tar.gz /app/  # 自动解压tar文件
ADD https://example.com/file.txt /tmp/  # 下载远程文件
  • 最佳实践
    • 优先使用COPY，因为ADD的解压和远程下载功能可能导致意外行为。
    • 避免从 URL 下载大文件，改用RUN wget或curl以便清理临时文件。

5. COPY

作用：复制文件或目录到镜像中，更透明且推荐使用。 语法：

COPY [--chown=<user>:<group>] <src>... <dest>
COPY requirements.txt /app/  # 复制本地文件
COPY --chown=appuser:appuser src/ /app/  # 指定文件所有者

  • 最佳实践

    • 使用.dockerignore文件排除不需要的文件（如.git、node_modules）。

    • 遵循 “依赖优先复制” 原则，减少缓存失效：

      COPY requirements.txt /app/  # 先复制依赖文件
RUN pip install -r requirements.txt  # 缓存此层
COPY . /app/  # 最后复制应用代码

6. ENV

作用：设置环境变量，可在后续指令中使用。 语法：

ENV <key>=<value> ...
ENV PYTHONUNBUFFERED=1  # 禁用Python输出缓冲
ENV APP_PORT=8080 DB_HOST=localhost
  • 最佳实践
    • 用于设置不变的环境变量（如配置参数）。
    • 敏感信息（如密码）建议通过docker run --env传递，而非硬编码在 Dockerfile 中。

7. WORKDIR

作用：设置工作目录，后续指令的相对路径以此为基准。 语法：

WORKDIR /path/to/dir
WORKDIR /app
RUN pip install -r requirements.txt  # 在/app目录执行
CMD ["python", "app.py"]  # 运行/app/app.py
  • 最佳实践
    • 使用绝对路径，避免路径歧义。
    • 若目录不存在，WORKDIR会自动创建。

8. VOLUME

作用：创建挂载点，用于数据持久化或容器间共享。 语法：

VOLUME ["/data"]
VOLUME /var/log/app  # 挂载日志目录
  • 注意事项
    • 挂载点在运行时由 Docker 管理，镜像构建时无法操作其中的内容。
    • 建议在docker run时通过-v或--mount参数显式挂载，而非依赖 Dockerfile 中的VOLUME。

9. EXPOSE

作用：声明容器运行时监听的端口，仅作文档用途，不实际映射端口。 语法：

EXPOSE <port> [<port>/<protocol>]
EXPOSE 8080/tcp  # 声明HTTP服务端口
EXPOSE 5432/udp  # 声明UDP端口
  • 最佳实践
    • 配合docker run -p或docker-compose.yml中的端口映射使用。
    • 支持多个端口声明（如EXPOSE 80 443）。

10. CMD

作用：设置容器启动时的默认命令，若有多个CMD，仅最后一个生效。 三种形式：

  • exec 形式（推荐）

    CMD ["python", "app.py"]  # 直接执行命令

    当运行容器的时候会在容器里面执行 pyhton app.py

  • shell 形式

    CMD python app.py  # 通过shell执行，可能导致信号处理问题

    当运行容器的时候会在容器里面执行 pyhton app.py

  • 作为ENTRYPOINT的默认参数

    ENTRYPOINT ["python", "app.py"]
CMD ["--host=0.0.0.0"]  # 此参数会传递给ENTRYPOINT

  • 最佳实践

    • 使用 exec 形式避免 shell 包装，确保进程接收 Docker 的信号（如SIGTERM）。

    • 若需运行多个命令，可封装为脚本并执行：

      CMD ["/scripts/start.sh"]

11. ENTRYPOINT

作用：配置容器启动时的执行命令，与CMD配合可实现参数化。 两种形式：

  • exec 形式（推荐）

    ENTRYPOINT ["python", "app.py"]
CMD ["--port=8080"]  # 默认参数，可被docker run覆盖

  • shell 形式

    ENTRYPOINT python app.py  # 会忽略CMD和docker run的参数

  • 示例

    ENTRYPOINT ["python", "app.py"]  # 固定命令
# 运行时可覆盖参数：docker run myimage --port=8000

  • 最佳实践

    • 使用 exec 形式，允许通过docker run --entrypoint覆盖。
    • 常用于封装可执行程序（如数据库客户端、CLI 工具）。

12. ONBUILD

作用：设置触发器，当该镜像被其他镜像用作基础镜像时执行。

ONBUILD指令的作用是为基础镜像添加触发器，当其他镜像通过FROM指令继承该基础镜像时，这些触发器会被自动执行。

语法：

ONBUILD <INSTRUCTION>
ONBUILD COPY . /app
ONBUILD RUN pip install -r requirements.txt
  • 最佳实践
    • 用于创建可复用的基础镜像（如应用框架镜像）。
    • 避免在ONBUILD中使用ADD、COPY等依赖上下文的指令，可能导致构建失败。

完整示例

以下是一个 Python Flask 应用的 Dockerfile 示例：