【docker】Dockerfile 指令详解

发布时间：2024年01月04日

一、Dockerfile 指令详解

Dockerfile是一个用于编写docker镜像生成过程的文件，其有特定的语法。Dockerfile的基本指令有十三个，分别是：FROM、MAINTAINER、RUN、CMD、EXPOSE、ENV、ADD、COPY、ENTRYPOINT、VOLUME、USER、WORKDIR、ONBUILD。

  1. FROM：用于指定基础镜像。
  2. MAINTAINER：用于指定维护者信息。
  3. RUN：用于执行命令。
  4. CMD：用于执行特定的命令。
  5. EXPOSE：用于标明这个镜像中的应用将会监听某个端口，并且希望能将这个端口映射到主机的网络界面上，使容器内的应用可以通过端口和外界交互。
  6. ENV：用于设置环境变量。
  7. ADD：用于从指定的URL地址下载内容复制到容器的文件系统中，还可以将压缩打包格式的文件解压后复制到指定位置。
  8. COPY：用于将文件复制到容器中。
  9. ENTRYPOINT：用于指定容器启动后执行的命令。
  10. USER：用于设置运行容器时的用户。
  11. WORKDIR：用于设置工作目录。
  12. VOLUME：用于设置卷。
  13. ONBUILD：用于设置当此镜像作为其他镜像的基础镜像时，所执行的构建操作。

1）FROM （指定基础image）

构建指令，必须指定且需要在Dockerfile其他指令的前面。后续的指令都依赖于该指定的image。FROM指令指定的基础image可以是官方远程仓库中的，也可以位于本地仓库。

该指令有两种格式：
FROM <image>
指定基础image为该image的最后修改的版本。或者：

FROM <image>:<tag>
指定基础image为该image的一个tag版本。

2）MAINTAINER（用来指定镜像创建者信息）

构建指令，用于将image的制作者相关的信息写入到image中。当我们对该image执行docker inspect命令时，输出中有相应的字段记录该信息。

格式：
MAINTAINER <name>

3）RUN（安装软件用）

构建指令，RUN可以运行任何被基础image支持的命令。如基础image选择了Centos，那么软件管理部分只能使用Centos的命令。

该指令有两种格式：
RUN <command> (the command is run in a shell - `/bin/sh -c`)  
RUN ["executable", "param1", "param2" ... ]  (exec form)

4）CMD（设置container启动时执行的操作）

设置指令，用于container启动时指定的操作。该操作可以是执行自定义脚本，也可以是执行系统命令。该指令只能在文件中存在一次，如果有多个，则只执行最后一条。

该指令有三种格式：
CMD ["executable","param1","param2"] (like an exec, this is the preferred form)  
CMD command param1 param2 (as a shell)

当Dockerfile指定了ENTRYPOINT，那么使用下面的格式：
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)

ENTRYPOINT指定的是一个可执行的额脚本或者程序的路径，该指定的的脚本或者程序将会以param1和param2作为参数执行。所以如果CMD指令使用上面的形式，那么Dockerfile中必须要有配套的ENTRYPOINT。

5）ENTRYPOINT（设置container启动时执行的操作）

设置指令，指定容器启动时执行的命令，可以多次设置，但是只有最后一个有效。

#两种格式：
ENTRYPOINT ["executable", "param1", "param2"] (like an exec, the preferred form)  
ENTRYPOINT command param1 param2 (as a shell)\

该指令的使用分为两种情况，一种是独自使用，另一种和CMD指令配合使用。

当独自使用时，如果你还使用了CMD命令且CMD是一个完整的可执行的命令，那么CMD指令和ENTRYPOINT会互相覆盖只有最后一个CMD或者ENTRYPOINT有效。

比如：

# CMD指令将不会被执行，只有ENTRYPOINT指令被执行  
CMD echo “Hello, World!”  
ENTRYPOINT ls -l

另一种用法和CMD指令配合使用来指定ENTRYPOINT的默认参数，这时CMD指令不是一个完整的可执行命令，仅仅是参数部分。ENTRYPOINT指令只能使用JSON方式指定执行命令，而不能指定参数。

FROM centos7  
CMD ["-l"]  
ENTRYPOINT ["/usr/bin/ls"]

6）USER(设置container容器的用户)

设置指令，设置启动容器的用户，默认是root用户

# 指定memcached的运行用户  
ENTRYPOINT ["memcached"]  
USER daemon  
或  
ENTRYPOINT ["memcached", "-u", "daemon"]

7）EXPOSE（指定容器需要映射到宿主机器的端口）

设置指令，该指令会将容器中的端口映射成宿主机器中的某个端口。当你需要访问容器的时候，可以不是用容器的IP地址而是使用宿主机器的IP地址和映射后的端口。要完成整个操作需要两个步骤，首先在Dockerfile使用EXPOSE设置需要映射的容器端口，然后在运行容器的时候指定-p选项加上EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号。也可以指定需要映射到宿主机器的那个端口，这时要确保宿主机器上的端口号没有被使用。EXPOSE指令可以一次设置多个端口号，相应的运行容器的时候， 可以配套的多次使用-p选项。

格式：
EXPOSE <port> [<port>...]

# 映射一个端口
EXPOSE port1  

# 相应的运行容器使用的命令  
docker run -p port1 image   

# 映射多个端口  
EXPOSE port1 port2 port3  

# 相应的运行容器使用的命令  
docker run -p port1 -p port2 -p port3 image  

# 还可以指定需要映射到宿主机器上的某个端口号  
docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image

端口映射是docker比较重要的一个功能，原因在于我们每次运行容器的时候容器的IP地址不能指定而是在桥接网卡的地址范围内随机生成的。宿主机器的IP地址是固定的，我们可以将容器的端口的映射到宿主机上的一个端口，免去每次访问容器中的某个服务时都要查看容器的IP的地址，对于一个运行的容器，可以使用docker port加上容器中需要映射的端口和容器的ID来查看该端口号在宿主机器上的映射端口。

8）ENV（用于设置环境变量）

构建指令，在image中设置一个环境变量

格式：

ENV <key> <value>

设置了后，后续的RUN命令都可以使用，container启动后，可以通过docker inspect查看这个环境变量，也可以通过在docker run --env key=value实时设置或修改环境变量。

假如你安装了JAVA程序，需要设置JAVA_HOME，那么可以在Dockerfile中这样写：

ENV JAVA_HOME /path/to/java/dirent

9）ADD （复制文件或目录到镜像中，支持远程 URL 和解压缩功能）

如果文件是可识别的压缩格式，则docker会帮忙解压缩（注意压缩格式）；

如果src是文件且dest中不使用斜杠结束，则会将dest视为文件，src的内容会写入dest；如果src是文件且dest中使用斜杠结束，则会src文件拷贝到dest目录下。

格式：

ADD <src> <dest>

是相对被构建的源目录的相对路径，可以是文件或目录的路径，也可以是一个远程的文件url
是container中的绝对路径

如果 src 是目录，则 dest 可以是目录或文件。如果 dest 是目录，则 src 中的所有文件和子目录都会被复制到 dest 中。如果 dest 是文件，则 src 中的所有文件都会被复制到 dest 中，并重命名为 dest 的文件名。

如果 src 是文件，则 dest 必须是文件。如果 dest 是目录，则 src 中的文件会被复制到 dest 中，并重命名为 dest 的文件名。

ADD 命令可以使用以下选项：

  • -from ：指定要复制的文件或目录的镜像。
  • -chown ：指定要复制的文件或目录的所有者和组。
  • -chmod ：指定要复制的文件或目录的权限。

以下是 ADD 命令的一些示例：

ADD src/ /app
ADD src/index.html /app/index.html
ADD src/ /app/ -from my-image
ADD src/ /app/ -chown root:root
ADD src/ /app/ -chmod 755

ADD 命令是 Dockerfile 中非常常用的命令，它可以用于将应用程序的源代码、配置文件、数据库文件等复制到容器中。

10）COPY（复制文件或目录到镜像中）

COPY 命令用于将本地文件或目录复制到容器中。语法如下：

COPY <src> <dest>

其中， src 是本地文件或目录的路径， dest 是容器中文件或目录的路径。

如果 src 是目录，则 dest 可以是目录或文件。如果 dest 是目录，则 src 中的所有文件和子目录都会被复制到 dest 中。如果 dest 是文件，则 src 中的所有文件都会被复制到 dest 中，并重命名为 dest 的文件名。

如果 src 是文件，则 dest 必须是文件。如果 dest 是目录，则 src 中的文件会被复制到 dest 中，并重命名为 dest 的文件名。

COPY 命令可以使用以下选项：

  • -from ：指定要复制的文件或目录的镜像。
  • -chown ：指定要复制的文件或目录的所有者和组。
  • -chmod ：指定要复制的文件或目录的权限。

以下是 COPY 命令的一些示例：

COPY src/ /app
COPY src/index.html /app/index.html
COPY src/ /app/ -from my-image
COPY src/ /app/ -chown root:root
COPY src/ /app/ -chmod 755

COPY 命令是 Dockerfile 中非常常用的命令，它可以用于将应用程序的源代码、配置文件、数据库文件等复制到容器中。

11）VOLUME（指定挂载点）

设置指令，使容器中的一个目录具有持久化存储数据的功能，该目录可以被容器本身使用，也可以共享给其他容器使用。我们指定容器使用的是AUFS,这种文件系统不能持久化数据，当容器关闭后所有的更改都会丢失。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该指令。

格式：

VOLUME ["<mountpoint>"]
VOLUME /data
VOLUME /data1 /data2

使用VOLUME指令后，Docker会在容器中创建一个或多个匿名卷（anonymous volume），这些匿名卷将持久化存储容器中的数据。当容器删除时，这些匿名卷不会被自动删除，您需要手动删除它们。

您还可以使用docker run命令的-v选项将宿主机的目录或文件挂载到容器的挂载点上，实现宿主机与容器之间的数据共享。

需要注意的是，VOLUME指令只能在Dockerfile中使用，不能在容器运行时使用。如果您需要在容器运行时创建挂载点，可以使用docker run命令的-v选项。

RUN mkdir /myvol
RUN echo "hello wolrd" > /myvol/greeting
VOLUME ["/myvol"]

运行通过该Dockerfile生成image的容器，/myvol 目录中的数据在容器关闭后，里面的数据还存在。

该指令会创建匿名数据卷，可以通过docker volume ls指令查看目录位置

[root@localhost data]# docker volume ls
DRIVER    VOLUME NAME
local     5a89f86a6926edb5cac07e7b11fdde89f0dfa7284ca6add8bf09274bc1afea62
[root@localhost data]#

然后再通过docker volume inspect查看具体路径

[root@localhost data]# docker volume inspect 5a89f86a6926edb5cac07e7b11fdde89f0dfa7284ca6add8bf09274bc1afea62
[
    {
        "CreatedAt": "2024-01-04T04:36:33-05:00",
        "Driver": "local",
        "Labels": {
            "com.docker.volume.anonymous": ""
        },
        "Mountpoint": "/var/lib/docker/volumes/5a89f86a6926edb5cac07e7b11fdde89f0dfa7284ca6add8bf09274bc1afea62/_data",
        "Name": "5a89f86a6926edb5cac07e7b11fdde89f0dfa7284ca6add8bf09274bc1afea62",
        "Options": null,
        "Scope": "local"
    }
]
[root@localhost data]#

12）WORKDIR（切换目录）

设置指令，可以多次切换（相当于cd命令），对RUN ,CMD,ENTRYPOINT生效。

格式：
WORKDIR /path/to/workdir

# 在 /p1/p2 下执行 vim a.txt  
WORKDIR /p1 WORKDIR p2 RUN vim a.txt

13）ONBUILD（在子镜像中执行）

ONBUILD <Dockerfile关键字>

ONBUILD指定的命令在构建镜像时并不执行，而是在它的子镜像中执行。

完整Dockerfile参考

# pull base image
#FROM 127.0.0.1:5000/centos6.7:latest
FROM hub.c.163.com/public/centos:6.7

# maintainer
MAINTAINER      wlddhj "wlddhj@163.com"

# update source
# pass

# install req pkgs
#RUN yum update -y
RUN yum install -y bzip2

# deploy jdk1.7.0_80
RUN mkdir -p /data/tmp
WORKDIR /data/tmp
RUN wget http://7mnldi.com1.z0.glb.clouddn.com/jdk-7u80-linux-x64.rpm\
&& yum install -y jdk-7u80-linux-x64.rpm

# set jdk env
ENV JAVA_HOME=/usr/java/jdk1.7.0_80
ENV CLASSPATH=.:$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
ENV PATH=$PATH:$JAVA_HOME/lib

# deploy tomcat 7.0.33.0
RUN useradd tomcat\
&& mkdir -p /data/product/deploy

#RUN mkdir /opt/apache-tomcat
WORKDIR /data/tmp

#RUN wget http://7mnldi.com1.z0.glb.clouddn.com/apache-tomcat_7.0.33.0.tar.bz2
RUN wget http://7mnldi.com1.z0.glb.clouddn.com/apache-tomcat-7.0.72.tar.gz\
&& cd /data/tmp\
&& tar -xf apache-tomcat-7.0.72.tar.gz\
&& mv apache-tomcat-7.0.72 /opt/apache-tomcat\
&& chown -R tomcat.tomcat /opt/apache-tomcat

# add tomcat's startup script
ADD ./tomcat /etc/init.d/tomcat
RUN chmod 755 /etc/init.d/tomcat

# dir mapping
# pass

# set tomcat env
# pass

# deploy zabbix agent
# pass

# clean yum cache
RUN yum clean all

# clean wget cache
RUN rm -rf /data/tmp

# expose ports
EXPOSE 8080

# start tomcat
#ENTRYPOINT service tomcat start && tail -f /opt/apache-tomcat/logs/catalina.`date +'%Y-%m-%d'`.out
ENTRYPOINT service tomcat start && tail -f /opt/apache-tomcat/logs/catalina.out
#ENTRYPOINT service tomcat start

使用docker build 打包镜像

docker build 是 Docker 中用于从 Dockerfile 和上下文构建镜像的命令。以下是该命令的详细解释和常用选项：

基本用法

docker build [OPTIONS] PATH | URL | -
  • PATH：本地文件系统上的一个目录路径，该目录包含 Dockerfile 和构建上下文。
  • URL：Git 仓库的 URL，Docker 将从该仓库获取构建上下文和 Dockerfile。
  • -：表示通过 STDIN 给出 Dockerfile 或上下文。

常用选项（OPTIONS）

  • --build-arg：设置构建时的变量，这些变量可以在 Dockerfile 中通过 ARG 指令使用。
  • --no-cache：不使用缓存，总是重新构建镜像。
  • --compress：使用 gzip 压缩构建的上下文，然后再发送给 Docker 守护进程。注意：该选项在新版本的 Docker 中可能已被弃用或替换，具体请查阅官方文档。
  • --disable-content-trust：默认值为 true，表示不对镜像进行内容信任验证。如果设置为 false，则会对镜像进行签名和验证。
  • --file, -f：指定 Dockerfile 的完整路径，默认值为 PATH/Dockerfile。
  • --isolation：设置容器的隔离技术，默认值为 default，表示使用宿主机的默认隔离技术。其他可选值包括 process 或 hyperv（Windows 平台）。
  • --label：为生成的镜像设置元数据标签。
  • --squash：将新构建出的多个层压缩为一个新层，但这样会使得镜像失去层之间的历史记录和可重用性。注意：在新版本的 Docker 中，该选项可能已被弃用或替换为其他功能。
  • --tag, -t：设置镜像的名字和标签，格式为 name:tag 或 name。可以在一次构建中为一个镜像设置多个标签。
  • --network：设置构建过程中容器使用的网络模式，默认值为 default。

注意事项

  1. 构建上下文：构建上下文是 Docker 在构建镜像时所需的一组文件和目录。在执行 docker build 命令时，指定的 PATH 或 URL 实际上就是构建上下文的根目录。Dockerfile 中的指令（如 COPY）可以引用构建上下文中的文件或目录。需要注意的是，构建上下文中的所有文件和目录都会被发送到 Docker 守护进程，因此请确保不要包含不必要的大文件或敏感信息。
  2. 缓存机制：为了提高构建效率，Docker 会缓存已经执行过的指令和结果。如果 Dockerfile 或构建上下文没有发生变化，那么 Docker 会直接使用缓存的结果而不是重新执行指令。可以通过 --no-cache 选项禁用缓存机制。
  3. 内容信任：Docker 提供了一种内容信任机制来确保镜像的完整性和安全性。可以通过 --disable-content-trust 选项来禁用该功能（默认值为 true），但在生产环境中建议启用该功能并对镜像进行签名和验证。

更多参数说明

--build-arg=[] :设置镜像创建时的变量；
--cpu-shares :设置 cpu 使用权重；
--cpu-period :限制 CPU CFS周期；
--cpu-quota :限制 CPU CFS配额；
--cpuset-cpus :指定使用的CPU id；
--cpuset-mems :指定使用的内存 id；
--disable-content-trust :忽略校验，默认开启；
-f :指定要使用的Dockerfile路径；
--force-rm :设置镜像过程中删除中间容器；
--isolation :使用容器隔离技术；
--label=[] :设置镜像使用的元数据；
-m :设置内存最大值；
--memory-swap :设置Swap的最大值为内存+swap，"-1"表示不限swap；
--no-cache :创建镜像的过程不使用缓存；
--pull :尝试去更新镜像的新版本；
--quiet, -q :安静模式，成功后只输出镜像 ID；
--rm :设置镜像成功后删除中间容器；
--shm-size :设置/dev/shm的大小，默认值是64M；
--ulimit :Ulimit配置。
--tag, -t: 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构建中为一个镜像设置多个标签。
--network: 默认 default。在构建期间设置RUN指令的网络模式

常用命令示例

docker build .  #默认使用当前目录下Dockerfile
docker build . -f centosdockerfile  #其他名称dockerfile，需要指定
docker build -f /path/to/a/Dockerfile . #递归目录下的dockerfile
docker build -t ghostwritten/app . #指定镜像名
docker build -t ghostwritten/app:1.0.2 -t ghostwritten/app:latest . #指定多个tag

#Dockerfile文件中的每条指令会被独立执行，并会创建一个新镜像，Docker 会重用已生成的中间镜像，以加速docker build的构建速度，也可以通过--cache-from指定
docker build -t ghostwritten/app --cache-from 31f630c65071 . 
docker build -t ghostwritten/app --no-cache . #不使用缓存

#通过 --build-arg 选项设置了两个构建时变量 USERNAME 和 PASSWORD。这些变量可以在 Dockerfile 中通过 ARG 指令使用，以定制镜像的构建过程。
docker build --build-arg USERNAME=myuser --build-arg PASSWORD=mypassword -t my-app:with-args .

docker build命令会根据Dockerfile文件及上下文构建新Docker镜像

## 创建新镜像，.为Dockerfile所在目录，
docker build -t mynginx:v2 .
docker run -d --name web -p 80:80 mynginx:v2
文章来源:https://blog.csdn.net/wlddhj/article/details/135393451
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
最新文章