@@ -56,8 +56,7 @@ An image extension could be defined with the following directory:
56
56
* ` ./bin/detect ` is invoked during the ` detect ` phase. It analyzes application source code to determine if the extension
57
57
is needed and contributes build plan entries.
58
58
* ` ./bin/generate ` is invoked during the ` generate ` phase (a new lifecycle phase that happens after ` detect ` ). It
59
- outputs either or both of ` build.Dockerfile ` or ` run.Dockerfile ` for extending the builder or run image,
60
- respectively (in the [ initial implementation] ( #phased-approach ) , only limited ` run.Dockerfile ` s are allowed).
59
+ outputs either or both of ` build.Dockerfile ` or ` run.Dockerfile ` for extending the builder or run image.
61
60
62
61
For more information and to see a build in action,
63
62
see [ authoring an image extension] ( /docs/extension-guide/create-extension ) .
@@ -78,30 +77,9 @@ should be **used with great care**. Platform operators should be mindful that:
78
77
may not have all the mixins required by buildpacks that detected. Platforms may wish to optionally re-validate mixins
79
78
prior to ` build ` when using extensions.
80
79
81
- ### Phased approach
80
+ ### Putting it all together
82
81
83
- Some limitations of the initial implementation of the Dockerfiles feature have already been mentioned, and we'll expand
84
- on them here. As this is a large and complicated feature, the implementation has been split into phases in order to
85
- deliver incremental value and gather feedback.
86
-
87
- #### Phase 1 (supported in lifecycle ` 0.15.0 ` or greater)
88
-
89
- One or more ` run.Dockerfile ` s each containing a single ` FROM ` instruction can be used to switch the original run image
90
- to a new image (as no image modifications are permitted, there is no need to run ` extend ` on the run image)
91
-
92
- #### Phase 2 (supported in lifecycle ` 0.15.0 ` or greater)
93
-
94
- One or more ` build.Dockerfile ` s can be used to extend the builder image
95
-
96
- * A new ` extend ` lifecycle phase is introduced to apply ` build.Dockerfile ` s from ` generate ` to the builder image
97
-
98
- #### Phase 3 (future)
99
-
100
- One or more ` run.Dockerfile ` s can be used to extend the run image
101
-
102
- * The ` extend ` lifecycle phase can be run in parallel for the builder and run images
103
-
104
- The final ordering of lifecycle phases will look something like the following:
82
+ The ordering of lifecycle phases looks like the following:
105
83
106
84
* ` analyze `
107
85
* ` detect ` - after standard detection, ` detect ` will also run extensions' ` ./bin/generate ` ; output Dockerfiles are
@@ -116,9 +94,9 @@ For more information, consult the [migration guide](/docs/reference/spec/migrati
116
94
117
95
#### Platform support for Dockerfiles
118
96
119
- Supported (phases 1 and 2) :
97
+ Supported:
120
98
121
- * [ pack cli] ( https://github.com/buildpacks/pack ) (version ` 0.28 .0 ` and above)
99
+ * [ pack cli] ( https://github.com/buildpacks/pack ) (prefer version ` 0.30 .0 ` and above)
122
100
123
101
Needs support:
124
102
0 commit comments