From c48b67160df2e872e711fa01d593657c7757ea62 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Gronowski?= Date: Thu, 1 Feb 2024 17:00:03 +0100 Subject: [PATCH] api: Document `version` in `/build` MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit It was introduced in API v1.38 but wasn't documented. Signed-off-by: Paweł Gronowski (cherry picked from commit 0c3b8ccda7fd71a9d90b29848dce4a2010bced7e) Signed-off-by: Paweł Gronowski --- api/swagger.yaml | 10 ++++++++++ docs/api/v1.38.yaml | 10 ++++++++++ docs/api/v1.39.yaml | 10 ++++++++++ docs/api/v1.40.yaml | 10 ++++++++++ docs/api/v1.41.yaml | 10 ++++++++++ docs/api/v1.42.yaml | 10 ++++++++++ docs/api/v1.43.yaml | 10 ++++++++++ docs/api/v1.44.yaml | 10 ++++++++++ 8 files changed, 80 insertions(+) diff --git a/api/swagger.yaml b/api/swagger.yaml index 567939580b485..e55a76fc63c38 100644 --- a/api/swagger.yaml +++ b/api/swagger.yaml @@ -8327,6 +8327,16 @@ paths: description: "BuildKit output configuration" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index 162c7a9194819..30437fc9e841a 100644 --- a/docs/api/v1.38.yaml +++ b/docs/api/v1.38.yaml @@ -6356,6 +6356,16 @@ paths: description: "Target build stage" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index a97eef76ec5de..d96f49aa9a799 100644 --- a/docs/api/v1.39.yaml +++ b/docs/api/v1.39.yaml @@ -7390,6 +7390,16 @@ paths: description: "Target build stage" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index 1121c53e7c8d8..db941116b01b7 100644 --- a/docs/api/v1.40.yaml +++ b/docs/api/v1.40.yaml @@ -7701,6 +7701,16 @@ paths: description: "BuildKit output configuration" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index 94071a2d69430..6ae195554cea2 100644 --- a/docs/api/v1.41.yaml +++ b/docs/api/v1.41.yaml @@ -7906,6 +7906,16 @@ paths: description: "BuildKit output configuration" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index 1af14130c0012..f20c9b40c5d2f 100644 --- a/docs/api/v1.42.yaml +++ b/docs/api/v1.42.yaml @@ -8156,6 +8156,16 @@ paths: description: "BuildKit output configuration" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index 7ddb88e5f02f6..ff1e458ed95be 100644 --- a/docs/api/v1.43.yaml +++ b/docs/api/v1.43.yaml @@ -8174,6 +8174,16 @@ paths: description: "BuildKit output configuration" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) 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 index 567939580b485..e55a76fc63c38 100644 --- a/docs/api/v1.44.yaml +++ b/docs/api/v1.44.yaml @@ -8327,6 +8327,16 @@ paths: description: "BuildKit output configuration" type: "string" default: "" + - name: "version" + in: "query" + type: "string" + default: "1" + enum: ["1", "2"] + description: | + Version of the builder backend to use. + + - `1` is the first generation classic (deprecated) builder in the Docker daemon (default) + - `2` is [BuildKit](https://github.com/moby/buildkit) responses: 200: description: "no error"