1. LABEL
1.1. 指令
LABEL <key>=<value> <key>=<value> <key>=<value>
1.2. 描述
LABEL配置镜像的元数据标签。使用 LABEL 指定镜像元数据时,一条 LABEL 可以指定一或多条元数据,指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条 LABEL 指令指定,以免生成过多的中间镜像。
在配置 LABEL 时,若果对同一个 key 值配置多次value值,会以最后一次配置的值为实际生效值
使用多条 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配置方式
LABEL multi.label1="value1" multi.label2="value2" other="value3"
或
LABEL multi.label1="value1" \
multi.label2="value2" \
other="value3"
1.3. 示例
使用一条 LABEL 配置多对标签
# cat Dockerfile
FROM alpine
LABEL multi.label1="value1" \
multi.label2="value2" \
other="value3"
# docker build -t labeltest:v1 .
Sending build context to Docker daemon 2.048kB
Step 1/2 : FROM alpine
---> e7d92cdc71fe
Step 2/2 : LABEL multi.label1="value1" multi.label2="value2" other="value3"
---> Using cache
---> 72fe1475c124
Successfully built 72fe1475c124
Successfully tagged labeltest:v1
查看镜像配置的 LABEL
# docker inspect --format='\{\{.Config.Labels\}\}' labeltest:v1
map[multi.label2:value2 other:value3 multi.label1:value1]