瀏覽代碼

image/spec: add missing "ArgsEscaped" field (v1.1, v1.2)

This field was added in 9db5db1b94bc1000d151315851096dcc6cd3512d, which
was part of v1.10.0-rc1 and later, which used image spec v1.1.0.

It's worth noting that documentation for the v1.1.0 image spec was not
yet available until commit 4fa0eccd10c5c120fe1f641285db920cf643dbe8,
which was included in v1.12.0-rc1 and up. The `ArgsEscaped` field was
also adopted by the OCI image spec since [v1.1.0-rc3][1], but considered
deprecated, and not recommended to be used.

This patch amends the v1.1 and v1.2 specifications to describe the field.

[1]: https://github.com/opencontainers/image-spec/commit/59780aa56914ae9cf4ca68c10989d3f89337d1e0

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Sebastiaan van Stijn 1 年之前
父節點
當前提交
5380f3f0c4
共有 2 個文件被更改,包括 24 次插入0 次删除
  1. 12 0
      image/spec/v1.1.md
  2. 12 0
      image/spec/v1.2.md

+ 12 - 0
image/spec/v1.1.md

@@ -326,6 +326,18 @@ whitespace. It has been added to this example for clarity.
                 not specified, then the first entry of the <code>Cmd</code>
                 array should be interpreted as the executable to run.
             </dd>
+            <dt>
+                ArgsEscaped <code>boolean</code>
+            </dt>
+            <dd>
+                Used for Windows images to indicate that the <code>Entrypoint</code>
+                or <code>Cmd</code> or both, contain only a single element array
+                that is a pre-escaped, and combined into a single string, **CommandLine**.
+                If "true", the value in <code>Entrypoint</code> or <code>Cmd</code>Cmd
+                should be used as-is to avoid double escaping.
+                Note, the exact behavior of <code>ArgsEscaped</code> is complex
+                and subject to implementation details.
+            </dd>
             <dt>
                 Volumes <code>struct</code>
             </dt>

+ 12 - 0
image/spec/v1.2.md

@@ -326,6 +326,18 @@ whitespace. It has been added to this example for clarity.
                 not specified, then the first entry of the <code>Cmd</code>
                 array should be interpreted as the executable to run.
             </dd>
+            <dt>
+                ArgsEscaped <code>boolean</code>
+            </dt>
+            <dd>
+                Used for Windows images to indicate that the <code>Entrypoint</code>
+                or <code>Cmd</code> or both, contain only a single element array
+                that is a pre-escaped, and combined into a single string, **CommandLine**.
+                If "true", the value in <code>Entrypoint</code> or <code>Cmd</code>Cmd
+                should be used as-is to avoid double escaping.
+                Note, the exact behavior of <code>ArgsEscaped</code> is complex
+                and subject to implementation details.
+            </dd>
             <dt>
                 Healthcheck <code>struct</code>
             </dt>