格式:
- LABEL <key>=<value> <key>=<value> <key>=<value> ...
LABEL指令添加元数据到一个镜像。一个LABEL是一个键值对。要在LABEL值中包含空格,使用双引号和反斜杠,就像在命令行解析中一样。一些可用的示例:
- LABEL "com.example.vendor"="ACME Incorporated"
- LABEL com.example.label-with-value="foo"
- LABEL
- LABEL
一个镜像可以有多个label。要指定多个labels,Docker推荐尽可能地把多个labels合并到一个LABEL指令中去。每一个LABEL指令会生成一个新的镜像层,如果你使用多个label,将导致构建出一个低效的镜像。这个示例只生成单个镜像层。
- LABEL multi.label1="value1" multi.label2="value2"
上面的示例可以重写为:
- LABEL multi.label1="value1" \
- multi.label2="value2" \
-
label是累积的,包括FROM镜像的lable。如果Docker遇到一个label/key已经存在,那么新的值将覆盖这个label/key。
要查看一个镜像的label,使用docker inspect命令。
- "Labels": {
- "com.example.vendor": "ACME Incorporated"
- "com.example.label-with-value": "foo",
- "version": "1.0",
- "description": "This text illustrates that label-values can span multiple lines.",
- "multi.label1": "value1",
- "multi.label2": "value2",
- "other": "value3"
- },