diff --git a/README.md b/README.md index 5cf3e340..e838b018 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ Table of Contents - [Runtime and Lifecycle](runtime.md) - [Linux Specific Runtime](runtime-linux.md) - [Implementations](implementations.md) +- [Glossary](glossary.md) In the specifications in the above table of contents, the keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as described in [RFC 2119](http://tools.ietf.org/html/rfc2119) (Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997). diff --git a/glossary.md b/glossary.md new file mode 100644 index 00000000..00075621 --- /dev/null +++ b/glossary.md @@ -0,0 +1,26 @@ +# Glossary + +## Bundle + +A [directory structure](bundle.md) that is written ahead of time, distributed, and used to seed the runtime for creating a [container](#container) and launching a process within it. + +## Configuration + +The [`config.json`](config.md) and [`runtime.json`](runtime-config.md) files in a [bundle](#bundle) which define the intended [container](#container) and container process. + +## Container + +An environment for executing processes with configurable isolation and resource limitations. +For example, namespaces, resource limits, and mounts are all part of the container environment. + +## JSON + +All configuration [JSON][] MUST be encoded in [UTF-8][]. + +## Runtime + +An implementation of this specification. +It reads the [configuration files](#configuration) from a [bundle](#bundle), uses that information to create a [container](#container), launches a process inside the container, and performs other [lifecycle actions](runtime.md). + +[JSON]: http://json.org/ +[UTF-8]: http://www.unicode.org/versions/Unicode8.0.0/ch03.pdf