標籤說明

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."

影象可以有多個標籤。要指定多個標籤,Docker 建議儘可能將標籤組合到單個 LABEL 指令中。每個 LABEL 指令都會生成一個新圖層,如果使用多個標籤,則會導致影象效率低下。此示例生成單個影象層。

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

以上也可以寫成:

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

標籤是新增劑,包括 FROMs 中的 LABELs。如果 Docker 遇到已存在的標籤/金鑰,則新值將覆蓋具有相同金鑰的任何先前標籤。

要檢視影象的標籤,請使用 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"
},