Docker入门与实践之 Dockerfile 语法详解
一、Dockerfile 概述
Dockerfile是docker程序的解释脚本文件,Dockerfile 是一条一条的指令,Docker程序将dockerfile中的一条条指令编译成Linux可执行的命令。Dockerfile有自己书写格式和支持的命令,Docker程序解决这些命令间的依赖关系,类似于Makefile。Docker程序将读取Dockerfile,根据指令生成定制的image。相比image这种黑盒子,Dockerfile这种显而易见的脚本更容易被使用者接受,它明确的表明image是怎么产生的。有了Dockerfile,当我们需要定制自己额外的需求时,只需在Dockerfile上添加或者修改指令,重新生成image即可,省去了敲命令的麻烦。
在 Dockerfile 中用到的命令有这些:
指令 | 说明 |
FROM | 指定所创建镜像的基础镜像 |
MAINTAINER | 指定维护者信息 |
RUN | 运行命令 |
CMD | 指定启动容器时默认执行的命令 |
LABEL | 指定生成镜像的元数据标签信息 |
EXPOSE | 声明镜像内服务所监听的端口 |
ENV | 指定环境变量 |
ADD | 赋值指定的<src>路径下的内容到容器中的<dest>路径下,<src>可以为URL;如果为tar文件,会自动解压到<dest>路径下 |
COPY | 赋值本地主机的<scr>路径下的内容到容器中的<dest>路径下;一般情况下推荐使用COPY而不是ADD |
ENTRYPOINT | 指定镜像的默认入口 |
VOLUME | 创建数据挂载点 |
USER | 指定运行容器时的用户名或UID |
WORKDIR | 配置工作目录 |
ARG | 指定镜像内使用的参数(例如版本号信息等) |
ONBUILD | 配置当前所创建的镜像作为其他镜像的基础镜像时,所执行的创建操作的命令 |
STOPSIGNAL | 容器退出的信号 |
HEALTHCHECK | 如何进行健康检查 |
SHELL | 指定使用SHELL时的默认SHELL类型 |
二、指令详解
2.1 From 指令
FROM <image> FROM <image>:<tag> FROM <image>@<digest>
- FROM指定构建镜像的基础源镜像,如果本地没有指定的镜像,则会自动从 Docker 的公共库 pull 镜像下来。
- FROM必须是 Dockerfile 中非注释行的第一个指令,即一个 Dockerfile 从FROM语句开始。
- FROM可以在一个 Dockerfile 中出现多次,如果有需求在一个 Dockerfile 中创建多个镜像。
- 如果FROM语句没有指定镜像标签,则默认使用latest标签。
2.2 MAINTAINER 指令
MAINTAINER <name>
指定创建镜像的用户
2.3 Run 指令
在创建镜像的时候需要执行的命令。
# 由shell启动,Linux默认为`/bin/sh -c`,Windows默认为`cmd /S /C` RUN <command> # 运行可执行文件 RUN ["executable", "param1", "param2"]
每条RUN指令将在当前镜像基础上执行指定命令,并提交为新的镜像,后续的RUN都在之前RUN提交后的镜像为基础,镜像是分层的,可以通过一个镜像的任何一个历史提交点来创建,类似源码的 版本控制 。
exec 方式会被解析为一个 JSON 数组,所以必须使用双引号而不是单引号。exec 方式不会调用一个命令 shell,所以也就不会继承相应的变量。
2.4 CMD 指令
镜像创建后,运行容器需要执行的命令。
CMD ["executable","param1","param2"] (执行可执行文件,优先) CMD ["param1","param2"] (设置了ENTRYPOINT,则直接调用ENTRYPOINT添加参数) CMD command param1 param2 (执行shell内部命令)
CMD指定在 Dockerfile 中只能使用一次,如果有多个,则只有最后一个会生效。
CMD的目的是为了在启动容器时提供一个默认的命令执行选项。如果用户启动容器时指定了运行的命令,则会覆盖掉CMD指定的命令。
2.5 LABEL指令
给镜像添加信息。使用docker inspect
可查看镜像的相关信息。
LABEL "com.example.vendor"="ACME Incorporated"
2.6 EXPOSE
指定于外界交互的端口,在容器启动时用-p传递参数,例如-p 3307:3306
将容器内的3306绑定到本机的3307
EXPOSE <port> [<port>...]
告诉 Docker 服务端容器对外映射的本地端口,需要在 docker run 的时候使用-p或者-P选项生效。
2.7 ENV
设置环境变量
ENV <key> <value> # 只能设置一个变量 ENV <key>=<value> ... # 允许一次设置多个变量
指定一个环节变量,会被后续RUN指令使用,并在容器运行时保留。
2.8 ADD
将本地文件添加到容器中,identity, gzip, bzip2,xz,tar.gz,tgz等类型的文件将被添加tar -x命令,进行解压
ADD <src>... <dest>
ADD复制本地主机文件、目录或者远程文件 URLS 从 并且添加到容器指定路径中 。
支持通过 Go 的正则模糊匹配,具体规则可参见 Go filepath.Match
ADD hom* /mydir/ # 添加所有以"hom"开头的文件 ADD hom?.txt /mydir/ # ? 替代一个单字符,例如:"home.txt"ADD test relativeDir/ # 添加 "test" 到 `WORKDIR`/relativeDir/ ADD test /absoluteDir/ # 添加 "test" 到 /absoluteDir/
- 路径必须是绝对路径,如果 不存在,会自动创建对应目录
- 路径必须是 Dockerfile 所在路径的相对路径
- 如果是一个目录,只会复制目录下的内容,而目录本身则不会被复制
2.9 COPY
COPY <src>... <dest>
COPY复制新文件或者目录从 并且添加到容器指定路径中 。用法同ADD,唯一的不同是不能指定远程文件 URLS。
2.10 ENTRYPOINT
ENTRYPOINT "executable", "param1", "param2" ENTRYPOINT command param1 param2 (shell form)
配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖,而CMD是可以被覆盖的。如果需要覆盖,则可以使用docker run --entrypoint选项。
每个 Dockerfile 中只能有一个ENTRYPOINT,当指定多个时,只有最后一个生效。
2.11 VOLUME
VOLUME ["/data"]
VOLUME ["/data"] VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]
用于指定持久化目录,在容器启动时用-v传递参数,例如-v ~/opt/data/mysql:/var/lib/mysql
将本机的~/opt/data/mysql
和容器内的/var/lib/mysql
做持久化关联
容器启动时会加载,容器关闭后会回写。
2.12 USER
USER daemon
指定运行容器时的用户名或 UID,后续的RUN、CMD、ENTRYPOINT也会使用指定用户。
2.13 WORKDIR
WORKDIR /path/to/workdir
为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。可以使用多个WORKDIR指令,后续命令如果参数是相对路径,则会基于之前命令指定的路径。
WORKDIR /a (这时工作目录为/a) WORKDIR b (这时工作目录为/a/b) WORKDIR c (这时工作目录为/a/b/c)
2.14 ARG
ARG <name>[=<default value>]
由外部启动时必须传入的参数,在容器启动时用--build-arg
传递参数
指定于外界交互的端口,在容器启动时用-p传递参数,例如--build-arg CONT_IMG_VER=v2.0.1
2.15 ONBUILD
ONBUILD [INSTRUCTION]
配置当所创建的镜像作为其它新创建镜像的基础镜像时,所执行的操作指令。
如果基于 image-A 创建新的镜像时,新的 Dockerfile 中使用 FROM image-A 指定基础镜像时,会自动执行 ONBUILD 指令内容,等价于在后面添加了两条指令。
2.16 HEALTHCHECK
容器健康状况检查命令。
HEALTHCHECK [OPTIONS] CMD command HEALTHCHECK NONE
第一个的功能是在容器内部运行一个命令来检查容器的健康状况
第二个的功能是在基础镜像中取消健康检查命令
[OPTIONS]的选项支持以下三中选项:
--interval=DURATION 两次检查默认的时间间隔为30秒
--timeout=DURATION 健康检查命令运行超时时长,默认30秒
--retries=N 当连续失败指定次数后,则容器被认为是不健康的,状态为unhealthy,默认次数是3
注意:
HEALTHCHECK命令只能出现一次,如果出现了多次,只有最后一个生效。
转载于:https://www.cnblogs.com/wuwei928/p/9055432.html
Docker入门与实践之 Dockerfile 语法详解相关推荐
- docker镜像的构建及Dockerfile的详解应用,镜像加速器,镜像优化
docker镜像的构建及dockerfile的祥解应用 1.镜像的构建 1.1创建一个Dockerfile 1.2构建镜像 1.3查看镜像的分层结构 1.4镜像的缓存特性 2.Dockerfile详解 ...
- TensorFlow是什么?TensorFlow入门与实践 架构与设计详解
TensorFlow是什么? TensorFlow基于数据流图,用于大规模分布式数值计算的开源框架.节点表示某种抽象的计算,边表示节点之间相互联系的张量.计算图实例TensorFlow支持各种异构的平 ...
- Dockerfile命令详解之 COPY
许多同学不知道Dockerfile应该如何写,不清楚Dockerfile中的指令分别有什么意义,能达到什么样的目的,接下来我将在容器化专栏中详细的为大家解释每一个指令的含义以及用法. 专栏订阅传送门h ...
- 6.3.3 URDF语法详解03_joint
ROS入门 6.3.3 URDF语法详解03_joint <ROS入门-理论与实践>视频教程镇楼 joint urdf 中的 joint 标签用于描述机器人关节的运动学和动力学属性,还可以 ...
- Docker(三):Dockerfile 命令详解
上一篇文章Docker(二):Dockerfile 使用介绍介绍了 Dockerfile 的使用,这篇文章我们来继续了解 Dockerfile ,学习 Dockerfile 各种命令的使用. Dock ...
- python编程语法大全-Python编程入门——基础语法详解
今天小编给大家带来Python编程入门--基础语法详解. 关于怎么快速学python,可以加下小编的python学习群:611+530+101,不管你是小白还是大牛,小编我都欢迎,不定期分享干货 每天 ...
- python编程语法-Python编程入门——基础语法详解
今天小编给大家带来Python编程入门--基础语法详解. 一.基本概念 1.内置的变量类型: Python是有变量类型的,而且会强制检查变量类型.内置的变量类型有如下几种: #浮点 float_num ...
- python编程if语法-Python编程入门基础语法详解经典
原标题:Python编程入门基础语法详解经典 一.基本概念 1.内置的变量类型: Python是有变量类型的,而且会强制检查变量类型.内置的变量类型有如下几种: #浮点 float_number = ...
- python编程语法-Python编程入门——基础语法详解(经典)
今天小编给大家带来Python编程入门--基础语法详解.温馨提示: 亮点在最后! 在这里还是要推荐下我自己建的Python开发学习群:301056051,群里都是学Python开发的,如果你正在学习P ...
最新文章
- GlassFish 4带来了Java EE 7
- vscode更换主题的插件_VScode 插件开发(三)主题
- TCP/IP协议族 详解(TCP/IP四层模型、OSI七层模型)
- openresty package.path require 报错
- foxmail邮箱日历怎么新建事务
- vector,list deque三种容器对比
- 【转载】通往性能优化的天堂-地狱 JOIN方法说明
- 【渝粤教育】国家开放大学2018年春季 3819-21T燃气安全管理 参考试题
- 深入理解操作系统原理之文件系统
- PDCN/Padavan/老毛子路由器固件复位/无线桥接教程
- ha rose server安装 sql_Rose HA for SQL2008的安装之一
- 带通滤波器中心频率计算公式中R是哪个值_手把手教系列之IIR数字滤波器设计实现...
- 网上英语学习资源大整理
- iOS-底层原理 06: cls 与类的关联原理
- 测试——Monkey测试的介绍及使用
- C#图片压缩,等比例缩小
- keypair java_Java KeyPairGenerator genKeyPair()用法及代码示例
- 屏幕折射问题(非调试问题避坑)
- 了解cuda和显卡等基本概念
- 四川省计算机应用教材,四川省电子科技大学计算机应用技术
热门文章
- 【Vue.js 知识量化】Promise
- 【PyQt5】PyQt5 安装 以及使用 designer 开发 python GUI 界面
- python进阶08并发之四map, apply, map_async, apply_async差异
- 走进我的交易室06_交易
- ras私钥c#转java_RSA密钥,JAVA与.NET之间转换
- 计算机网络中使用的双绞线通常是16芯的,自考计算机应用基础判断题试题答案...
- mysql cluster常见问题访问_MySQL Cluster的常见问题
- 用python turtle画龙猫_【跟着弹簧学画画】教你一步步画出一只超萌的龙猫来!...
- 洛谷 P1036 [NOIP2002 普及组] 选数(DFS)
- 目标检测——夏侯南溪目标检测模型之数据结构