mirror of https://github.com/docker/docs.git
100 lines
1.9 KiB
Markdown
100 lines
1.9 KiB
Markdown
---
|
|
description: CLI and log output formatting reference
|
|
keywords: format, formatting, output, templates, log
|
|
title: Format command and log output
|
|
redirect_from:
|
|
- /engine/admin/formatting/
|
|
---
|
|
|
|
Docker uses [Go templates](https://golang.org/pkg/text/template/) which you can
|
|
use to manipulate the output format of certain commands and log drivers.
|
|
|
|
Docker provides a set of basic functions to manipulate template elements.
|
|
All of these examples use the `docker inspect` command, but many other CLI
|
|
commands have a `--format` flag, and many of the CLI command references
|
|
include examples of customizing the output format.
|
|
|
|
## join
|
|
|
|
`join` concatenates a list of strings to create a single string.
|
|
It puts a separator between each element in the list.
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format '{{join .Args " , "}}' container
|
|
```
|
|
{% endraw %}
|
|
|
|
|
|
## json
|
|
|
|
`json` encodes an element as a json string.
|
|
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format '{{json .Mounts}}' container
|
|
```
|
|
{% endraw %}
|
|
|
|
## lower
|
|
|
|
`lower` transforms a string into its lowercase representation.
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format "{{lower .Name}}" container
|
|
```
|
|
{% endraw %}
|
|
|
|
## split
|
|
|
|
`split` slices a string into a list of strings separated by a separator.
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format '{{split .Image ":"}}'
|
|
```
|
|
{% endraw %}
|
|
|
|
## title
|
|
|
|
`title` capitalizes the first character of a string.
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format "{{title .Name}}" container
|
|
```
|
|
{% endraw %}
|
|
|
|
## upper
|
|
|
|
`upper` transforms a string into its uppercase representation.
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format "{{upper .Name}}" container
|
|
```
|
|
{% endraw %}
|
|
|
|
|
|
## println
|
|
|
|
`println` prints each value on a new line.
|
|
|
|
{% raw %}
|
|
```
|
|
docker inspect --format='{{range .NetworkSettings.Networks}}{{println .IPAddress}}{{end}}' container
|
|
```
|
|
{% endraw %}
|
|
|
|
# Hint
|
|
|
|
To find out what data can be printed, show all content as json:
|
|
|
|
{% raw %}
|
|
```
|
|
docker container ls --format='{{json .}}'
|
|
```
|
|
{% endraw %}
|