@@ -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