86 lines
2.2 KiB
Markdown
86 lines
2.2 KiB
Markdown
# Dockerfile
|
||
|
||
## 格式
|
||
|
||
Dockerfile 中，对于指令不区分大小写，但是推荐使用大写，来区别于参数。
|
||
|
||
Dockerfile 中，将按照指令（instruction）出现次序依次执行。**注意：Dockerfile 必须从 `FROM` 指令开始。**
|
||
|
||
Dockerfile 中，将 `#` 开头的行作为注释，除非该行是有效的解析指令（parser directives）。一行中的 `#` 标记被视为参数。注释中不支持换行符。
|
||
|
||
示例：
|
||
|
||
```
|
||
# Comment
|
||
RUN echo 'we are running some # of cool things'
|
||
```
|
||
|
||
## 解析指令（parser directives）
|
||
|
||
解析指令是可选的，并且会影响 Dockerfile 中后续行的处理方式。解析指令不会将图层添加到构建中，并且不会显示为构建步骤。解析指令以 `# directive=value` 的形式写入特殊类型的注释。单个指令只能使用一次。
|
||
|
||
一旦注释，空行或构建指令已被处理，Docker 不再查找解析指令。相反，它将任何符合解析指令格式的内容视为注释，不会尝试验证它是否可能是解析指令。因此，所有解析指令都必须位于Dockerfile 的最顶端。
|
||
|
||
解析指令不区分大小写。但是，约定是小写。约定还包括在任何解析指令之后的空白行。解析指令不支持续行符。
|
||
|
||
以下列举几个不合规范的示例。
|
||
|
||
因为续行符而无效：
|
||
|
||
```
|
||
# direc \
|
||
tive=value
|
||
```
|
||
|
||
因为出现两次解析指令而无效：
|
||
|
||
```
|
||
# directive=value1
|
||
# directive=value2
|
||
|
||
FROM ImageName
|
||
```
|
||
|
||
解析指令由于出现在构建指令后，而被视为注释：
|
||
|
||
```
|
||
FROM ImageName
|
||
# directive=value
|
||
```
|
||
|
||
解析指令由于出现在注释后，而被视为注释：
|
||
|
||
```
|
||
# About my dockerfile
|
||
# directive=value
|
||
FROM ImageName
|
||
```
|
||
|
||
因为无法识别，未知的指令被视为注释。此外，因为前一个未知指定被视为注释，后一个指令相当于出现在注释后，而也被视为了注释：
|
||
|
||
```
|
||
# unknowndirective=value
|
||
# knowndirective=value
|
||
```
|
||
|
||
解析器指令中允许使用非分行空白。因此，以下几行都是一致对待的：
|
||
|
||
```
|
||
#directive=value
|
||
# directive =value
|
||
# directive= value
|
||
# directive = value
|
||
# dIrEcTiVe=value
|
||
```
|
||
|
||
### escape
|
||
|
||
```
|
||
# escape=\ (backslash)
|
||
```
|
||
|
||
```
|
||
# escape=` (backtick)
|
||
```
|
||
|
||
在 Dockerfile 中， |