Skip to content

Commit 4db0fe4

Browse files
author
Matthew Fisher
committed
docs(concepts): add back build/release/run docs
closes #740
1 parent d56f523 commit 4db0fe4

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

docs/gettingstarted/concepts.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,26 @@ regardless of the cluster's underlying infrastructure.
8383
Build, Release, Run
8484
-------------------
8585

86+
Build Stage
87+
^^^^^^^^^^^
88+
The :ref:`Controller` includes a *gitreceive* hook that receives incoming git push requests over
89+
SSH and builds applications inside ephemeral Docker containers. Tarballs of the /app directory are
90+
extracted into a slug and is injected into another container, which will create the app image. The
91+
image is then pushed to a private registry for later execution.
92+
93+
Release Stage
94+
^^^^^^^^^^^^^
95+
During the release stage, a :ref:`build` is combined with :ref:`config` to create a new numbered
96+
:ref:`release`. The release stage is triggered any time a new build is created or config is
97+
changed, making it easy to rollback code and configuration.
98+
99+
Run Stage
100+
^^^^^^^^^
101+
The run stage shells out jobs to the scheduler. The scheduler is in control of balancing the
102+
containers evenly across the cluster, as well as the announcers and the loggers for each
103+
application. The scheduler uses SSH to submit jobs to each node in the cluster and updates
104+
the proxy component between releases, making zero downtime deployments possible.
105+
86106
.. _concepts_backing_services:
87107

88108
Backing Services

0 commit comments

Comments
 (0)