From a11c11fbbb3c4c7e6bdcda58b706c634e2e06b3c Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Thu, 17 Oct 2024 10:49:04 +0200
Subject: [PATCH] build(bake): escape variable interpolation in bake definition

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
---
 content/manuals/build/bake/variables.md | 29 +++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/content/manuals/build/bake/variables.md b/content/manuals/build/bake/variables.md
index 1dfa803900df..b584cc1483a2 100644
--- a/content/manuals/build/bake/variables.md
+++ b/content/manuals/build/bake/variables.md
@@ -78,6 +78,35 @@ $ docker buildx bake --print
 }
 ```
 
+## Escape variable interpolation
+
+If you want to bypass variable interpolation when parsing the Bake definition,
+use double dollar signs (`$${VARIABLE}`).
+
+```hcl
+target "default" {
+  dockerfile-inline = <<EOF
+  FROM alpine
+  ARG TARGETARCH
+  RUN echo "Building for $${TARGETARCH/amd64/x64}"
+  EOF
+  platforms = ["linux/amd64", "linux/arm64"]
+}
+```
+
+```console
+$ docker buildx bake --progress=plain
+...
+#8 [linux/arm64 2/2] RUN echo "Building for arm64"
+#8 0.036 Building for arm64
+#8 DONE 0.0s
+
+#9 [linux/amd64 2/2] RUN echo "Building for x64"
+#9 0.046 Building for x64
+#9 DONE 0.1s
+...
+```
+
 ## Using variables in variables across files
 
 When multiple files are specified, one file can use variables defined in