Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tally.wharflab.com/llms.txt

Use this file to discover all available pages before exploring further.

Using the global ARGs with default values should produce a valid build.
PropertyValue
SeverityError
CategoryCorrectness
DefaultEnabled

​
Description

An ARG used in an image reference should be valid when no build arguments are used. An image build should not require --build-arg to produce a valid build. If a global ARG has no default value and is interpolated into a FROM instruction, the resulting image reference may be invalid when the argument is not supplied at build time.

​
Examples

Bad: 
ARG TAG
FROM busybox:${TAG}
Good: 
ARG TAG=latest
FROM busybox:${TAG}
Good (empty ARG is OK if image is valid with it empty): 
ARG VARIANT
FROM busybox:stable${VARIANT}
Good (default value syntax): 
ARG TAG
FROM alpine:${TAG:-3.14}

​
Reference