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

格式：

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

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

LABEL "com.example.vendor"="ACME Incorporated"

LABEL com.example.label-with-value="foo"

LABEL version="1.0"

LABEL description="This text illustrates \

that label-values can span multiple lines."

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

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

上面的示例可以重写为：

LABEL multi.label1="value1" \

      multi.label2="value2" \

      other="value3"

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"

},