As discussed on the maintainers mailinglist,
and during a maintainers review session;
We've recently made changes to the Dockerfile
syntax (e.g., `HEALTHCHECK`, `SHELL`), so
mentioning the Dockerfile syntax as a frozen
feature is no longer accurate.
Removing it from frozen features does NOT
automatically state an intent to make big
changes to the syntax; making changes
to the syntax are important decisions and
should never be taken lightly.
This change is just to indicate that we
can *accept* changes if they are meaningful,
and we're confident they can be made.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
| ... | ... |
@@ -93,28 +93,7 @@ to another node in the cluster. This will be introduced in a backward compatible |
| 93 | 93 |
We won't accept patches expanding the surface of `docker exec`, which we intend to keep as a |
| 94 | 94 |
*debugging* feature, as well as being strongly dependent on the Runtime ingredient effort. |
| 95 | 95 |
|
| 96 |
-## 2.2 Dockerfile syntax |
|
| 97 |
- |
|
| 98 |
-The Dockerfile syntax as we know it is simple, and has proven successful in supporting all our |
|
| 99 |
-[official images](https://github.com/docker-library/official-images). Although this is *not* a |
|
| 100 |
-definitive move, we temporarily won't accept more patches to the Dockerfile syntax for several |
|
| 101 |
-reasons: |
|
| 102 |
- |
|
| 103 |
- - Long term impact of syntax changes is a sensitive matter that require an amount of attention the |
|
| 104 |
- volume of Engine codebase and activity today doesn't allow us to provide. |
|
| 105 |
- - Allowing the Builder to be implemented as a separate utility consuming the Engine's API will |
|
| 106 |
- open the door for many possibilities, such as offering alternate syntaxes or DSL for existing |
|
| 107 |
- languages without cluttering the Engine's codebase. |
|
| 108 |
- - A standalone Builder will also offer the opportunity for a better dedicated group of maintainers |
|
| 109 |
- to own the Dockerfile syntax and decide collectively on the direction to give it. |
|
| 110 |
- - Our experience with official images tend to show that no new instruction or syntax expansion is |
|
| 111 |
- *strictly* necessary for the majority of use cases, and although we are aware many things are |
|
| 112 |
- still lacking for many, we cannot make it a priority yet for the above reasons. |
|
| 113 |
- |
|
| 114 |
-Again, this is not about saying that the Dockerfile syntax is done, it's about making choices about |
|
| 115 |
-what we want to do first! |
|
| 116 |
- |
|
| 117 |
-## 2.3 Remote Registry Operations |
|
| 96 |
+## 2.2 Remote Registry Operations |
|
| 118 | 97 |
|
| 119 | 98 |
A large amount of work is ongoing in the area of image distribution and provenance. This includes |
| 120 | 99 |
moving to the V2 Registry API and heavily refactoring the code that powers these features. The |