Dockerfile 详解

2024-10-13 16:50:31

Dockerfile是自定义Docker镜像的一套规则，由多条指令构成，每条指令都会对应于Docker镜像中的每一层，因为Docker是分层存储的。以下是Dockerfile中各个参数的详解及演示解析：

1. FROM

  • 功能：指定待扩展的父级镜像（基础镜像）。除了注释以外，文件开头必须是一个FROM指令，接下来的指令便在这个父级镜像的环境中运行，直到遇到下一个FROM指令。通过添加多个FROM命令，可以在同一个Dockerfile文件中创建多个镜像。

  • 示例：FROM centos:7

2. MAINTAINER（已废弃，建议使用LABEL）

  • 功能：声明创建的镜像的作者信息（用户名、邮箱）。非必须，但在某些情况下有助于了解镜像的来源和维护者。
  • 格式：MAINTAINER <AUTHOR_NAME>
  • 示例：MAINTAINER xiaoli
  • 注意：Docker官方推荐使用LABEL指令代替MAINTAINER来指定镜像的元数据。

3. LABEL

  • 功能：为镜像指定标签，可以包含多个键值对。
  • 格式：LABEL <key>=<value> <key>=<value> ...
  • 示例：
LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"

4. RUN

  • 功能：用来修改镜像的命令，常用来安装库、程序以及配置程序。一条RUN指令执行完毕后，会在当前镜像上创建一个新的镜像层，接下来的指令会在新的镜像上继续执行。

  • 格式：

    • RUN <command>（在/bin/sh环境中执行的指令）
    • RUN ["executable", "param1", "param2"]（直接使用系统调用exec来执行）

  • 示例：

RUN yum -y install httpd
RUN ["yum", "install", "nginx"]

5. EXPOSE

  • 功能：用来指明容器内进程对外开放的端口，多个端口之间使用空格隔开。运行容器时，通过参数-P（大写）即可将EXPOSE里所指定的端口映射到主机上另外的随机端口，其他容器或主机就可以通过映射后的端口与此容器通信。
  • 格式：EXPOSE <port> [<port>/<protocol>...]
  • 示例：EXPOSE 80 443

6. ADD 与 COPY

  • ADD：向新镜像中添加文件，这个文件可以是一个主机文件、一个网络文件或一个文件夹。如果源文件是主机上zip或tar形式的压缩文件，Docker会先解压缩，然后将文件添加到镜像的指定位置。如果源文件是一个通过URL指定的网络压缩文件，则不会解压。

  • COPY：从构建上下文目录中<源路径>的文件/目录复制到新的一层的镜像内的<目标路径>。COPY指令不会解压压缩文件，但会保留原文件的基本信息（如读、写、执行权限、文件变更时间等）。

  • 格式：

    • ADD <source> <destination>
    • COPY <source> <destination>

  • 示例：

ADD httpd-2.4.tar.gz /usr/local/
COPY index.html /usr/share/nginx/html/

7. VOLUME

  • 功能：在镜像里创建一个指定路径（文件或文件夹）的挂载点，这个容器可以来自主机或者其它容器。多个容器可以通过同一个挂载点共享数据，即便其中一个容器已经停止，挂载点也仍然可以访问。
  • 格式：VOLUME ["/data"]
  • 示例：VOLUME /data

8. WORKDIR

  • 功能：为接下来执行的指令指定一个新的工作目录，这个目录可以是绝对目录，也可以是相对目录。根据需要，WORKDIR可以被多次指定。当启动一个容器时，最后一条WORKDIR指令所指的目录将作为容器运行的当前工作目录。
  • 格式：WORKDIR <dirpath>
  • 示例：
WORKDIR /opt

9. ENV

  • 功能：设置容器运行的环境变量。在运行容器的时候，通过-e参数可以修改这个环境变量值，也可以添加新的环境变量。
  • 格式：ENV <key> <value> 或 ENV <key>=<value>
  • 示例：
ENV MYSQL_USER docker_user
ENV MYSQL_PASS docker_password

10. CMD

  • 功能：用来设置启动容器时默认运行的命令。Dockerfile中可以写多个CMD指令，但只有最后一个生效。CMD会被docker run之后的参数替换。

  • 格式：

    • CMD ["executable","param1","param2"]（推荐使用）
    • CMD command param1 param2（在/bin/sh中执行）
    • CMD ["param1","param2"]（提供给ENTRYPOINT的默认参数）

  • 示例：

CMD ["python", "app.py"]

11. ENTRYPOINT

  • 功能：与CMD类似，也是用来指定容器启动时的默认运行的命令。区别在于，运行容器时添加在镜像之后的参数，对ENTRYPOINT是拼接，CMD是覆盖。
  • 格式：ENTRYPOINT ["executable", "param1", "param2"]
  • 示例：
ENTRYPOINT ["curl", "-s", "https://ip.cn"]

12. USER

  • 功能：为容器的运行及接下来RUN、CMD、ENTRYPOINT等指令的运行指定用户或UID。
  • 格式：USER <username> 或 USER <UID>
  • 示例：USER xiaoli

13. ONBUILD

  • 功能：触发器指令。构建镜像时，Docker的镜像构建器会将所有的ONBUILD指令指定的命令保存到镜像的元数据中，这些命令在当前镜像的构建过程中并不会执行。只有新的镜像使用FROM指令指定父镜像为这个镜像时，便会触发执行。
  • 格式：ONBUILD <INSTRUCTION>
  • 示例：
ONBUILD ADD ./app/src /app/src

Dockerfile图解

在这里插入图片描述

演示解析

1.以下是一个简单的Dockerfile示例，用于构建一个包含httpd应用的Docker镜像：
# 使用官方的CentOS7作为基础镜像
FROM centos:7

# 维护者信息
MAINTAINER xwey

# 设置环境变量
ENV PATH="/usr/local/nginx/sbin:$PATH"

# 将本地nginx的tar包复制到容器中，ADD模块会自动解压tar包
ADD nginx-1.16.1.tar.gz /usr/local/

# 删除原有yum源，安装ali源，安装编译软件
RUN rm -rf /etc/yum.repos.d/* && curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo && curl -o /etc/yum.repos.d/epel.repo https://mirrors.aliyun.com/repo/epel-7.repo && yum install -y epel-release.noarch && yum install -y gcc gcc-c++ make openssl-devel pcre-devel && yum clean all

# 创建nginx用户设置不可登录
RUN useradd -s /sbin/nologin -M nginx

# 和cd一样，进入解压后的nginx目录
WORKDIR /usr/local/nginx-1.16.1

# 编译nginx
RUN ./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_ssl_module --with-pcre && make && make install && rm -rf /usr/local/nginx-1.16.1

# 暴露nginx应用默认端口
EXPOSE 80

# 启动nginx
CMD ["nginx","-g","daemon off;"]

# 使用build -t 打标签 （定义版本）
[root@docker ~]# docker build -t nginx:v1 .
[root@docker ~]# docker images
REPOSITORY      TAG       IMAGE ID       CREATED             SIZE
nginx           v1        188f961b7cf5   2 hours ago         367MB
centos          7         eeb6ee3f44bd   3 years ago         204MB
2.使用Dockerfile创建httpd镜像
# 文件清单
[root@docker ~]# tree apache_centos/
apache_centos/
├── Dockerfile
├── httpd-2.4.41.tar.gz
└── run.sh

# 创建run.sh
[root@docker apache_centos]# cat run.sh 
#!/bin/bash
/usr/local/apache2/bin/httpd -D FOREGROUND

# 准备Dockerfile
[root@docker apache_centos]# cat Dockerfile 
# 使用官方的CentOS7作为基础镜像
FROM centos:7

# 维护者信息
MAINTAINER xwey

# 删除原有yum源，配置ali源，安装编译软件
RUN rm -rf /etc/yum.repos.d/* && curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo && curl -o /etc/yum.repos.d/epel.repo https://mirrors.aliyun.com/repo/epel-7.repo && yum install -y gcc make apr-devel apr apr-util apr-util-devel pcre-devel && yum clean all

# 将本地下载好的httpd的tar包传入镜像
ADD httpd-2.4.41.tar.gz /usr/local/src/

# 将本地创建的启动脚本传入镜像
ADD run.sh /usr/local/sbin/run.sh

# 和cd一样，进入解压后的目录
WORKDIR /usr/local/src/httpd-2.4.41

# 开始编译，修改httpd配置文件，给启动文件加上执行权限
RUN ./configure --prefix=/usr/local/apache2 --enable-mods-shared=most --enable-so && make && make install && rm -rf /usr/local/src/* && sed -i 's/#ServerName www.example.com:80/ServerName localhost:80/g' /usr/local/apache2/conf/httpd.conf && /usr/local/apache2/bin/httpd && chmod 755 /usr/local/sbin/run.sh

# 暴露httpd默认端口
EXPOSE 80

# 启动上传的脚本
CMD ["/usr/local/sbin/run.sh"]

# 使用build -t 打标签 （定义版本）
[root@docker ~]# docker build -t apache:v1 .
[root@docker ~]# docker images
REPOSITORY      TAG       IMAGE ID       CREATED             SIZE
apache          v1        d6d9554494ab   About an hour ago   377MB
nginx           v1        188f961b7cf5   2 hours ago         367MB
centos          7         eeb6ee3f44bd   3 years ago         204MB

# 启动测试
[root@docker ~]# docker run -d -p 8111:80 apache:v1 /usr/local/sbin/run.sh
[root@docker ~]# curl 192.168.73.128:8111
<html><body><h1>It works!</h1></body></html>
上一篇：Docker 教程二 （架构）


下一篇：NJU ICS2024 PA 作业心得（二）