dockerfile
# escape=\ (backslash) # This dockerfile uses 七he ubuntu:xeniel image # VERS工ON 2 - EDITION 1 # Author: docker_user # Command format: Ins七ruction [arguments / command] # Base image to use, this must be set as the first line FROM ubuntu:xeniel ＃ Maintainer: docker_user <docker_user at email.com> （ @docker_user ） LABEL maintainer docker user<docker user@email.com> # Commands to upda七e the image RUN echo "deb http://archive.ubuntu.com/ubuntu/ xeniel main universe" apt/sources.list >> /etc/apt/sources.list RUN apt-getupdate && apt-get install -y nginx RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf # Commands when creating a new container CMD /usr/sbin/nginx
首行可以通过注释来指定解析器命令，后续通过注释说明镜像的相关信息。主体部分首先使用FROM指令说明所基于的镜像名称，接下来一般是使用LABEL指令说明维护者信息。后面则是镜像操作指令，例如RUN指令将对镜像执行跟随的命令。每运行一条RUN指令，镜像添加新的一层，并提交。最后是CMD指令，来指定运行容器时的操作命令。
例如：
FROM debain:jessie LABEL maintainer docker_user<docker_user@email.com> ENV NGINX_VERSION 1.10.1-1-jessie RUN apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-keys 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 \ && echo "deb http://ngix.org/packages/debian/ jessie ngix" >> /etc/apt/sources.list \ && apt-get update \ && apt-get install --no-install-recommends --no-install-suggest -y \ ca-certificates \ nginx=${NGINX_VERSION} \ nginx-module-xslt \ nginx-module-geoip \ nginx-module-image-filter \ nginx-module-perl \ nginx-module-njs \ gettext-base \ && rm -rf /var/lib/apt/lists/* # forward request and error logs to docker log collector RUN ln -sf /dev/stdout /var/log/nginx/access.log \ && ln -sf /dev/stderr /var/log/nginx/error.log EXPOSE 80 443 CMD ["nginx","-g","daemon off;"]
2、指令说明
1、分类
① 配置指令
-
ARG定义创建镜像过程中使用的变量 -
FROM指定所创建镜像的基础镜像 -
LABEL为生成的镜像添加元数据标签信息 -
EXPOSE声明镜像内服务监听的端口 -
ENV指定环境变量 -
ENTRYPOINT指定镜像的默认入口命令 -
VOLUME创建一个数据卷挂载点 -
USER指定运行容器时的用户名或UID -
WORKDIR配置工作目录 -
ONBUILD创建子镜像时指定自动执行的操作指令 -
STOPSIGNAL指定退出的信号值 -
HEALTHCHECK配置所启动容器如何进行健康检查 -
SHELL指定默认shell类型
② 操作指令
-
RUN运行指定命令 -
CMD启动容器时指定默认执行的命令 -
ADD添加内容到镜像 -
COPY复制内容到镜像
2、配置指令
-
ARG
定义创建镜像过程中使用的变量。
格式：
ARG <name>[=<default value>]在执行
docker build时，可以通过-build-arg[=]来为变量赋值。当镜像编译成功后，ARG指令的变量将不再存在（ENV指定的变量将在镜像中保留）。Docker内置了一些镜像创建变量，用户可以直接使用而无须声明，包括（不区分大小写）HTTP_PROXY、HTTPS_PROXY、FTP_PROXY、NO_PROXY。
-
FROM
指定所创建镜像的基础镜像。
格式：
FROM <image> [AS <name>]或FROM <image>:<tag> [AS <name>]或FROM <image>@<digest> [AS <name>]。任何Dockerfile中的第一条指令必须为
FROM指令。并且。如果在同一个Dockerfile中创建多个镜像时，可以使用多个FROM指令（每个镜像一次）为了保证镜像精简，可以选用体积较小的镜像如
Alpine或Debian作为基础镜像，例如：ARG VERSION=9.3
FROM debian:${VERSION} -
LABEL
LABEL指令可以为生成的镜像添加元数据标签信息。这些信息可以用来辅助过滤出特定镜像。
格式：
LABEL <key>=<value> <key>=<value>...。例如：
LABEL version="1.0.0-rc3"
LABEL author="yeasy@github" date="2020-01-01"
LABEL description="This text illustrates\
that label-value can span multiple lines." -
EXPOSE
声明镜像内服务监听的端口。
格式为：
EXPOSE <port> [<port>/<protocol>...]例如：
EXPOSE 22 80 8443注意该指令只是起到声明作用，并不会自动完成端口映射。
如果要映射端口出来，在启动容器时可以使用
-P参数（Docker主机会自动分配一个宿主主机的临时端口）或-p HOST_PORT:CONTAINER_PORT参数（具体指定所映射的本地端口）。 -
ENV
指定环境变量，在镜像生成过程中会被后续RUN指令使用，在镜像启动的容器中也会存在。、
-
ENTRYPOINT
-
VOLUME
-
USER
-
WORKDIR
-
ONBUILD
-
STOPSIGNAL
-
HEALTHCHECK
-
SHELL
