Docker dockerfile指令
golang的Dockerfile FROM golang:latest MAINTAINER pan "pan@gmail.com" WORKDIR /go/src/studentapi COPY . /go/src/studentapi RUN go build . EXPOSE 9090 ENTRYPOINT ["./studentapi"]
Instruction | Description |
---|---|
FROM | 格式为 FROM <image> 或 FROM <image>:<tag> 。第一条指令必须为 FROM 指令。如果在同一个Dockerfile中创建多个镜像时,可以使用多个 FROM 指令(每个镜像一次)。 |
MAINTAINER | 格式为 MAINTAINER <name> ,指定维护者信息。 |
RUN | 格式为 RUN <command> 或 RUN ["executable", "param1", "param2"] 。前者将在shell终端中运行命令,即 /bin/sh -c ;后者则使用 exec 执行。指定使用其它终端可以通过第二种方式实现,例如 RUN ["/bin/bash", "-c", "echo hello"] 每条 RUN 指令将在当前镜像基础上执行指定命令,并提交为新的镜像。当命令较长时可以使用 \ 来换行。 |
ENTRYPOINT | 两种格式:ENTRYPOINT ["executable", "param1", "param2"] ENTRYPOINT command param1 param2 (shell中执行)。配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖。每个Dockerfile中只能有一个 ENTRYPOINT,当指定多个时,只有最后一个起效。ENTRYPOINT 执行指令中的参数可以由CMD 指定,或者通过run的时候在命令行中手动给出。 |
CMD | 支持三种格式 CMD ["executable","param1","param2"] 使用 exec 执行,推荐方式;CMD command param1 param2 在 /bin/sh 中执行,提供给需要交互的应用;CMD ["param1","param2"] 提供给 ENTRYPOINT 的默认参数;指定启动容器时执行的命令,每个Dockerfile只能有一条 CMD 命令。如果指定了多条命令,只有最后一条会被执行。如果用户启动容器时候指定了运行的命令,则会覆盖掉 CMD 指定的命令。 |
LABEL | Name/value metadata about the image |
ENV | 格式为 ENV <key> <value> 。 指定一个环境变量,会被后续 RUN 指令使用,并在容器运行时保持. |
COPY | 格式为 COPY <src> <dest> 。复制本地主机的 <src> (为Dockerfile所在目录的相对路径)到容器中的 <dest> 。当使用本地目录为源目录时,推荐使用 COPY 。 |
ADD | 格式为 ADD <src> <dest>该命令将复制指定的 <src> 到容器中的 <dest> 。 其中 <src> 可以是Dockerfile所在目录的一个相对路径;也可以是一个URL;还可以是一个tar文件 |
WORKDIR | 格式为 WORKDIR /path/to/workdir 为后续的 RUN 、 CMD 、 ENTRYPOINT 指令配置工作目录。可以使用多个 WORKDIR 指令,后续命令如果参数是相对路径,则会基于之前命令指定的路径。 |
EXPOSE | 格式为 EXPOSE <port> [<port>...]。告诉Docker服务端容器暴露的端口号,供互联系统使用。 |
VOLUME | 格式为 VOLUME ["/data"] 。创建一个可以从本地主机或其他容器挂载的挂载点,一般用来存放数据库和需要保持的数据等。 |
USER | 格式为 USER daemon 。指定运行容器时的用户名或UID,后续的 RUN 也会使用指定用户。当服务不需要管理员权限时,可以通过该命令指定运行用户。并且可以在之前创建所需要的用户,例如: RUN groupadd -r postgres && useradd -r -g postgres postgres 。要临时获取管理员权限可以使用 gosu ,而不推荐 sudo 。 |