华为云首页用户手册

医疗智能体 EIHEALTH-制作Docker镜像:Dockerfile基本语法

时间：2024-05-10 16:07:17

医疗智能体 EIHEALTH 镜像管理

Dockerfile基本语法

FROM
指定待扩展的父级镜像(基础镜像)。除了注释以外，在文件的开头必须是一个FROM指令，后面的指令便在这个父级镜像的环境中运行，直到遇到下一个FROM指令。通过添加多个FROM命令，可以在同一个Dockerefile文件中创建多个镜像。
MAINTAINER
声明创建镜像的作者信息：用户名、邮箱，非必须参数。
RUN
用来修改镜像的命令，常用来安装库、程序以及配置程序。一条RUN指令执行完毕后，会在当前镜像上创建一个新的镜像层，接下来的指令会在新的镜像上继续执行。

RUN 语句具有以下形式。
- RUN yum update：在/bin/sh路径中执行的指令命令。
- RUN ["yum", "update"]：直接使用系统调用exec来执行。
- RUN yum update && yum install nginx：使用&&符号将多条命令连接在同一条RUN语句中。
EXPOSE
用来指明容器内进程对外开放的端口，多个端口之间使用空格隔开。运行容器时，通过参数-P(大写)即可将EXPOSE里所指定的端口映射到主机上另外的随机端口，其他容器或主机就可以通过映射后的端口与此容器通信。您也可以通过-p(小写)参数将Dockerfile中EXPOSE中没有列出的端口设置成公开的。
COPY
将本地的文件或目录复制到镜像中。
ADD
向新镜像中添加文件，这个文件可以是主机文件、网络文件或文件夹。
- 第一个参数：源文件（夹）。
  - 如果是相对路径，必须是相对于Dockerfile所在目录的相对路径。
  - 如果是URL，会将文件先下载下来，然后再添加到镜像里。
- 第二个参数：目标路径。
  - 如果源文件是主机上的zip或者tar形式的压缩文件，Docker会先解压缩，然后将文件添加到镜像的指定位置。
  - 如果源文件是一个通过URL指定的网络压缩文件，则不会解压。
VOLUME
在镜像里创建一个指定路径(文件或文件夹)的挂载点，这个容器可以来自主机或者其它容器。多个容器可以通过同一个挂载点共享数据，即便其中一个容器已经停止，挂载点也仍然可以访问。
WORKDIR
为接下来执行的指令指定一个新的工作目录，这个目录可以使绝对目录，也可以是相对目录。根据需要，WORKDIR可以被多次指定。当启动一个容器时，最后一条WORKDIR指令所指的目录将作为容器运行的当前工作目录。
ENV
设置容器运行的环境变量。在运行容器的时候，通过设置-e参数可以修改这个环境变量值，也可以添加新的环境变量。

例如：
```
docker run -e WEBAPP_PORT=8000 -e WEBAPP_HOST=www.example.com ...
```
CMD
用来设置启动容器时默认运行的命令。
ENTRYPOINT
用来指定容器启动时的默认运行的命令，与CMD类似。区别在于：运行容器时添加在镜像之后的参数，对ENTRYPOINT是拼接，CMD是覆盖。
- 若在DockerFile中指定了容器启动时的默认运行命令为ls -l，则运行容器时默认启动命令为ls -l。
  - ENTRYPOINT [ "ls", "-l"]：指定容器启动时的程序及参数为ls -l。
  - docker run centos：当运行centos容器时，默认执行的命令是docker run centos ls -l。
  - docker run centos -a：当运行centos容器时拼接了-a参数，则默认运行的命令是docker run centos ls -l -a。
- 若在DockerFile中指定了容器启动时的默认运行命令为--entrypoint，则在运行容器时若需要替换默认运行命令，可以通过添加--entrypoint参数来替换Dockerfile中的指定。
  docker run gutianlangyu/test --entrypoint echo "hello world"
USER
为容器的运行及RUN、CMD、ENTRYPOINT等指令的运行指定用户或UID。
ONBUILD
触发器指令。构建镜像时，Docker的镜像构建器会将所有的ONBUILD指令指定的命令保存到镜像的元数据中，这些命令在当前镜像的构建过程中并不会执行。只有新的镜像使用FROM指令指定父镜像为当前镜像时，才会触发执行。

使用FROM以这个Dockerfile构建出的镜像为父镜像，构建子镜像时：

ONBUILD ADD . /app/src：自动执行ADD . /app/src