InvalidDefinitionDescription

注意
此检查是实验性的，默认情况下未启用。要启用它，请参阅实验性检查。

输出

Comment for build stage or argument should follow the format: `# <arg/stage name> <description>`. If this is not intended to be a description comment, add an empty line or comment between the instruction and the comment.

描述

这--call=outline和--call=targetsflags 的docker build命令打印生成目标和参数的描述。这些描述是根据紧接在FROM或ARG指令，并且以生成阶段或参数的名称开头。例如：

# build-cli builds the CLI binary
FROM alpine AS build-cli
# VERSION controls the version of the program
ARG VERSION=1

在前面的注释不是描述的情况下，在指令和前面的注释之间添加空行或注释。

例子

❌ Bad：对FROM命令。

# a non-descriptive comment
FROM scratch AS base

# another non-descriptive comment
ARG VERSION=1

✅ Good：分隔非描述性注释的空行。

# a non-descriptive comment

FROM scratch AS base

# another non-descriptive comment

ARG VERSION=1

✅ Good：描述ARG键和阶段立即执行命令。

# base is a stage for compiling source
FROM scratch AS base
# VERSION This is the version number.
ARG VERSION=1