mirror of
https://github.com/docker/docs.git
synced 2026-03-31 08:18:55 +07:00
a4f5e30249
* Reword lots of instances of 'will' * Reword lots of instances of won't * Reword lots of instances of we'll * Eradicate you'll * Eradicate 'be able to' type of phrases * Eradicate 'unable to' type of phrases * Eradicate 'has / have to' type of phrases * Eradicate 'note that' type of phrases * Eradicate 'in order to' type of phrases * Redirect to official Chef and Puppet docs * Eradicate gratuitous 'please' * Reduce use of e.g. * Reduce use of i.e. * Reduce use of N.B. * Get rid of 'sexagesimal' and correct some errors
72 lines
1.4 KiB
Markdown
72 lines
1.4 KiB
Markdown
It is possible to re-use configuration fragments using extension fields. Those
|
|
special fields can be of any format as long as they are located at the root of
|
|
your Compose file and their name start with the `x-` character sequence.
|
|
|
|
```none
|
|
version: '2.1'
|
|
x-custom:
|
|
items:
|
|
- a
|
|
- b
|
|
options:
|
|
max-size: '12m'
|
|
name: "custom"
|
|
```
|
|
|
|
The contents of those fields are ignored by Compose, but they can be
|
|
inserted in your resource definitions using [YAML anchors](http://www.yaml.org/spec/1.2/spec.html#id2765878).
|
|
For example, if you want several of your services to use the same logging
|
|
configuration:
|
|
|
|
```none
|
|
logging:
|
|
options:
|
|
max-size: '12m'
|
|
max-file: '5'
|
|
driver: json-file
|
|
```
|
|
|
|
You may write your Compose file as follows:
|
|
|
|
```none
|
|
version: '2.1'
|
|
x-logging:
|
|
&default-logging
|
|
options:
|
|
max-size: '12m'
|
|
max-file: '5'
|
|
driver: json-file
|
|
|
|
services:
|
|
web:
|
|
image: myapp/web:latest
|
|
logging: *default-logging
|
|
db:
|
|
image: mysql:latest
|
|
logging: *default-logging
|
|
```
|
|
|
|
It is also possible to partially override values in extension fields using
|
|
the [YAML merge type](http://yaml.org/type/merge.html). For example:
|
|
|
|
```none
|
|
version: '2.1'
|
|
x-volumes:
|
|
&default-volume
|
|
driver: foobar-storage
|
|
|
|
services:
|
|
web:
|
|
image: myapp/web:latest
|
|
volumes: ["vol1", "vol2", "vol3"]
|
|
volumes:
|
|
vol1: *default-volume
|
|
vol2:
|
|
<< : *default-volume
|
|
name: volume02
|
|
vol3:
|
|
<< : *default-volume
|
|
driver: default
|
|
name: volume-local
|
|
```
|