Dockerfile参考(9) – LABEL添加元数据到镜像

格式：

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

LABEL指令添加元数据到一个镜像。一个LABEL是一个键值对。要在LABEL值中包含空格，使用双引号和反斜杠，就像在命令行解析中一样。一些可用的示例：

1. LABEL "com.example.vendor"="ACME Incorporated"
2. LABEL com.example.label-with-value="foo"
3. LABEL version="1.0"
4. LABEL description="This text illustrates \
5. that label-values can span multiple lines."

一个镜像可以有多个label。要指定多个labels，Docker推荐尽可能地把多个labels合并到一个LABEL指令中去。每一个LABEL指令会生成一个新的镜像层，如果你使用多个label，将导致构建出一个低效的镜像。这个示例只生成单个镜像层。

1. LABEL multi.label1="value1" multi.label2="value2" other="value3"

上面的示例可以重写为：

1. LABEL multi.label1="value1" \
2.       multi.label2="value2" \
3.       other="value3"

label是累积的，包括FROM镜像的lable。如果Docker遇到一个label/key已经存在，那么新的值将覆盖这个label/key。
要查看一个镜像的label，使用docker inspect命令。

1. "Labels": {
2.     "com.example.vendor": "ACME Incorporated"
3.     "com.example.label-with-value": "foo",
4.     "version": "1.0",
5.     "description": "This text illustrates that label-values can span multiple lines.",
6.     "multi.label1": "value1",
7.     "multi.label2": "value2",
8.     "other": "value3"
9. },