Dockerfile 简单使用

先来编写一个最简单的 Dockerfile。

  1. 例如:
FROM nginx
RUN echo '<h1>使用Dockerfile构建镜像</h1>' > /usr/share/nginx/html/index.html

该 Dockerfile 非常简单,其中的 FORM 、 RUN 都是 Dockerfile 的指令。
FROM 指令用于指定基础镜像 RUN 指令用于执行命令
2. 在 Dockerfile 所在路径执行一下命令构建镜像:

docker build -t nginx:my .

其中,命令最后的点(.)用于路径参数传递,表示当前路径。

  1. 执行以下命令,即可使用该镜像启动一个 Docker容器。
docker run -d -p 92:80 nginx:my
  1. 访问查看到效果(页面是因为编码问题)。

    从本例不难看出 Dockerfile的强大。仅仅编写了两行代码,就修改了原始镜像的行为。不仅如此,通过 Dockerfile,还可直观地看到修改镜像的具体过程。

除了使用Dockerfile构建镜像,也可手工制作 Docker镜像,但这种方式烦琐效率低,一般不适合生产。

Dockerfile 常用指令

在前面的例子中,提到了FORM、RUN指令。事实上, Dockerfile有十多个指令,指令的一般格式为:指令名称参数。

  1. ADD复制文件
    ADD 指令用于复制文件,格式为:
    ADD <src>... <dest>
    ADD ["<srv>"... "<dest>"]
    从src目录复制文件到容器的dest。其中src可以是 Dockerfile所在目录的相对路径,也可以是一个URL,还可以是一个压缩包。

注意:
1、src必须在构建的上下文内,不能使用例如:ADD ../somethine/something这样的命令,因为 docker bui1d命令首先会将上下文路径和其子目录发送到 docker daemon。
2、如果src是一个URL,同时dest不以斜杠结尾,dest将会被视为文件,src对应内容文件将会被下载到 dest。
3、如果src是一个URL,同时dest以斜杠结尾,dest将被视为目录,src对应内容将会被下载到dest目录。
4、如果 src 是一个目录,那么整个目录下的内容将会被复制,包括文件系统元数据。
5、如果文件是可识别的压缩包格式,则 doclcer 会自动解压。
示例:

ADD wzq-swagger-mng.jar app.jar
  1. ARG 设置构建参数
    ARG 指令用于设置构建参数,类似于 ENV。和 ARG 不同的是, ARG 设置的是构建时的环境变量,在容器运行时是不会存在这些变量的。
    格式为: ARG <name> [<default value>]。
    示例: ARG user=Jacob
  2. CMD 容器启动命令
    CMD 指令用于为执行容器提供默认值。每个 Dockerfile 只有一个 CMD 命令,如果指定了多个 CMD 命令,那么只有最后一条会被执行,如果启动容器时指定了运行的命令,则会覆盖掉 CMD 指定的命令。
    支持 3 种格式:
    CMD ["executable","paraml","param2"] (推荐使用)
    CMD ["param1","param2"](为 ENT 盯 PoINT 指令提供预设参数)
    CMD command param1 param2 (在 shell 中执行)
    示例: CMD echo " This 15 a test ." | wc -
  3. COPY 复制文件
    复制文件,格式为:
    COPY <src>... <dest>
    COPY ["<src>",... "<dest>"]
    复制本地的 src 到容器的 dest 。COPY 指令和 ADD 指尘类似, COPY 不支持 URL 和 压缩包。
  4. ENTRYPOINT 人口点
    格式为:
    ENTRYPOINT ["executable","param1";"param2"]
    ENTRYPOINT command param1 param2
    ENTRYPOINT 和 CMD指令目的是一样的,都是指定 Docker 容器启动时执行的命令,可多次设置,但只有最后一个有效。
  5. ENV 设置环境变量
    ENV 指令用于设置环境变量,格式为:
    ENV <key> <value>
    ENV <key>=<value>
    示例: ENV JAVA_HOME /path/to/java
  6. EXPOSE声明暴露的端口
    EXPOSE 指令用于声明在运行时容器提供服务的端口,格式为: EXPOSE <port> [<port>...]。
    需要注意的是,这只是一个声明,运行时并不会因为该声明就打开相应端口。该指令的作用主要是帮助镜像使用者理解该镜像服务的守护端口;其次是当运行时使用随机映射时,会自动映射 EXP0SE 的端口。
    示例:
  • 声明暴露一个端口示例 EXPOSE port1
  • 相应的运行容器使用的命令 docker run -p port1 image
  • 也可使用一 P 选项启动 docker run -P 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
  1. FROM 指定基础镜像
    使用 FORM 指令指定基础镜像,FORM 指令有点像 Java 里面的 extends 关键字。需要注意的是,FROM 指令必须指定且需要写在其他指令之前。 FORM 指令后的所有指令都依赖于该指令所指定的镜像。
    支持 3 种格式:
    FROM <image>
    FROM <image>:<tag>
    FROM <image>@<digest>
  2. LABEL 为镜像添加元数据
    LABEL 指令用于为镜像添加元数据。
    格式为:LABLE <key>=<volue> <key>=<volue> <key>=<volue> ...。
    使用“ " ”和“ \ ”转换命令行。
    示例:
    LABEL "com.example.vendor"="ACME Incorporated"
    LABEL com.example.label-with-value="foo"
    LABEL version="1.0"
    LABLE description="This text illustrates that label-values can span multlple lines."
  3. MAINTAINER 指定维护者的信息
    MAINTAINER 指令用于指定维护者的信息,用于为 DOCkerfile 署名。格式为: MAINTAINR <name>。
    示例:
    MAINTAINER Jacob<596766829@qq.com>
  4. RUN 执行命令
    该指令支持两种格式:
    RUN <Command>
    RUN ["executable","param1","param2"]
    UuN <command>在 shell 终端中运行,在 Linux 中默认是/bin/Sh -C ,在 Windows 中是 cmd /s /c,使用这种格式,就像直接在命令行中输人命令一样。 RUN ["executable","param1","param2"] 使用 exec 执行,这种方式类似于函数调用。指定其他终端可以通过该方式操作,例如: RUN ["/bin/bash","-c","echo hello"] ,该方式必须使用双引号”而不能使用单引号',因为该方式会被转换成一个 JsON 数组。
  5. USER 设置用户
    该指令用于设置启动镜像时的用户或者 UID ,写在该指令后的 RUN 、 CMD 以及 ENTRYPOINT 指令都将使用该用户执行命令。
    格式为:USER 用户名。
    示例: USER Jacob
  6. VOLUME 指定挂载点
    该指令使容器中的一个目录具有持久化存储的功能,该目录可被容器本身使用,也可共享给其他容器。当容器中的应用有持久化数据的需求时可以在 Dockerfile 中使用该指令。格式为:VOLUME ["data"。
    示例: VOLUME /data
  7. WORKDIR 指定工作目录
    格式为: WORKOIR /path/to/workdir。
    切换目录指令,类似于 cd 命令,写在该指令后的 RUN , CMD 以及 ENTRYPOINT 指令都将该目录作为当前目录,并执行相应的命令。
  8. 其他
    Dockerfile 还有一些其他的指令,例如 STOPSINGAL、HEALTHcHECK、SHELL 等。有兴趣的可前往 https://docs.docker.com/engine/reference/builder/进行扩展阅读。

使用 Dockerfile 构建 Docker 镜像

  1. 准备工作
    准备一个Jar包,本次使用的Jar包是springboot整合swagger。
  2. 使用Dockerfile 构建 Docker 镜像
    创建 Dockerfile 文件,并添加一下内容
#指定镜像
FROM java:8
#将本地文件夹挂载到当前容器
VOLUME /tmp
#复制文件到容器
ADD wzq-swagger-mng.jar app.jar
RUN bash -c 'touch /app.jar'
#声明需要暴露的端口
EXPOSE 10086
#配置容器启动后需要执行的命令
ENTRYPOINT ["java","-Djava.security.edg=file:/dev/.urandom","-jar","/app.jar"]
  1. 使用 docker build 命令构建镜像
docker build -t itouch/wzq-swagger-mng .


4. 启动镜像
docker run -d -p 10086:10086 itouch/wzq-swagger-mng
  1. 测试

学习于:《Spring Cloud与Docker 微服务架构实战》 — 周立