Skip to content

Commit

Permalink
Add text about extensions
Browse files Browse the repository at this point in the history
Mimic opencontainers/image-spec#164
and they should be kept in-sync

Signed-off-by: Doug Davis <dug@us.ibm.com>
  • Loading branch information
Doug Davis committed Jun 26, 2016
1 parent b45aa77 commit 1f2a4e3
Showing 1 changed file with 8 additions and 1 deletion.
9 changes: 8 additions & 1 deletion config.md
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,10 @@ The semantics are the same as `Path`, `Args` and `Env` in [golang Cmd](https://g

This OPTIONAL property contains arbitrary metadata for the container.
This information MAY be structured or unstructured.
Annotations are key-value maps.
Annotations MUST be key-value maps.
Keys MUST be unique, and best practice is to namespace the keys.
If there are no annotations then this property MAY either be absent or an empty map.
Implementations that are reading/processing this configuration file MUST NOT generate an error if they encounter an unknown annotation key.

```json
"annotations": {
Expand All @@ -317,6 +320,10 @@ Annotations are key-value maps.
}
```

## Extensibility
The `annotations` property MAY be used as an extensibility point to include additional information that is not defined as part of this specification.
Excluding the `annotations` property, implementations that are reading/processing this configuration file MUST generate an error if they encounter an unkown property.

## Configuration Schema Example

Here is a full example `config.json` for reference.
Expand Down

0 comments on commit 1f2a4e3

Please sign in to comment.