Update daemon.json example to show that log-opts must be a string

log-opts are passed to logging-drivers as-is, so the daemon is not
aware what value-type each option takes.

For this reason, all options must be provided as a string, even if
they are used as numeric values by the logging driver.

For example, to pass the "max-file" option to the default (json-file)
logging driver, this value has to be passed as a string;

```json
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}
```

When passed as a _number_ (`"max-file": 3`), the daemon will invalidate
the configuration file, and fail to start;

    unable to configure the Docker daemon with file /etc/docker/daemon.json: json: cannot unmarshal number into Go value of type string

This patch adds an example to the daemon.json to show these  values
have to be passed as strings.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2018-11-21 13:26:08 +01:00
parent 422baf69f6
commit fd33e0d933
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
1 changed files with 7 additions and 2 deletions

View File

@ -1305,8 +1305,13 @@ This is a full example of the allowed configuration options on Linux:
"storage-opts": [], "storage-opts": [],
"labels": [], "labels": [],
"live-restore": true, "live-restore": true,
"log-driver": "", "log-driver": "json-file",
"log-opts": {}, "log-opts": {
"max-size": "10m",
"max-files":"5",
"labels": "somelabel",
"env": "os,customer"
},
"mtu": 0, "mtu": 0,
"pidfile": "", "pidfile": "",
"cluster-store": "", "cluster-store": "",