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
245245docker build github.com/docker/buildx#d4f088e
246246```
247247
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+
248275#### Keep ` .git ` directory
249276
250277By default, BuildKit doesn't keep the ` .git ` directory when using Git contexts.
You can’t perform that action at this time.
0 commit comments