Skip to main content
Usage of undefined variable.
PropertyValue
SeverityWarning
CategoryCorrectness
DefaultEnabled

​
Description

This check ensures that environment variables and build arguments are correctly declared before being used. While undeclared variables might not cause an immediate build failure, they can lead to unexpected behavior. It also detects common mistakes like typos in variable names. This check does not evaluate undefined variables for RUN, CMD, and ENTRYPOINT instructions where you use the shell form, because when you use shell form, variables are resolved by the command shell.

​
Examples

Bad: 
FROM alpine AS base
COPY $foo .
Good: 
FROM alpine AS base
ARG foo
COPY $foo .
Bad (typo detection): 
FROM alpine
ENV PATH=$PAHT:/app/bin
Output: Usage of undefined variable '$PAHT' (did you mean $PATH?)

​
Supersedes

​
Reference