当前位置：首页 > news >正文

Dockerfile详解

news 2025/8/5 23:15:34

Dockerfile 核心指令说明

指令	作用	执行阶段	示例	注意事项
FROM	指定基础镜像	构建阶段	`FROM ubuntu:22.04`	必须为Dockerfile的第一个指令；支持多阶段构建中多次使用；`scratch`表示空镜像
RUN	执行命令并创建新的镜像层	构建阶段	`RUN apt-get update && apt-get install -y nginx` `RUN ["apt-get", "install", "-y", "nginx"]`	推荐使用exec格式（JSON数组）避免shell注入风险；合并多个命令减少镜像层数；清理缓存命令放同一层
COPY	复制本地文件/目录到镜像	构建阶段	`COPY app.py /app/` `COPY ["src/*.py", "/app/"]`	仅复制文件，不支持URL和自动解压；目标路径不存在会自动创建；使用`.dockerignore`排除不需要的文件
ADD	复制文件/目录或远程URL文件到镜像	构建阶段	`ADD https://example.com/file.tar.gz /tmp/`	支持自动解压tar.gz文件和URL下载；优先使用COPY（更明确）；远程URL文件不会自动解压
CMD	指定容器启动命令	运行阶段	`CMD ["nginx", "-g", "daemon off;"]`	每个Dockerfile只能有一个CMD，多个则最后一个生效；可被`docker run`命令参数覆盖；通常用于设置默认参数
ENTRYPOINT	设置容器入口点	运行阶段	`ENTRYPOINT ["nginx"]` <br> `ENTRYPOINT nginx`	不可被`docker run`命令直接覆盖（需使用`--entrypoint`选项）；常与CMD配合使用（CMD作为参数）
ENV	设置环境变量	构建+运行阶段	`ENV APP_HOME=/app` `ENV PATH=$PATH:/usr/local/bin`	环境变量在构建和运行时均可用；可通过`docker run -e`覆盖；使用`ENV key=value`格式，等号前后无空格
WORKDIR	设置工作目录	构建+运行阶段	`WORKDIR /app` `WORKDIR /usr/local/nginx`	后续指令的工作目录；若不存在会自动创建；推荐使用绝对路径；可多次使用切换目录
EXPOSE	声明容器运行时监听的端口	构建阶段（声明）	`EXPOSE 80/tcp` `EXPOSE 443/udp`	仅为文档说明，不实际映射端口；需通过`docker run -p`实际映射；可指定协议（tcp/udp）
VOLUME	创建匿名卷	构建+运行阶段	`VOLUME ["/data"]` `VOLUME /var/log`	运行时会自动创建匿名卷，避免数据丢失；无法指定宿主机路径（运行时通过`-v`指定）
ARG	定义构建参数	构建阶段	`ARG VERSION=1.0` `ARG USER=builder`	仅在构建时可用，运行时不可访问；可通过`docker build --build-arg`覆盖；默认值可选
LABEL	添加镜像元数据	构建阶段	`LABEL maintainer="dev@example.com" version="1.0"`	键值对格式，可包含多个标签；使用OCI标准标签提高兼容性；通过`docker inspect`查看
ONBUILD	设置子镜像构建触发器	构建阶段（子镜像）	`ONBUILD COPY . /app` <br> `ONBUILD RUN npm install`	当当前镜像被用作其他镜像的基础镜像时触发；避免在基础镜像中过度使用
HEALTHCHECK	定义容器健康检查命令	运行阶段	`HEALTHCHECK --interval=30s --timeout=3s CMD curl -f http://localhost/
SHELL	更改默认shell	构建阶段	`SHELL ["/bin/sh", "-c"]` <br> `SHELL ["powershell", "-Command"]`	Windows容器常用；影响RUN/CMD/ENTRYPOINT的shell模式执行；默认Linux为`["/bin/sh", "-c"]`
USER	指定运行用户	构建+运行阶段	`USER www-data` `USER 1000:1000`	需确保用户已存在（可通过RUN创建）；切换后后续指令均使用该用户；降低权限增强安全性
STOPSIGNAL	设置容器停止信号	运行阶段	`STOPSIGNAL SIGTERM` <br> `STOPSIGNAL 15`	默认为SIGTERM；指定容器接收的停止信号；与应用程序信号处理机制配合使用
AS	为多阶段构建中的阶段命名	构建阶段	`FROM node:18 AS builder` `FROM alpine:latest AS runner`	配合多阶段构建使用；通过`--from=builder`引用其他阶段文件；减少最终镜像大小

docker build -t myalpine:v1.0 -f Dockerfile . --progress=plain --no-cache

--progress=plain 是一个控制构建输出日志显示格式的选项

--no-cache：强制重新执行所有步骤（不利用缓存）

RUN: 镜像构建阶段

CMD：镜像运行阶段

指令测试

RUN指令

1. 准备Dockerfile指令

-c 非交互模式

2.build镜像

docker build -t run-test:v1.0 -f Dockerfile . --progress=plain --no-cache

在build中，执行了RUN指令
RUN [ "echo","docker构建阶段成功-execV1"," $APP_NAME" ] 存在bug，无法使用env变量
CMD中的未打印出结果，表示CMD没有在构建阶段执行

3.启动镜像

# docker run -it --name run-container run-mirror:v0.0.1

ARG指令

作用：定义变量，build构建时使用的变量

 docker build   --build-arg  #修改变量

使用默认值

build时自定义ARG参数值

使用场景

自定义基础镜像版本

# 自定义镜像版本(默认最新版本)
ARG version=latest
FROM alpine:${version}

自定义用户名

自定义路径

ENV指令

一般容器运行时使用，可通过

 docker run -e  启动镜像时修改环境变量

查询所有的环境变量

docker image inspect  容器名称

USER指令

使用root账号有风险，设置一个账号专门管理

多阶段构建示例

# 构建阶段 
FROM maven:3.8-openjdk-17 AS builder 
WORKDIR /app 
COPY pom.xml . COPY src ./src 
RUN mvn package -DskipTests  # 运行阶段 
FROM openjdk:17-jdk-slim 
WORKDIR /app 
COPY --from=builder /app/target/*.jar app.jar 
EXPOSE 8080 
ENTRYPOINT ["java", "-jar", "app.jar"]

RUN

CMD

查看全文

http://www.dtcms.com/a/307915.html