前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Dockerfile 基本命令详解

Dockerfile 基本命令详解

作者头像
码农小胖哥
发布2019-12-10 17:19:45
7440
发布2019-12-10 17:19:45
举报
文章被收录于专栏:码农小胖哥的码农生涯

1. 前言

Dockerfile 是用来构建自定义 Docker 镜像的文本文档。我们通过docker build 命令用于从Dockerfile 文件构建镜像。如果你要构建自定义镜像,Dockerfile 是你必须学会的技能之一。

2. Dockerfile 的基本结构

Dockerfile 一般分为:基础镜像、镜像元信息、镜像操作指令和容器启动时执行指令,# 为 Dockerfile 中的注释。

3. Dockerfile 文件说明

Docker 从上到下的顺序运行Dockerfile 的指令,每一个指令都以 step 为步骤。而且文件的命名也必须为 Dockerfile

4. Dockerfile 常用的指令。

接下来对常用的 Dockerfile 指令进行总结。

4.1 FROM 指令

FROM是指定基础镜像,必须为第一个命令,格式:

FROM <image>:<tag>

其中 tagdigest 是可选的,如果不使用这两个值时,会使用 latest 版本的基础镜像。

示例: FROM mysql:5.6

4.2 MAINTAINER 指令

MAINTAINER 用来声明维护者信息,该命令已经过期,推荐使用 LABEL ,格式:

MAINTAINER <name>

4.3 LABEL 指令

LABEL:用于为镜像添加元数据,多用于声明构建信息,作者、机构、组织等。格式:

LABEL <key>=<value> <key>=<value> <key>=<value> ...

示例: LABEL version="1.0" description="felord.cn" by="Felordcn"

使用LABEL 指定元数据时,一条LABEL指定可以指定一或多条元数据,指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定,以免生成过多的中间镜像。

4.4 ENV 指令

ENV 用来设置环境变量,格式:

ENV <key> <value> # 之后的所有内容均会被视为其的组成部分,因此,一次只能设置一个变量

ENV <key>=<value> ... #可以设置多个变量,每个变量为一个"="的键值对,如果中包含空格,可以使用\来进行转义,也可以通过""来进行标识;另外,\ 也可以用于续行

示例: ENV version 1.0.0 或者 ENV version=1.0.0

可以通过 ${key} 在其它指令中来引用变量,如 ${version} 。我们也可以通过 docker run 中的 -e <ENV> 来动态赋值

4.5 ARG 指令

ARG 用于指定传递给构建运行时的变量,格式:

ARG <name>[=<default value>]

通过 docker run 中的 --build-arg <key>=<value> 来动态赋值,不指定将使用其默认值。

4.6 WORKDIR 指令

WORKDIR 用来指定工作目录,类似于我们通常使用的cd 命令,格式:

WORKDIR <PATH>

通过 WORKDIR 设置工作目录,Dockerfile 中的其它指令 RUNCMDENTRYPOINTADDCOPY等命令都会在该目录下执行。在使用 docker run 运行容器时,可以通过 -w 参数覆盖构建时所设置的工作目录。

4.7 ADD 指令

ADD 用于将本地文件添加到镜像中,tar 类型文件会自动解压(网络压缩资源不会被解压),可以访问网络资源,类似 wget,格式:

代码语言:javascript
复制
 ADD <src>... <dest>
 # 用于支持包含空格的路径
 ADD ["<src>",... "<dest>"]

示例:

ADD home /path/ # 支持通配符 添加所有以"home"开头的文件 到/path/ 下

4.8 COPY 指令

COPY 的功能类似于 ADD,但是不会自动解压文件,也不能访问网络资源

4.9 RUN 指令

RUN 用来执行构建镜像时执行的命令,有以下两种命令执行方式:

  • shell 执行格式:

RUN <command>

示例:RUN apk update

  • exec 执行格式: RUN ["executable", "param1", "param2"]

示例: RUN ["/dev/file", "p1", "p2"]

需要注意的是:RUN 指令创建的中间镜像会被缓存,并会在下次构建中使用。如果不想使用缓存镜像,可在构建时指定 --no-cache 参数,示例:docker build --no-cache

4.10 CMD 指令

CMD 构建容器后执行的命令,也就是在容器启动时才执行的命令。格式:

代码语言:javascript
复制
 # 执行可执行文件,优先执行
 CMD ["executable","param1","param2"]
 # 设置了 ENTRYPOINT,则直接调用ENTRYPOINT添加参数  参见 CMD 讲解
 CMD ["param1","param2"]
 # 执行shell命令
 CMD command param1 param2

示例: CMD ["/usr/bin/bash","--help"]

CMD 不同于 RUNCMD 用于指定在容器启动时所要执行的命令,而RUN用于指定镜像构建时所要执行的命令。

4.11 ENTRYPOINT 指令

ENTRYPOINT 用来配置容器,使其可执行化。配合 CMD可省去 application,只使用参数。格式:

代码语言:javascript
复制
 #可执行文件, 优先
 ENTRYPOINT ["executable", "param1", "param2"]
 # shell内部命令
 ENTRYPOINT command param1 param2

示例:

代码语言:javascript
复制
    FROM ubuntu

    ENTRYPOINT ["top", "-b"]

    CMD ["-c"]

ENTRYPOINTCMD 非常类似,不同的是通过 docker run 执行的命令不会覆盖 ENTRYPOINT ,而 docker run 命令中指定的任何参数都会被当做参数再次传递给 ENTRYPOINT 指令。Dockerfile 中只有最后一个 ENTRYPOINT 命令起作用,也就是说如果你指定多个ENTRYPOINT,只执行最后的 ENTRYPOINT 指令。

4.12 EXPOSE 指令

EXPOSE 指定与外界交互的端口,格式:

EXPOSE <port> [<port>...]

示例: EXPOSE 8080 443EXPOSE 80EXPOSE 11431/tcp 12551/udp

EXPOSE 并不会直接让容器的端口映射主机。宿主机访问容器端口时,需要在 docker run 运行容器时通过 -p 来发布这些端口,或通过 -P 参数来发布EXPOSE 导出的所有端口

4.13 VOLUME 指令

VOLUME 用于指定持久化目录, 格式:

VOLUME ["<src>",...]

示例:VOLUME ["/data"]VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]

一个卷可以存在于一个或多个容器的指定目录,该目录可以绕过联合文件系统,并具有以下功能:

  1. 卷可以容器间共享和重用
  2. 容器并不需要要和其它容器共享卷
  3. 修改卷后会立即生效
  4. 对卷的修改不会对镜像产生影响
  5. 卷会一直存在,直到没有任何容器在使用它

EXPOSE 指令类似, VOLUME 并不会挂载的宿主机,需要通过 docker run 运行容器时通过 -v 来映射到宿主机的目录中。参见另一个命令 docker volume create

4.14 USER 指令

USER 指定运行容器时的用户名或 UID,后续的 RUN 也会使用指定用户。使用 USER 指定用户时,可以使用用户名、UIDGID,或是两者的组合。当服务不需要管理员权限时,可以通过该命令指定运行用户。并且可以在之前创建所需要的用户,格式:

代码语言:javascript
复制
USER user
USER user:group
USER uid:group
USER uid
USER user:gid
USER uid:gid

使用 USER 指定用户后,Dockerfile 中其后的命令 RUNCMDENTRYPOINT 都将使用该用户。你可以通过 docker run 运行容器时,可以通过 -u 参数来覆盖指定用户。

4.15 ONBUILD 指令

ONBUILD 作用是其当所构建的镜像被用做其它镜像的基础镜像,该镜像中的 ONBUILD 中的命令就会触发,格式:

ONBUILD [INSTRUCTION]

示例:

代码语言:javascript
复制
ONBUILD ADD . /application/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src

5. 总结

今天对构建 Docker 镜像脚本 Dockerfile 基本命令进行的详细的总结,并加以举例说明,相信能解决你在构建镜像中的一些困惑。敬请多多关注微信公众号:Felordcn ,后续将会有更多干货奉上。

附: Spring Boot Dockerfile

代码语言:javascript
复制
   # 使用 aws 的java jdk 8
   FROM amazoncorretto:8
   # 作者等相关的元信息
   LABEL AUTHOR=Felordcn OG=felord.cn
   # 挂载卷
   VOLUME ["/tmp","/logs"]
   # 时区
   ENV TZ=Asia/Shanghai
   # 启用配置文件 默认为 application.yml
   ENV ACTIVE=defualt
   # 设置镜像时区
   RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
   # 修改为打包后的jar文件名称
   ADD /target/flyway-spring-boot-1.0.0.jar app.jar
   ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-Dspring.profiles.active=${ACTIVE}","-jar","app.jar"]
本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2019-11-17,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 码农小胖哥 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1. 前言
  • 2. Dockerfile 的基本结构
  • 3. Dockerfile 文件说明
  • 4. Dockerfile 常用的指令。
    • 4.1 FROM 指令
      • 4.2 MAINTAINER 指令
        • 4.3 LABEL 指令
          • 4.4 ENV 指令
            • 4.5 ARG 指令
              • 4.6 WORKDIR 指令
                • 4.7 ADD 指令
                  • 4.8 COPY 指令
                    • 4.9 RUN 指令
                      • 4.10 CMD 指令
                        • 4.11 ENTRYPOINT 指令
                          • 4.12 EXPOSE 指令
                            • 4.13 VOLUME 指令
                              • 4.14 USER 指令
                                • 4.15 ONBUILD 指令
                                • 5. 总结
                                • 附: Spring Boot Dockerfile
                                相关产品与服务
                                容器镜像服务
                                容器镜像服务(Tencent Container Registry,TCR)为您提供安全独享、高性能的容器镜像托管分发服务。您可同时在全球多个地域创建独享实例,以实现容器镜像的就近拉取,降低拉取时间,节约带宽成本。TCR 提供细颗粒度的权限管理及访问控制,保障您的数据安全。
                                领券
                                问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档