Skip to content

Commit a207d78

Browse files
committed
ref(concepts): update build stage
1 parent 264f1f3 commit a207d78

1 file changed

Lines changed: 19 additions & 2 deletions

File tree

src/understanding-deis/concepts.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,8 +64,23 @@ names, SSL Certificates and developer provided configuration.
6464

6565
### Build Stage
6666

67-
The [builder][] processes incoming `git push` requests and builds applications
68-
inside ephemeral Docker containers, resulting in a new Docker image.
67+
The [builder][] component processes incoming `git push deis master` requests
68+
manages your application packaging.
69+
70+
If your application is using a [buildpack][] builder will launch an ephemeral
71+
job to extract and execute the packaging instructions. The resulting
72+
application artifact is stored by the platform for execution during the run
73+
stage.
74+
75+
Instead, if you provide a [Dockerfile][dockerfile] builder will use the
76+
instructions you've provided to build a Docker Image. The resulting artifact is
77+
stored in a Deis-managed registry which will be referenced during the run
78+
stage.
79+
80+
If you already have an external system building your application container you
81+
can simply reference that artifact. When using [external Docker
82+
images][dockerimage] the builder component doesn't attempt to repackage your
83+
app.
6984

7085
### Release Stage
7186

@@ -109,6 +124,8 @@ to swap services provided by other apps, or to switch to external or third-party
109124
[cncf]: https://cncf.io/
110125
[components]: components.md
111126
[config]: ../reference-guide/terms.md#config
127+
[dockerfile]: ../using-deis/using-dockerfiles.md
128+
[dockerimage]: ../using-deis/using-docker-images.md
112129
[environment variables]: http://12factor.net/config
113130
[helm]: https://helm.sh
114131
[release]: ../reference-guide/terms.md#release

0 commit comments

Comments
 (0)