Skip to content

Commit 5f09ad8

Browse files
author
Gabriel Monroy
committed
update concepts post application object model changes
1 parent ca46506 commit 5f09ad8

1 file changed

Lines changed: 18 additions & 10 deletions

File tree

docs/gettingstarted/concepts.rst

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,24 +8,20 @@ Concepts
88
========
99

1010
Deis 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

1413
Formations
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

2319
Layers
2420
------
2521
:ref:`Layers <layer>` are homogeneous groups of :ref:`Nodes <node>` that
2622
perform 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

3026
Runtime Layers
3127
^^^^^^^^^^^^^^
@@ -39,6 +35,18 @@ Proxy layers expose the formation to the outside world.
3935
Nodes in a proxy layer use a `Chef Databag`_ to configure routing of
4036
inbound 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+
4250
Build, Release, Run
4351
-------------------
4452
Deis enforces strict separation between Build, Release and Run stages

0 commit comments

Comments
 (0)