12. Docker Dockerfile

最新推荐文章于 2025-11-07 15:29:38 发布

原创最新推荐文章于 2025-11-07 15:29:38 发布 · 214 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Docker #容器 #部署 #dockerFile

Docker 专栏收录该内容

15 篇文章

订阅专栏

本文详细介绍了Dockerfile中的各种指令，包括FROM、MAINTAINER、RUN、CMD、LABEL、EXPOSE、ENV、ADD、COPY、ENTRYPOINT、VOLUME、USER、WORKDIR、ARG、ONBUILD、STOPSIGNAL、HEALTHCHECK和SHELL，解释了每种指令的用途和格式，帮助读者理解如何使用Dockerfile构建镜像。

0. 示例

# Nginx
#
# VERSION               0.0.1

FROM      ubuntu
MAINTAINER Victor Vieux <victor@docker.com>

RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server

# Firefox over VNC
#
# VERSION               0.3

FROM ubuntu

# Install vnc, xvfb in order to create a 'fake' display and firefox
RUN apt-get update && apt-get install -y x11vnc xvfb firefox
RUN mkdir /.vnc
# Setup a password
RUN x11vnc -storepasswd 1234 ~/.vnc/passwd
# Autostart firefox (might not be the best way, but it does the trick)
RUN bash -c 'echo "firefox" >> /.bashrc'

EXPOSE 5900
CMD    ["x11vnc", "-forever", "-usepw", "-create"]

# Multiple images example
#
# VERSION               0.1

FROM ubuntu
RUN echo foo > bar
# Will output something like ===> 907ad6c2736f

FROM ubuntu
RUN echo moo > oink
# Will output something like ===> 695d7793cbe4

# You᾿ll now have two images, 907ad6c2736f with /bar, and 695d7793cbe4 with
# /oink.

1. 指令

FROM 指定所创建镜像的基础镜像
MAINTAINER 指定维护者信息
RUN 运行命令
CMD 指定启动容器时默认执行的命令
LABEL 指定生成镜像的元数据标签信息
EXPOSE 声明镜像内服务所监听的端口
ENV 指定环境变量
ADD 复制文件到容器中，tar会自动解压
COPY 复制文件到容器中，tar会自动解压
ENTRYPOINT 指定镜像的默认入口
VOLUME 创建数据卷挂载点
USER 指定运行容器时的用户名或UID
WORKDIR 配置工作目录
ARG 指定镜像内使用的参数(例如版本号信息等)
ONBUILD 配置所创建的镜像作为其他镜像的基础镜像时，所执行的创建操作命令
STOPSINGAL 容器退出的信号值
HEALTHCHECK 如何进行健康检查
SHELL 指定使用shell时的默认shell类型

1.1. FROM

FROM ubuntu

指定创建镜像的基础镜像，如果本地不存在，默认去仓库下载
格式:

FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>

tag或digest是可选的，如果不使用这两个值时，会使用latest版本的基础镜像

1.2. MAINTAINER

MAINTAINER image_creator@docker.com

指定维护者信息，该信息会写入镜像Author属性域中

1.3. RUN

RUN命令支持两种格式

RUN <command>
RUN ["executable","param1","param2"]

1.3.1. `RUN <command>`

RUN apt-get update \
        && apt-get install -y inotify-tools nginx apache2 openssh-server

该格式默认在shell终端中运行命令，即 /bin/sh -c

1.3.2. `RUN ["executable","param1","param2"]`

RUN ["/bin/bash","-c","echo hello"]

该格式使用exec执行
该指令会被解析成json数组，所以必须使用双引号

1.4. CMD

CMD支持三种格式，每个 Dockerfile 只能有一条CMD命令。如果有多条，只有最后一条会被执行。

CMD ["EXECUTABLE","param1","param2"]
CMD command param1 param2
CMD ["param1","param2"]

1.4.1.`CMD ["EXECUTABLE","param1","param2"]`

使用exec执行，推荐使用

1.4.2. `CMD command param1 param2`

在/bin/sh中执行，提供给需要交互的应用

1.4.3. `CMD ["param1","param2"]`

提供给ENTRYPOINT的默认参数

1.5. LABEL

LABEL用来生成镜像的元数据标签信息，可以使用多个

LABEL version="1.0"

1.6. EXPOSE

用于声明容器内服务监听的端口,只声明不会完成端口映射

EXPOSE 80 443 60808

1.7. ENV

指定环境变量，在镜像生成过程中会被RUN指令使用，在镜像启动的容器中也会存在。

ENV JAVA_HOME /usr/local/java

1.8. ADD

该名命令用于将指定目录中的内容复制到容器中的路径下。
ADD <src> <dest>

可以是相对于dockerFile所在目录的相对路径，目录不存在时会自动创建
可以是镜像内的绝对路径，或者相对于工作目录的相对路径
路径支持正则表达式

1.9. COPY

该名命令用于将指定目录中的内容复制到容器中的路径下。
COPY <src> <dest>

可以是相对于dockerFile所在目录的相对路径，也可以是URL，还可以是tar文件(会自动解压)
可以是镜像内的绝对路径，或者相对于工作目录的相对路径
路径支持正则表达式

1.10. ENTRYPOINT

指定镜像的默认入口命令，该入口命令会在启动容器时作为根命令执行，所有传入值作为该命令的参数。
支持两种格式

ENTRYPOINT [“executable” ,“param1”, “param2”] (exec调用执行)
ENTRYPOINT command param1 param2 (shell中执行)
每个DockerFile中只能有一个ENTRYPOINT，当指定多个时，只有最后一个有效
且会被 --entrypoint参数覆盖掉