@@ -59,24 +59,34 @@ options:
5959 experimentalcli : false
6060 kubernetes : false
6161 swarm : false
62+ - option : list
63+ value_type : string
64+ description : List targets or variables
65+ details_url : ' #list'
66+ deprecated : false
67+ hidden : false
68+ experimental : false
69+ experimentalcli : false
70+ kubernetes : false
71+ swarm : false
6272 - option : list-targets
6373 value_type : bool
6474 default_value : " false"
6575 description : List available targets
66- deprecated : false
76+ deprecated : true
6777 hidden : true
6878 experimental : false
69- experimentalcli : true
79+ experimentalcli : false
7080 kubernetes : false
7181 swarm : false
7282 - option : list-variables
7383 value_type : bool
7484 default_value : " false"
7585 description : List defined variables
76- deprecated : false
86+ deprecated : true
7787 hidden : true
7888 experimental : false
79- experimentalcli : true
89+ experimentalcli : false
8090 kubernetes : false
8191 swarm : false
8292 - option : load
@@ -125,7 +135,7 @@ options:
125135 value_type : string
126136 default_value : auto
127137 description : |
128- Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use plain to show container output
138+ Set type of progress output (`auto`, `quiet`, ` plain`, `tty`, `rawjson`). Use plain to show container output
129139 details_url : ' #progress'
130140 deprecated : false
131141 hidden : false
@@ -259,6 +269,42 @@ examples: |-
259269 See the [Bake file reference](/build/bake/reference/)
260270 for more details.
261271
272+ ### List targets and variables (--list) {#list}
273+
274+ The `--list` flag displays all available targets or variables in the Bake
275+ configuration, along with a description (if set using the `description`
276+ property in the Bake file).
277+
278+ To list all targets:
279+
280+ ```console {title="List targets"}
281+ $ docker buildx bake --list=targets
282+ TARGET DESCRIPTION
283+ binaries
284+ default binaries
285+ update-docs
286+ validate
287+ validate-golangci Validate .golangci.yml schema (does not run Go linter)
288+ ```
289+
290+ To list variables:
291+
292+ ```console
293+ $ docker buildx bake --list=variables
294+ VARIABLE VALUE DESCRIPTION
295+ REGISTRY docker.io/username Registry and namespace
296+ IMAGE_NAME my-app Image name
297+ GO_VERSION <null>
298+ ```
299+
300+ By default, the output of `docker buildx bake --list` is presented in a table
301+ format. Alternatively, you can use a long-form CSV syntax and specify a
302+ `format` attribute to output the list in JSON.
303+
304+ ```console
305+ $ docker buildx bake --list=type=targets,format=json
306+ ```
307+
262308 ### Write build results metadata to a file (--metadata-file) {#metadata-file}
263309
264310 Similar to [`buildx build --metadata-file`](/reference/cli/docker/buildx/build/#metadata-file) but
0 commit comments