010-Dockerfile-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(標籤)。你可以在一行中指定多個標籤。在 Docker 1.10 之前，這減小了最終鏡像的大小，但現在不再是這樣情況了。你仍然可以選擇在單個指令中指定多個標籤，方法有以下兩種:

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

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

基本或父鏡像中包含的標籤(FROM 行中的鏡像)由鏡像繼承。如果標籤已存在但具有不同的值，則最近應用的值將覆蓋任何先前設置的值。
要查看鏡像的標籤，請使用 docker inspect 命令。