File tree Expand file tree Collapse file tree 1 file changed +27
-0
lines changed
content/manuals/build/concepts Expand file tree Collapse file tree 1 file changed +27
-0
lines changed Original file line number Diff line number Diff line change @@ -245,6 +245,33 @@ docker build github.com/docker/buildx#d4f088e689b41353d74f1a0bfcd6d7c0b213aed2
245
245
docker build github.com/docker/buildx#d4f088e
246
246
```
247
247
248
+ ### URL queries
249
+ Starting with Buildx v0.28 and BuildKit v0.24, URL queries are also supported.
250
+ URL queries are more structured and recommended over [ URL fragments] ( #url-fragments ) .
251
+
252
+ For example,
253
+ ``` console
254
+ $ docker buildx build https://github.com/user/myrepo.git? branch=container& subdir=docker
255
+ ```
256
+
257
+ | Build Syntax Suffix | Commit Used | Build Context Used |
258
+ | -------------------------------------------- | ----------------------------- | ------------------ |
259
+ | ` myrepo.git ` | ` refs/heads/<default branch> ` | ` / ` |
260
+ | ` myrepo.git?tag=mytag ` | ` refs/tags/mytag ` | ` / ` |
261
+ | ` myrepo.git?branch=mybranch ` | ` refs/heads/mybranch ` | ` / ` |
262
+ | ` myrepo.git?ref=pull/42/head ` | ` refs/pull/42/head ` | ` / ` |
263
+ | ` myrepo.git?subdir=myfolder ` | ` refs/heads/<default branch> ` | ` /myfolder ` |
264
+ | ` myrepo.git?branch=master&subdir=myfolder ` | ` refs/heads/master ` | ` /myfolder ` |
265
+ | ` myrepo.git?tag=mytag&subdir=myfolder ` | ` refs/tags/mytag ` | ` /myfolder ` |
266
+ | ` myrepo.git?branch=mybranch&subdir=myfolder ` | ` refs/heads/mybranch ` | ` /myfolder ` |
267
+
268
+ A commit hash can be specified as a ` commit ` or ` checksum ` query, along with ` tag ` , ` branch ` , or ` ref ` .
269
+ A hash does not need to be a full hash.
270
+
271
+ ``` bash
272
+ docker buildx build ' https://github.com/moby/buildkit.git?tag=v0.21.1&checksum=66735c67'
273
+ ```
274
+
248
275
#### Keep ` .git ` directory
249
276
250
277
By default, BuildKit doesn't keep the ` .git ` directory when using Git contexts.
You can’t perform that action at this time.
0 commit comments