api: Document version in /build

It was introduced in API v1.38 but wasn't documented. Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com> (cherry picked from commit 717f617) Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
moby · Jan 31, 2024 · 1d2a6c5 · 1d2a6c5
1 parent 667bc3f
commit 1d2a6c5
Show file tree

Hide file tree

Showing 8 changed files with 72 additions and 0 deletions.
diff --git a/api/swagger.yaml b/api/swagger.yaml
@@ -8327,6 +8327,15 @@ paths:
           description: "BuildKit output configuration"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.38.yaml b/docs/api/v1.38.yaml
@@ -6356,6 +6356,15 @@ paths:
           description: "Target build stage"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.39.yaml b/docs/api/v1.39.yaml
@@ -7390,6 +7390,15 @@ paths:
           description: "Target build stage"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.40.yaml b/docs/api/v1.40.yaml
@@ -7701,6 +7701,15 @@ paths:
           description: "BuildKit output configuration"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.41.yaml b/docs/api/v1.41.yaml
@@ -7906,6 +7906,15 @@ paths:
           description: "BuildKit output configuration"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.42.yaml b/docs/api/v1.42.yaml
@@ -8156,6 +8156,15 @@ paths:
           description: "BuildKit output configuration"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.43.yaml b/docs/api/v1.43.yaml
@@ -8174,6 +8174,15 @@ paths:
           description: "BuildKit output configuration"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"

diff --git a/docs/api/v1.44.yaml b/docs/api/v1.44.yaml
@@ -8327,6 +8327,15 @@ paths:
           description: "BuildKit output configuration"
           type: "string"
           default: ""
+        - name: "version"
+          in: "query"
+          type: "string"
+          default: "1"
+          description: |
+            Version of the builder backend to use.
+
+            - `1` is the first generation classic builder in the Docker daemon (default)
+            - `2` is [BuildKit](https://github.com/moby/buildkit)
       responses:
         200:
           description: "no error"