From 1afb53315b2eac443807543ab22f2979752eed7e Mon Sep 17 00:00:00 2001 From: Uros Date: Thu, 16 Jan 2025 23:34:33 -0500 Subject: [PATCH 01/12] fixing typo --- .../docker-concepts/running-containers/sharing-local-files.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/get-started/docker-concepts/running-containers/sharing-local-files.md b/content/get-started/docker-concepts/running-containers/sharing-local-files.md index d8dacb66fcc6..9600eba47231 100644 --- a/content/get-started/docker-concepts/running-containers/sharing-local-files.md +++ b/content/get-started/docker-concepts/running-containers/sharing-local-files.md @@ -101,7 +101,7 @@ Using a bind mount, you can map the configuration file on your host computer to $ mkdir public_html ``` -3. Change the directory to `public_html` and create a file called `index.html` with the following content. This is a basic HTML document that creates a simple webpage that welcomes you with a friendly whale. +3. Navigate into the newly created directory `public_html` and create a file called `index.html` with the following content. This is a basic HTML document that creates a simple webpage that welcomes you with a friendly whale. ```html From 88636ed07b47eec5fcbce91ab863d8b9d0471669 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Fri, 17 Jan 2025 09:28:04 +0100 Subject: [PATCH 02/12] deps: bump hugo version to v0.141.0 Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- Dockerfile | 2 +- hugo.yaml | 2 +- netlify.toml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Dockerfile b/Dockerfile index 963ac44db7d8..cfe29a65fbf6 100644 --- a/Dockerfile +++ b/Dockerfile @@ -4,7 +4,7 @@ ARG ALPINE_VERSION=3.21 ARG GO_VERSION=1.23 ARG HTMLTEST_VERSION=0.17.0 -ARG HUGO_VERSION=0.139.0 +ARG HUGO_VERSION=0.141.0 ARG NODE_VERSION=22 ARG PAGEFIND_VERSION=1.3.0 diff --git a/hugo.yaml b/hugo.yaml index 2d510b427c6f..36c6795f4666 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -261,7 +261,7 @@ module: proxy: https://proxy.golang.org,direct hugoVersion: extended: false - min: "0.139.0" + min: "0.141.0" mounts: # Mount the assets directory so it doesn't get overwritten - source: assets diff --git a/netlify.toml b/netlify.toml index fc2877542979..5fa86c689e7f 100644 --- a/netlify.toml +++ b/netlify.toml @@ -4,7 +4,7 @@ publish = "public" [context.deploy-preview.environment] NODE_VERSION = "22" NODE_ENV = "production" -HUGO_VERSION = "0.139.0" +HUGO_VERSION = "0.141.0" HUGO_ENABLEGITINFO = "true" HUGO_ENVIRONMENT = "preview" From 150f788ed2af744eb78b272cf3e88424707941d4 Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Fri, 17 Jan 2025 12:16:42 +0000 Subject: [PATCH 03/12] ENGDOCS-2379 (#21823) ## Description Kubernetes freshness. Only new new content is on Troubleshooting. Rest is expanded slightly/presented better. ## Related issues or tickets ## Reviews - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Sarah Sanders Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- _vale/config/vocabularies/Docker/accept.txt | 1 + .../manuals/desktop/features/kubernetes.md | 92 ++++++++++++------- 2 files changed, 62 insertions(+), 31 deletions(-) diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt index 1465660c6847..c07c79a1cd7f 100644 --- a/_vale/config/vocabularies/Docker/accept.txt +++ b/_vale/config/vocabularies/Docker/accept.txt @@ -154,6 +154,7 @@ Zsh [Vv]irtiofs [Vv]irtualize [Ww]alkthrough +bootup cgroup config containerd diff --git a/content/manuals/desktop/features/kubernetes.md b/content/manuals/desktop/features/kubernetes.md index 5742400aa031..7ad1a0415719 100644 --- a/content/manuals/desktop/features/kubernetes.md +++ b/content/manuals/desktop/features/kubernetes.md @@ -9,44 +9,57 @@ aliases: weight: 60 --- -Docker Desktop includes a standalone Kubernetes server and client, -as well as Docker CLI integration that runs on your machine. +Docker Desktop includes a standalone Kubernetes server and client, as well as Docker CLI integration, enabling local Kubernetes development and testing directly on your machine. -The Kubernetes server runs locally within your Docker instance, is not configurable, and is a single-node cluster. It runs within a Docker container on your local system, and -is only for local testing. +The Kubernetes server runs as a single-node cluster within a Docker container. This lightweight setup helps you explore Kubernetes features, test workloads, and work with container orchestration in parallel with other Docker functionalities. -Turning on Kubernetes allows you to deploy -your workloads in parallel, on Kubernetes, Swarm, and as standalone containers. Turning on or off the Kubernetes server does not affect your other -workloads. +Kubernetes on Docker Desktop runs alongside other workloads, including Swarm services and standalone containers. + +## What happens when I enable Kubernetes in Docker Desktop? + +When you enable Kubernetes in Docker Desktop, the following actions are triggered in the Docker Desktop backend and VM: + +- Generation of certificates and cluster configuration +- Download and installation of Kubernetes internal components +- Cluster bootup +- Installation of additional controllers for networking and storage + +Turning the Kubernetes server on or off in Docker Desktop does not affect your other workloads. ## Install and turn on Kubernetes -1. From the Docker Desktop Dashboard, select the **Settings**. -2. Select **Kubernetes** from the left sidebar. -3. Next to **Enable Kubernetes**, select the checkbox. -4. Select **Apply & Restart** to save the settings and then select **Install** to confirm. This instantiates images required to run the Kubernetes server as containers, and installs the `/usr/local/bin/kubectl` command on your machine. +1. Open the Docker Desktop Dashboard and navigate to **Settings**. +2. Select the **Kubernetes** tab. +3. Select the **Enable Kubernetes** checkbox. +4. Select **Apply & Restart** to save the settings and then select **Install** to confirm. This sets up the images required to run the Kubernetes server as containers, and installs the `kubectl` command-line tool on your system at `/usr/local/bin/kubectl` (Mac) or `C:\Program Files\Docker\Docker\Resources\bin\kubectl.exe` (Windows). - > [!IMPORTANT] + > [!NOTE] > - > The `kubectl` binary is not automatically packaged with Docker Desktop for Linux. To install the kubectl command for Linux, see [Kubernetes documentation](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/). It should be installed at `/usr/local/bin/kubectl`. + > Docker Desktop for Linux does not include `kubectl` by default. You can install it separately by following the [Kubernetes installation guide](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/). Ensure the `kubectl` binary is installed at `/usr/local/bin/kubectl`. -By default, Kubernetes containers are hidden from commands like `docker ps`, because managing them manually is not supported. Most users do not need this option. To see these internal containers, select **Show system containers (advanced)**. +When Kubernetes is enabled, its status is displayed in the Docker Desktop Dashboard footer and the Docker menu. -When Kubernetes is turned on and running, an additional status bar in the Docker Desktop Dashboard footer and Docker menu displays. +You can check which version of Kubernetes you're on with: -> [!NOTE] -> -> Docker Desktop does not upgrade your Kubernetes cluster automatically after a new update. To upgrade your Kubernetes cluster to the latest version, select **Reset Kubernetes Cluster**. +```console +$ kubectl version +``` + +### Viewing system containers + +By default, Kubernetes system containers are hidden. To inspect these containers, navigate to **Settings** > **Kubernetes** and then enable **Show system containers (advanced)**. -## Use the kubectl command +You can now view the running Kubernetes containers with `docker ps` or in the Docker Desktop Dashboard. -Kubernetes integration provides the Kubernetes CLI command +## Using the kubectl command + +Kubernetes integration automatically installs the Kubernetes CLI command at `/usr/local/bin/kubectl` on Mac and at `C:\Program Files\Docker\Docker\Resources\bin\kubectl.exe` on Windows. This location may not be in your shell's `PATH` variable, so you may need to type the full path of the command or add it to the `PATH`. If you have already installed `kubectl` and it is -pointing to some other environment, such as `minikube` or a GKE cluster, ensure you change the context so that `kubectl` is pointing to `docker-desktop`: +pointing to some other environment, such as `minikube` or a Google Kubernetes Engine cluster, ensure you change the context so that `kubectl` is pointing to `docker-desktop`: ```console $ kubectl config get-contexts @@ -55,29 +68,46 @@ $ kubectl config use-context docker-desktop > [!TIP] > -> Run the `kubectl` command in a CMD or PowerShell terminal, otherwise `kubectl config get-contexts` may return an empty result. -> -> If you are using a different terminal and this happens, you can try setting the `kubeconfig` environment variable to the location of the `.kube/config` file. +> If the `kubectl` config get-contexts command returns an empty result, try: +> +> - Running the command in the Command Prompt or PowerShell. +> - Setting the `KUBECONFIG` environment variable to point to your `.kube/config` file. -If you installed `kubectl` using Homebrew, or by some other method, and -experience conflicts, remove `/usr/local/bin/kubectl`. +### Verify installation -You can test the command by listing the available nodes: +To confirm that Kubernetes is running, list the available nodes: ```console $ kubectl get nodes - NAME STATUS ROLES AGE VERSION docker-desktop Ready control-plane 3h v1.29.1 ``` +If you installed `kubectl` using Homebrew, or by some other method, and +experience conflicts, remove `/usr/local/bin/kubectl`. + For more information about `kubectl`, see the [`kubectl` documentation](https://kubernetes.io/docs/reference/kubectl/overview/). +## Upgrade your cluster + +Kubernetes clusters are not automatically upgraded with Docker Desktop updates. To upgrade the cluster, you must manually select **Reset Kubernetes Cluster** in settings. + +## Troubleshooting + +- If Kubernetes fails to start, make sure Docker Desktop is running with enough allocated resources. Check **Settings** > **Resources**. +- If the `kubectl` commands return errors, confirm the context is set to `docker-desktop` + ```console + $ kubectl config use-context docker-desktop + ``` + You can then try checking the logs of the [Kubernetes system containers](#viewing-system-containers) if you have enabled that setting. +- If you're experiencing cluster issues after updating, reset your Kubernetes cluster. Resetting a Kubernetes cluster can help resolve issues by essentially reverting the cluster to a clean state, and clearing out misconfigurations, corrupted data, or stuck resources that may be causing problems. If the issue still persists, you may need to clean and purge data, and then restart Docker Desktop. + ## Turn off and uninstall Kubernetes To turn off Kubernetes in Docker Desktop: + 1. From the Docker Desktop Dashboard, select the **Settings** icon. -2. Select **Kubernetes** from the left sidebar. -3. Next to **Enable Kubernetes**, clear the checkbox -4. Select **Apply & Restart** to save the settings.This stops and removes Kubernetes containers, and also removes the `/usr/local/bin/kubectl` command. +2. Select the **Kubernetes** tab. +3. Deselect the **Enable Kubernetes** checkbox. +4. Select **Apply & Restart** to save the settings. This stops and removes Kubernetes containers, and also removes the `/usr/local/bin/kubectl` command. From 670b06bab10a444f1153c6fe511011a26a8f37e9 Mon Sep 17 00:00:00 2001 From: Pieter Ouwerkerk Date: Sun, 19 Jan 2025 22:31:06 -0500 Subject: [PATCH 04/12] Fix ENV name typo --- content/manuals/build/building/variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/build/building/variables.md b/content/manuals/build/building/variables.md index 74f184f73407..1812bd02e6e9 100644 --- a/content/manuals/build/building/variables.md +++ b/content/manuals/build/building/variables.md @@ -158,7 +158,7 @@ COPY . . CMD ["node", "app.js"] ``` -With this Dockerfile, you can use `--build-arg` to override the default value of `ENV`: +With this Dockerfile, you can use `--build-arg` to override the default value of `NODE_ENV`: ```console $ docker build --build-arg NODE_ENV=development . From 6e529f4511f994ecd486533a3575f5ccd959e0e8 Mon Sep 17 00:00:00 2001 From: Shariq Ahmed Khan Date: Mon, 20 Jan 2025 10:14:36 +0100 Subject: [PATCH 05/12] Update 06_bind_mounts.md (#21696) For Window users it's important to know this, users on stack overflow reports lost in troubleshooting or finding file sharing option in setting. I was lost too. ## Description ## Related issues or tickets ## Reviews - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/get-started/workshop/06_bind_mounts.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/get-started/workshop/06_bind_mounts.md b/content/get-started/workshop/06_bind_mounts.md index 70539a3e37db..4bb41053f7e5 100644 --- a/content/get-started/workshop/06_bind_mounts.md +++ b/content/get-started/workshop/06_bind_mounts.md @@ -52,6 +52,9 @@ work. Docker Desktop's file sharing setting. This setting defines which parts of your filesystem you can share with containers. For details about accessing the setting, see [File sharing](/manuals/desktop/settings-and-maintenance/settings.md#file-sharing). + > [!NOTE] + > The **File sharing** tab is only available in Hyper-V mode, because the files are automatically shared in WSL 2 mode and Windows container mode. + 2. Open a terminal and change directory to the `getting-started-app` directory. From 3a782c9c7429dab860dde74ff04d678451c5c24d Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Mon, 20 Jan 2025 14:47:10 +0000 Subject: [PATCH 06/12] ENGDOCS-2382 (#21855) ## Description Hotjar Triage on: - https://docker.slack.com/archives/C04BMTUC41E/p1737194423048759 ## Related issues or tickets ## Reviews - [ ] Technical review - [ ] Editorial review - [ ] Product review --- content/manuals/desktop/setup/install/windows-install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/manuals/desktop/setup/install/windows-install.md b/content/manuals/desktop/setup/install/windows-install.md index 580a92e545fa..53954a419bd2 100644 --- a/content/manuals/desktop/setup/install/windows-install.md +++ b/content/manuals/desktop/setup/install/windows-install.md @@ -72,8 +72,8 @@ For more information on setting up WSL 2 with Docker Desktop, see [WSL](/manuals {{< /tab >}} {{< tab name="Hyper-V backend, x86_64" >}} -- Windows 11 64-bit: Home or Pro version 22H2 or higher, or Enterprise or Education version 22H2 or higher. -- Windows 10 64-bit: Minimum required is Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher. +- Windows 11 64-bit: Enterprise, Pro, or Education version 22H2 or higher. +- Windows 10 64-bit: Enterprise, Pro, or Education version 22H2 (build 19045) or higher. - Turn on Hyper-V and Containers Windows features. - The following hardware prerequisites are required to successfully run Client Hyper-V on Windows 10: From 559d554cf1e50328db4d501a1abbf0f5fb5776e4 Mon Sep 17 00:00:00 2001 From: crazy-max <1951866+crazy-max@users.noreply.github.com> Date: Mon, 20 Jan 2025 19:13:14 +0000 Subject: [PATCH 07/12] vendor: github.com/docker/buildx v0.20.0 Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../docker/buildx/docs/bake-reference.md | 4 +- _vendor/modules.txt | 4 +- data/buildx/docker_buildx.yaml | 2 + data/buildx/docker_buildx_bake.yaml | 56 +++++++++++++++++-- data/buildx/docker_buildx_build.yaml | 10 +++- data/buildx/docker_buildx_debug_build.yaml | 2 +- data/buildx/docker_buildx_history.yaml | 46 +++++++++++++++ .../buildx/docker_buildx_history_inspect.yaml | 38 +++++++++++++ ...ker_buildx_history_inspect_attachment.yaml | 53 ++++++++++++++++++ data/buildx/docker_buildx_history_logs.yaml | 45 +++++++++++++++ data/buildx/docker_buildx_history_ls.yaml | 55 ++++++++++++++++++ data/buildx/docker_buildx_history_open.yaml | 34 +++++++++++ data/buildx/docker_buildx_history_rm.yaml | 45 +++++++++++++++ go.mod | 6 +- go.sum | 2 + 15 files changed, 386 insertions(+), 16 deletions(-) create mode 100644 data/buildx/docker_buildx_history.yaml create mode 100644 data/buildx/docker_buildx_history_inspect.yaml create mode 100644 data/buildx/docker_buildx_history_inspect_attachment.yaml create mode 100644 data/buildx/docker_buildx_history_logs.yaml create mode 100644 data/buildx/docker_buildx_history_ls.yaml create mode 100644 data/buildx/docker_buildx_history_open.yaml create mode 100644 data/buildx/docker_buildx_history_rm.yaml diff --git a/_vendor/github.com/docker/buildx/docs/bake-reference.md b/_vendor/github.com/docker/buildx/docs/bake-reference.md index 19483210a5be..192dded4fe60 100644 --- a/_vendor/github.com/docker/buildx/docs/bake-reference.md +++ b/_vendor/github.com/docker/buildx/docs/bake-reference.md @@ -19,8 +19,8 @@ By default, Bake uses the following lookup order to find the configuration file: 3. `docker-compose.yml` 4. `docker-compose.yaml` 5. `docker-bake.json` -6. `docker-bake.override.json` -7. `docker-bake.hcl` +6. `docker-bake.hcl` +7. `docker-bake.override.json` 8. `docker-bake.override.hcl` You can specify the file location explicitly using the `--file` flag: diff --git a/_vendor/modules.txt b/_vendor/modules.txt index ee53a1a18a46..3a19633bb399 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -1,6 +1,6 @@ # github.com/moby/moby v27.5.0+incompatible -# github.com/moby/buildkit v0.18.1 -# github.com/docker/buildx v0.19.2 +# github.com/moby/buildkit v0.19.0 +# github.com/docker/buildx v0.20.0 # github.com/docker/cli v27.5.0+incompatible # github.com/docker/compose/v2 v2.32.4 # github.com/docker/scout-cli v1.15.0 diff --git a/data/buildx/docker_buildx.yaml b/data/buildx/docker_buildx.yaml index c13fe0b3c354..4c786feff7d9 100644 --- a/data/buildx/docker_buildx.yaml +++ b/data/buildx/docker_buildx.yaml @@ -11,6 +11,7 @@ cname: - docker buildx debug - docker buildx dial-stdio - docker buildx du + - docker buildx history - docker buildx imagetools - docker buildx inspect - docker buildx ls @@ -26,6 +27,7 @@ clink: - docker_buildx_debug.yaml - docker_buildx_dial-stdio.yaml - docker_buildx_du.yaml + - docker_buildx_history.yaml - docker_buildx_imagetools.yaml - docker_buildx_inspect.yaml - docker_buildx_ls.yaml diff --git a/data/buildx/docker_buildx_bake.yaml b/data/buildx/docker_buildx_bake.yaml index 0836a274ae8b..203d066a00a1 100644 --- a/data/buildx/docker_buildx_bake.yaml +++ b/data/buildx/docker_buildx_bake.yaml @@ -59,24 +59,34 @@ options: experimentalcli: false kubernetes: false swarm: false + - option: list + value_type: string + description: List targets or variables + details_url: '#list' + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false - option: list-targets value_type: bool default_value: "false" description: List available targets - deprecated: false + deprecated: true hidden: true experimental: false - experimentalcli: true + experimentalcli: false kubernetes: false swarm: false - option: list-variables value_type: bool default_value: "false" description: List defined variables - deprecated: false + deprecated: true hidden: true experimental: false - experimentalcli: true + experimentalcli: false kubernetes: false swarm: false - option: load @@ -125,7 +135,7 @@ options: value_type: string default_value: auto description: | - Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use plain to show container output + Set type of progress output (`auto`, `quiet`, `plain`, `tty`, `rawjson`). Use plain to show container output details_url: '#progress' deprecated: false hidden: false @@ -259,6 +269,42 @@ examples: |- See the [Bake file reference](/build/bake/reference/) for more details. + ### List targets and variables (--list) {#list} + + The `--list` flag displays all available targets or variables in the Bake + configuration, along with a description (if set using the `description` + property in the Bake file). + + To list all targets: + + ```console {title="List targets"} + $ docker buildx bake --list=targets + TARGET DESCRIPTION + binaries + default binaries + update-docs + validate + validate-golangci Validate .golangci.yml schema (does not run Go linter) + ``` + + To list variables: + + ```console + $ docker buildx bake --list=variables + VARIABLE VALUE DESCRIPTION + REGISTRY docker.io/username Registry and namespace + IMAGE_NAME my-app Image name + GO_VERSION + ``` + + By default, the output of `docker buildx bake --list` is presented in a table + format. Alternatively, you can use a long-form CSV syntax and specify a + `format` attribute to output the list in JSON. + + ```console + $ docker buildx bake --list=type=targets,format=json + ``` + ### Write build results metadata to a file (--metadata-file) {#metadata-file} Similar to [`buildx build --metadata-file`](/reference/cli/docker/buildx/build/#metadata-file) but diff --git a/data/buildx/docker_buildx_build.yaml b/data/buildx/docker_buildx_build.yaml index b1dc9c44de09..39d13d3ac098 100644 --- a/data/buildx/docker_buildx_build.yaml +++ b/data/buildx/docker_buildx_build.yaml @@ -355,7 +355,7 @@ options: value_type: string default_value: auto description: | - Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use plain to show container output + Set type of progress output (`auto`, `quiet`, `plain`, `tty`, `rawjson`). Use plain to show container output details_url: '#progress' deprecated: false hidden: false @@ -1317,8 +1317,12 @@ examples: |- --progress=VALUE ``` - Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use `plain` to show container - output (default `auto`). + Set type of progress output. Supported values are: + - `auto` (default): Uses the `tty` mode if the client is a TTY, or `plain` otherwise + - `tty`: An interactive stream of the output with color and redrawing + - `plain`: Prints the raw build progress in a plaintext format + - `quiet`: Suppress the build output and print image ID on success (same as `--quiet`) + - `rawjson`: Prints the raw build progress as JSON lines > [!NOTE] > You can also use the `BUILDKIT_PROGRESS` environment variable to set its value. diff --git a/data/buildx/docker_buildx_debug_build.yaml b/data/buildx/docker_buildx_debug_build.yaml index dccc8aa96f3a..38c3faa67ec6 100644 --- a/data/buildx/docker_buildx_debug_build.yaml +++ b/data/buildx/docker_buildx_debug_build.yaml @@ -337,7 +337,7 @@ options: value_type: string default_value: auto description: | - Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use plain to show container output + Set type of progress output (`auto`, `quiet`, `plain`, `tty`, `rawjson`). Use plain to show container output deprecated: false hidden: false experimental: false diff --git a/data/buildx/docker_buildx_history.yaml b/data/buildx/docker_buildx_history.yaml new file mode 100644 index 000000000000..e3e172193522 --- /dev/null +++ b/data/buildx/docker_buildx_history.yaml @@ -0,0 +1,46 @@ +command: docker buildx history +short: Commands to work on build records +long: Commands to work on build records +usage: docker buildx history +pname: docker buildx +plink: docker_buildx.yaml +cname: + - docker buildx history inspect + - docker buildx history logs + - docker buildx history ls + - docker buildx history open + - docker buildx history rm +clink: + - docker_buildx_history_inspect.yaml + - docker_buildx_history_logs.yaml + - docker_buildx_history_ls.yaml + - docker_buildx_history_open.yaml + - docker_buildx_history_rm.yaml +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/data/buildx/docker_buildx_history_inspect.yaml b/data/buildx/docker_buildx_history_inspect.yaml new file mode 100644 index 000000000000..f226342956ce --- /dev/null +++ b/data/buildx/docker_buildx_history_inspect.yaml @@ -0,0 +1,38 @@ +command: docker buildx history inspect +short: Inspect a build +long: Inspect a build +usage: docker buildx history inspect [OPTIONS] [REF] +pname: docker buildx history +plink: docker_buildx_history.yaml +cname: + - docker buildx history inspect attachment +clink: + - docker_buildx_history_inspect_attachment.yaml +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/data/buildx/docker_buildx_history_inspect_attachment.yaml b/data/buildx/docker_buildx_history_inspect_attachment.yaml new file mode 100644 index 000000000000..c43308120bba --- /dev/null +++ b/data/buildx/docker_buildx_history_inspect_attachment.yaml @@ -0,0 +1,53 @@ +command: docker buildx history inspect attachment +short: Inspect a build attachment +long: Inspect a build attachment +usage: docker buildx history inspect attachment [OPTIONS] REF [DIGEST] +pname: docker buildx history inspect +plink: docker_buildx_history_inspect.yaml +options: + - option: platform + value_type: string + description: Platform of attachment + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: type + value_type: string + description: Type of attachment + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/data/buildx/docker_buildx_history_logs.yaml b/data/buildx/docker_buildx_history_logs.yaml new file mode 100644 index 000000000000..c6afba47cda9 --- /dev/null +++ b/data/buildx/docker_buildx_history_logs.yaml @@ -0,0 +1,45 @@ +command: docker buildx history logs +short: Print the logs of a build +long: Print the logs of a build +usage: docker buildx history logs [OPTIONS] [REF] +pname: docker buildx history +plink: docker_buildx_history.yaml +options: + - option: progress + value_type: string + default_value: plain + description: Set type of progress output (plain, rawjson, tty) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/data/buildx/docker_buildx_history_ls.yaml b/data/buildx/docker_buildx_history_ls.yaml new file mode 100644 index 000000000000..a1bdf1833ee1 --- /dev/null +++ b/data/buildx/docker_buildx_history_ls.yaml @@ -0,0 +1,55 @@ +command: docker buildx history ls +short: List build records +long: List build records +usage: docker buildx history ls +pname: docker buildx history +plink: docker_buildx_history.yaml +options: + - option: format + value_type: string + default_value: table + description: Format the output + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: no-trunc + value_type: bool + default_value: "false" + description: Don't truncate output + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/data/buildx/docker_buildx_history_open.yaml b/data/buildx/docker_buildx_history_open.yaml new file mode 100644 index 000000000000..e79b0ba56997 --- /dev/null +++ b/data/buildx/docker_buildx_history_open.yaml @@ -0,0 +1,34 @@ +command: docker buildx history open +short: Open a build in Docker Desktop +long: Open a build in Docker Desktop +usage: docker buildx history open [OPTIONS] [REF] +pname: docker buildx history +plink: docker_buildx_history.yaml +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/data/buildx/docker_buildx_history_rm.yaml b/data/buildx/docker_buildx_history_rm.yaml new file mode 100644 index 000000000000..aa3ddd173cbb --- /dev/null +++ b/data/buildx/docker_buildx_history_rm.yaml @@ -0,0 +1,45 @@ +command: docker buildx history rm +short: Remove build records +long: Remove build records +usage: docker buildx history rm [OPTIONS] [REF...] +pname: docker buildx history +plink: docker_buildx_history.yaml +options: + - option: all + value_type: bool + default_value: "false" + description: Remove all build records + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +inherited_options: + - option: builder + value_type: string + description: Override the configured builder instance + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: debug + shorthand: D + value_type: bool + default_value: "false" + description: Enable debug logging + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/go.mod b/go.mod index 295c5f5b6f99..3e83458659f8 100644 --- a/go.mod +++ b/go.mod @@ -3,16 +3,16 @@ module github.com/docker/docs go 1.23.1 require ( - github.com/docker/buildx v0.19.2 // indirect + github.com/docker/buildx v0.20.0 // indirect github.com/docker/cli v27.5.0+incompatible // indirect github.com/docker/compose/v2 v2.32.4 // indirect github.com/docker/scout-cli v1.15.0 // indirect - github.com/moby/buildkit v0.18.1 // indirect + github.com/moby/buildkit v0.19.0 // indirect github.com/moby/moby v27.5.0+incompatible // indirect ) replace ( - github.com/docker/buildx => github.com/docker/buildx v0.19.2 + github.com/docker/buildx => github.com/docker/buildx v0.20.0 github.com/docker/cli => github.com/docker/cli v27.5.0+incompatible github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.32.4 github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0 diff --git a/go.sum b/go.sum index d3b46ccdf9ad..149048689303 100644 --- a/go.sum +++ b/go.sum @@ -88,6 +88,8 @@ github.com/docker/buildx v0.19.1 h1:muQEvRJLvOCS0p/67gPwjnQPWqE5ot3sGkb2Eq7vCmw= github.com/docker/buildx v0.19.1/go.mod h1:k4WP+XmGRYL0a7l4RZAI2TqpwhuAuSQ5U/rosRgFmAA= github.com/docker/buildx v0.19.2 h1:2zXzgP2liQKgQ5BiOqMc+wz7hfWgAIMWw5MR6QDG++I= github.com/docker/buildx v0.19.2/go.mod h1:k4WP+XmGRYL0a7l4RZAI2TqpwhuAuSQ5U/rosRgFmAA= +github.com/docker/buildx v0.20.0 h1:XM2EvwEfohbxLPAheVm03biNHpspB/dA6U9F0c6yJsI= +github.com/docker/buildx v0.20.0/go.mod h1:VVi4Nvo4jd/IkRvwyExbIyW7u82fivK61MRx5I0oKic= github.com/docker/cli v24.0.2+incompatible h1:QdqR7znue1mtkXIJ+ruQMGQhpw2JzMJLRXp6zpzF6tM= github.com/docker/cli v24.0.2+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8= github.com/docker/cli v24.0.4+incompatible h1:Y3bYF9ekNTm2VFz5U/0BlMdJy73D+Y1iAAZ8l63Ydzw= From 2c74df2578609ade64c83629cd39c8e26e333d9a Mon Sep 17 00:00:00 2001 From: CrazyMax <1951866+crazy-max@users.noreply.github.com> Date: Tue, 21 Jan 2025 12:31:28 +0100 Subject: [PATCH 08/12] buildx: create stub files for new history command Signed-off-by: CrazyMax <1951866+crazy-max@users.noreply.github.com> --- .../cli/docker/buildx/history/_index.md | 16 ++++++++++++++++ .../cli/docker/buildx/history/inspect/_index.md | 16 ++++++++++++++++ .../docker/buildx/history/inspect/attachment.md | 16 ++++++++++++++++ .../reference/cli/docker/buildx/history/logs.md | 16 ++++++++++++++++ .../reference/cli/docker/buildx/history/ls.md | 16 ++++++++++++++++ .../reference/cli/docker/buildx/history/open.md | 16 ++++++++++++++++ .../reference/cli/docker/buildx/history/rm.md | 16 ++++++++++++++++ 7 files changed, 112 insertions(+) create mode 100644 content/reference/cli/docker/buildx/history/_index.md create mode 100644 content/reference/cli/docker/buildx/history/inspect/_index.md create mode 100644 content/reference/cli/docker/buildx/history/inspect/attachment.md create mode 100644 content/reference/cli/docker/buildx/history/logs.md create mode 100644 content/reference/cli/docker/buildx/history/ls.md create mode 100644 content/reference/cli/docker/buildx/history/open.md create mode 100644 content/reference/cli/docker/buildx/history/rm.md diff --git a/content/reference/cli/docker/buildx/history/_index.md b/content/reference/cli/docker/buildx/history/_index.md new file mode 100644 index 000000000000..cf0454729c0b --- /dev/null +++ b/content/reference/cli/docker/buildx/history/_index.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history +title: docker buildx history +layout: cli +aliases: +- /engine/reference/commandline/buildx_history/ +--- + + diff --git a/content/reference/cli/docker/buildx/history/inspect/_index.md b/content/reference/cli/docker/buildx/history/inspect/_index.md new file mode 100644 index 000000000000..533b40c6c4a6 --- /dev/null +++ b/content/reference/cli/docker/buildx/history/inspect/_index.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history_inspect +title: docker buildx history inspect +layout: cli +aliases: +- /engine/reference/commandline/buildx_history_inspect/ +--- + + diff --git a/content/reference/cli/docker/buildx/history/inspect/attachment.md b/content/reference/cli/docker/buildx/history/inspect/attachment.md new file mode 100644 index 000000000000..49a17b2f8b8a --- /dev/null +++ b/content/reference/cli/docker/buildx/history/inspect/attachment.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history_inspect_attachment +title: docker buildx history inspect attachment +layout: cli +aliases: +- /engine/reference/commandline/buildx_history_inspect_attachment/ +--- + + diff --git a/content/reference/cli/docker/buildx/history/logs.md b/content/reference/cli/docker/buildx/history/logs.md new file mode 100644 index 000000000000..c859717f04a3 --- /dev/null +++ b/content/reference/cli/docker/buildx/history/logs.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history_logs +title: docker buildx history logs +layout: cli +aliases: +- /engine/reference/commandline/buildx_history_logs/ +--- + + diff --git a/content/reference/cli/docker/buildx/history/ls.md b/content/reference/cli/docker/buildx/history/ls.md new file mode 100644 index 000000000000..5bb38651bd17 --- /dev/null +++ b/content/reference/cli/docker/buildx/history/ls.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history_ls +title: docker buildx history ls +layout: cli +aliases: +- /engine/reference/commandline/buildx_history_ls/ +--- + + diff --git a/content/reference/cli/docker/buildx/history/open.md b/content/reference/cli/docker/buildx/history/open.md new file mode 100644 index 000000000000..e7b98ef293dd --- /dev/null +++ b/content/reference/cli/docker/buildx/history/open.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history_open +title: docker buildx history open +layout: cli +aliases: +- /engine/reference/commandline/buildx_history_open/ +--- + + diff --git a/content/reference/cli/docker/buildx/history/rm.md b/content/reference/cli/docker/buildx/history/rm.md new file mode 100644 index 000000000000..744a68175a97 --- /dev/null +++ b/content/reference/cli/docker/buildx/history/rm.md @@ -0,0 +1,16 @@ +--- +datafolder: buildx +datafile: docker_buildx_history_rm +title: docker buildx history rm +layout: cli +aliases: +- /engine/reference/commandline/buildx_history_rm/ +--- + + From f466e4881b5820602428a00bfd896fe2f351f502 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Tue, 21 Jan 2025 13:54:16 +0100 Subject: [PATCH 09/12] vendor: github.com/moby/buildkit v0.19.0 Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- .../frontend/dockerfile/docs/reference.md | 27 ++++++++++--------- go.mod | 2 +- go.sum | 2 ++ 3 files changed, 18 insertions(+), 13 deletions(-) diff --git a/_vendor/github.com/moby/buildkit/frontend/dockerfile/docs/reference.md b/_vendor/github.com/moby/buildkit/frontend/dockerfile/docs/reference.md index a5749ca533cc..0afa620e2cd2 100644 --- a/_vendor/github.com/moby/buildkit/frontend/dockerfile/docs/reference.md +++ b/_vendor/github.com/moby/buildkit/frontend/dockerfile/docs/reference.md @@ -1280,11 +1280,11 @@ relative to the build context. For example, if the build context is the current directory, `ADD file.txt /` adds the file at `./file.txt` to the root of the filesystem in the build container. -When adding source files from the build context, their paths are interpreted as -relative to the root of the context. If you specify a relative path leading -outside of the build context, such as `ADD ../something /something`, parent -directory paths are stripped out automatically. The effective source path in -this example becomes `ADD something /something`. +Specifying a source path with a leading slash or one that navigates outside the +build context, such as `ADD ../something /something`, automatically removes any +parent directory navigation (`../`). Trailing slashes in the source path are +also disregarded, making `ADD something/ /something` equivalent to `ADD +something /something`. If the source is a directory, the contents of the directory are copied, including filesystem metadata. The directory itself isn't copied, only its @@ -1476,8 +1476,8 @@ ADD [--checksum=] ... ``` The `--checksum` flag lets you verify the checksum of a remote resource. The -checksum is formatted as `:`. The supported algorithms are -`sha256`, `sha384`, and `sha512`. +checksum is formatted as `sha256:`. SHA-256 is the only supported hash +algorithm. ```dockerfile ADD --checksum=sha256:24454f830cdb571e2c4ad15481119c43b3cafd48dd869a9b2945d1036d1dc68d https://mirrors.edge.kernel.org/pub/linux/kernel/Historic/linux-0.01.tar.gz / @@ -1556,11 +1556,14 @@ For more information about copying from named sources, see the #### Copying from the build context -When copying source files from the build context, their paths are interpreted as -relative to the root of the context. If you specify a relative path leading -outside of the build context, such as `COPY ../something /something`, parent -directory paths are stripped out automatically. The effective source path in -this example becomes `COPY something /something`. +When copying source files from the build context, paths are interpreted as +relative to the root of the context. + +Specifying a source path with a leading slash or one that navigates outside the +build context, such as `COPY ../something /something`, automatically removes +any parent directory navigation (`../`). Trailing slashes in the source path +are also disregarded, making `COPY something/ /something` equivalent to `COPY +something /something`. If the source is a directory, the contents of the directory are copied, including filesystem metadata. The directory itself isn't copied, only its diff --git a/go.mod b/go.mod index 3e83458659f8..500a6b9e9f24 100644 --- a/go.mod +++ b/go.mod @@ -16,6 +16,6 @@ replace ( github.com/docker/cli => github.com/docker/cli v27.5.0+incompatible github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.32.4 github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0 - github.com/moby/buildkit => github.com/moby/buildkit v0.18.0 + github.com/moby/buildkit => github.com/moby/buildkit v0.19.0 github.com/moby/moby => github.com/moby/moby v27.5.0+incompatible ) diff --git a/go.sum b/go.sum index 149048689303..ba47eca2db11 100644 --- a/go.sum +++ b/go.sum @@ -333,6 +333,8 @@ github.com/moby/buildkit v0.17.1-0.20241031124041-354f2d13c905 h1:KMEmQThIQYXKvB github.com/moby/buildkit v0.17.1-0.20241031124041-354f2d13c905/go.mod h1:ru8NFyDHD8HbuKaLXJIjK9nr3x6FZR+IWjtF07S+wdM= github.com/moby/buildkit v0.18.0 h1:KSelhNINJcNA3FCWBbGCytvicjP+kjU5kZlZhkTUkVo= github.com/moby/buildkit v0.18.0/go.mod h1:vCR5CX8NGsPTthTg681+9kdmfvkvqJBXEv71GZe5msU= +github.com/moby/buildkit v0.19.0 h1:w9G1p7sArvCGNkpWstAqJfRQTXBKukMyMK1bsah1HNo= +github.com/moby/buildkit v0.19.0/go.mod h1:WiHBFTgWV8eB1AmPxIWsAlKjUACAwm3X/14xOV4VWew= github.com/moby/locker v1.0.1/go.mod h1:S7SDdo5zpBK84bzzVlKr2V0hz+7x9hWbYC/kq7oQppc= github.com/moby/moby v24.0.2+incompatible h1:yH+5dRHH1x3XRKzl1THA2aGTy6CHYnkt5N924ADMax8= github.com/moby/moby v24.0.2+incompatible/go.mod h1:fDXVQ6+S340veQPv35CzDahGBmHsiclFwfEygB/TWMc= From e8842a8d01ce516e11bd747ed219e88291c4ad10 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Tue, 21 Jan 2025 14:05:07 +0100 Subject: [PATCH 10/12] build: buildx v0.20.0 release notes Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- content/manuals/build/release-notes.md | 32 ++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/content/manuals/build/release-notes.md b/content/manuals/build/release-notes.md index 9e27b9f79b1b..0c995aaf89bc 100644 --- a/content/manuals/build/release-notes.md +++ b/content/manuals/build/release-notes.md @@ -10,6 +10,38 @@ toc_max: 2 This page contains information about the new features, improvements, and bug fixes in [Docker Buildx](https://github.com/docker/buildx). +## 0.20.0 + +{{< release-date date="2025-01-20" >}} + +The full release note for this release is available +[on GitHub](https://github.com/docker/buildx/releases/tag/v0.20.0). + +### New + +- New `buildx history` command has been added that allows working with build records of completed and running builds. You can use these commands to list, inspect, remove your builds, replay the logs of already completed builds, and quickly open your builds in Docker Desktop Build UI for further debugging. This is an early version of this command and we expect to add more features in the future releases. [#2891](https://github.com/docker/buildx/pull/2891), [#2925](https://github.com/docker/buildx/pull/2925) + +### Enhancements + +- Bake: Definition now supports new object notation for the fields that previously required CSV strings as inputs (`attest`, `output`, `cache-from`, `cache-to`, `secret`, `ssh`). [docker/buildx#2758](https://github.com/docker/buildx/pull/2758), [docker/buildx#2848](https://github.com/docker/buildx/pull/2848), [docker/buildx#2871](https://github.com/docker/buildx/pull/2871), [docker/buildx#2814](https://github.com/docker/buildx/pull/2814) +- Bake: Filesystem entitlements now error by default. To disable this behavior, you can set `BUILDX_BAKE_ENTITLEMENTS_FS=0`. [docker/buildx#2875](https://github.com/docker/buildx/pull/2875) +- Bake: Infer Git authentication token from remote files to build request. [docker/buildx#2905](https://github.com/docker/buildx/pull/2905) +- Bake: Add support for `--list` flag to list targets and variables. [docker/buildx#2900](https://github.com/docker/buildx/pull/2900), [docker/buildx#2907](https://github.com/docker/buildx/pull/2907) +- Bake: Update lookup order for default definition files to load the files with "override" suffix later. [docker/buildx#2886](https://github.com/docker/buildx/pull/2886) + +### Bug fixes + +- Bake: Fix entitlements check for default SSH socket. [docker/buildx#2898](https://github.com/docker/buildx/pull/2898) +- Bake: Fix missing default target in group's default targets. [docker/buildx#2863](https://github.com/docker/buildx/pull/2863) +- Bake: Fix named context from target platform matching. [docker/buildx#2877](https://github.com/docker/buildx/pull/2877) +- Fix missing documentation for quiet progress mode. [docker/buildx#2899](https://github.com/docker/buildx/pull/2899) +- Fix missing last progress from loading layers. [docker/buildx#2876](https://github.com/docker/buildx/pull/2876) +- Validate BuildKit configuration before creating a builder. [docker/buildx#2864](https://github.com/docker/buildx/pull/2864) + +### Packaging + +- Compose compatibility has been updated to v2.4.7. [docker/buildx#2893](https://github.com/docker/buildx/pull/2893), [docker/buildx#2857](https://github.com/docker/buildx/pull/2857), [docker/buildx#2829](https://github.com/docker/buildx/pull/2829) + ## 0.19.1 {{< release-date date="2024-11-27" >}} From 9cdce0c0cc2b26f6435d42612dde2a9aecab5364 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Tue, 21 Jan 2025 14:10:47 +0100 Subject: [PATCH 11/12] build: dockerfile v0.13.0 release notes Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- .../buildkit/dockerfile-release-notes.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/content/manuals/build/buildkit/dockerfile-release-notes.md b/content/manuals/build/buildkit/dockerfile-release-notes.md index e05d4751de97..94f5ebd328bb 100644 --- a/content/manuals/build/buildkit/dockerfile-release-notes.md +++ b/content/manuals/build/buildkit/dockerfile-release-notes.md @@ -13,6 +13,37 @@ issues, and bug fixes in [Dockerfile reference](/reference/dockerfile.md). For usage, see the [Dockerfile frontend syntax](frontend.md) page. +## 1.13.0 + +{{< release-date date="2025-01-20" >}} + +The full release note for this release is available +[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.13.0). + +```dockerfile +# syntax=docker/dockerfile:1.13.0 +``` + +- New `TARGETOSVERSION`, `BUILDOSVERSION` builtin build-args are available for Windows builds, and `TARGETPLATFORM` value now also contains `OSVersion` value. [moby/buildkit#5614](https://github.com/moby/buildkit/pull/5614) +- Allow syntax forwarding for external frontends for files starting with a Byte Order Mark (BOM). [moby/buildkit#5645](https://github.com/moby/buildkit/pull/5645) +- Default `PATH` in Windows Containers has been updated with `powershell.exe` directory. [moby/buildkit#5446](https://github.com/moby/buildkit/pull/5446) +- Fix Dockerfile directive parsing to not allow invalid syntax. [moby/buildkit#5646](https://github.com/moby/buildkit/pull/5646) +- Fix case where `ONBUILD` command may have run twice on inherited stage. [moby/buildkit#5593](https://github.com/moby/buildkit/pull/5593) +- Fix possible missing named context replacement for child stages in Dockerfile. [moby/buildkit#5596](https://github.com/moby/buildkit/pull/5596) + +## 1.13.0-labs + +{{< release-date date="2025-01-20" >}} + +The full release note for this release is available +[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.13.0-labs). + +```dockerfile +# syntax=docker.io/docker/dockerfile-upstream:1.13.0-labs +``` + +- Fix support for non-octal values for `COPY --chmod`. [moby/buildkit#5626](https://github.com/moby/buildkit/pull/5626) + ## 1.12.0 {{< release-date date="2024-11-27" >}} From 705190702afe041272281bd56275fa3a387d98c9 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Tue, 21 Jan 2025 14:20:48 +0100 Subject: [PATCH 12/12] build: remove experimental callout for bake Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- content/manuals/build/bake/_index.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/content/manuals/build/bake/_index.md b/content/manuals/build/bake/_index.md index 24d630a9ea3d..93dfc11b946e 100644 --- a/content/manuals/build/bake/_index.md +++ b/content/manuals/build/bake/_index.md @@ -6,13 +6,6 @@ aliases: - /build/customize/bake/ --- -{{% experimental %}} - -Bake is an experimental feature, and we are looking for -[feedback from users](https://github.com/docker/buildx/issues). - -{{% /experimental %}} - Bake is a feature of Docker Buildx that lets you define your build configuration using a declarative file, as opposed to specifying a complex CLI expression. It also lets you run multiple builds concurrently with a single invocation.