From dfe6ee6cd19f5f4af5884d290d5689ee98dd24ae Mon Sep 17 00:00:00 2001 From: Victoria Bialas Date: Mon, 6 Nov 2017 16:15:52 -0800 Subject: [PATCH] updated include file to use code fences (#5229) Signed-off-by: Victoria Bialas --- _includes/content/compose-extfields-sub.md | 68 ++++++++++++---------- 1 file changed, 38 insertions(+), 30 deletions(-) diff --git a/_includes/content/compose-extfields-sub.md b/_includes/content/compose-extfields-sub.md index 1ae9d17f8b..e96c6c551f 100644 --- a/_includes/content/compose-extfields-sub.md +++ b/_includes/content/compose-extfields-sub.md @@ -2,28 +2,33 @@ 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. - version: '2.1' - x-custom: - items: - - a - - b - options: - max-size: '12m' - name: "custom" +```none +version: '2.1' +x-custom: + items: + - a + - b + options: + max-size: '12m' + name: "custom" +``` The contents of those fields will be 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: - logging: - options: - max-size: '12m' - max-file: 5 - driver: json-file +```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 @@ -39,25 +44,28 @@ services: 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: - version: '2.1' - x-volumes: - &default-volume - driver: foobar-storage +```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 +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 +```