@@ -8,24 +8,20 @@ Concepts
88========
99
1010Deis is an application platform that deploys and scales `Twelve Factor `_ apps
11- using a formation of `Chef `_ nodes, `Docker `_ containers and
12- `Nginx `_ proxies.
11+ using a formation of `Chef `_ nodes, `Docker `_ containers and `Nginx `_ proxies.
1312
1413Formations
1514----------
16- A :ref: `formation ` is a set of infrastructure used to host a single application
17- or service backed by a single git repository. Each formation includes
18- :ref: `Layers <layer >` of :ref: `Nodes <node >` used to host services, a set of
19- :ref: `Containers <container >` used to run isolated processes, and a
20- :ref: `Release ` that defines the current :ref: `Build ` and :ref: `config `
21- deployed by containers.
15+ A :ref: `formation ` is a set of infrastructure used to host applications.
16+ Each formation includes :ref: `Layers <layer >` of :ref: `Nodes <node >`
17+ that provide different services to the formation.
2218
2319Layers
2420------
2521:ref: `Layers <layer >` are homogeneous groups of :ref: `Nodes <node >` that
2622perform work on behalf of a formation. Each node in a layer has
27- the same :ref: `Flavor ` and Chef configuration, allowing them to be scaled
28- easily. Formations have two types of layers.
23+ the same :ref: `Flavor ` and configuration, allowing them to be scaled
24+ easily. Formations have two primary types of layers.
2925
3026Runtime Layers
3127^^^^^^^^^^^^^^
@@ -39,6 +35,18 @@ Proxy layers expose the formation to the outside world.
3935Nodes in a proxy layer use a `Chef Databag `_ to configure routing of
4036inbound requests to :ref: `Containers <container >` hosted on runtime layers.
4137
38+ Applications
39+ ------------
40+
41+ An :ref: `application ` lives on a :ref: `formation ` where it services requests
42+ and runs background jobs for a deployed git repository. Each application includes
43+ :ref: `Containers <container >` used to run isolated processes, and a
44+ :ref: `Release ` that defines the current :ref: `Build ` and :ref: `config `
45+ deployed by containers.
46+
47+ Developers can use :ref: `Applications <application >` to push builds, change config
48+ and scale containers without worrying about the formation's underlying infrastructure.
49+
4250Build, Release, Run
4351-------------------
4452Deis enforces strict separation between Build, Release and Run stages
0 commit comments