From 271243d382edd02ca26768ca286b003a979e1b22 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Tue, 4 Oct 2022 18:58:18 +0200 Subject: [PATCH] docs: swagger: update description for default builder version Commit 7b153b9e28b53779215de209736310f9266b3f2f updated the main swagger file, but didn't update the v1.42 version used for the documentation as it wasn't created yet at the time. Signed-off-by: Sebastiaan van Stijn --- docs/api/v1.42.yaml | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/api/v1.42.yaml b/docs/api/v1.42.yaml index a0957ca7d4..4ae17c3251 100644 --- a/docs/api/v1.42.yaml +++ b/docs/api/v1.42.yaml @@ -8786,7 +8786,17 @@ paths: description: "Max API Version the server supports" Builder-Version: type: "string" - description: "Default version of docker image builder" + description: | + Default version of docker image builder + + The default on Linux is version "2" (BuildKit), but the daemon + can be configured to recommend version "1" (classic Builder). + Windows does not yet support BuildKit for native Windows images, + and uses "1" (classic builder) as a default. + + This value is a recommendation as advertised by the daemon, and + it is up to the client to choose which builder to use. + default: "2" Docker-Experimental: type: "boolean" description: "If the server is running with experimental mode enabled"