Merge pull request #11 from crazy-max/examples

Examples from buildkit repo

Author: crazy-max

Diff for: README.md

@@ -16,6 +16,7 @@ ___
 
 - [Note for Docker users](#note-for-docker-users)
 - [Using external Dockerfile frontend](#using-external-dockerfile-frontend)
+- [Examples](#examples)
 - [Syntax](#syntax)
   - [Build Mounts `RUN --mount=...`](#build-mounts-run---mount)
     - [`RUN --mount=type=bind` (the default mount type)](#run---mounttypebind-the-default-mount-type)
@@ -57,6 +58,16 @@ The images are published on two channels: *latest* and *labs*. The latest channe
 incrementing the major component of a version and you may want to pin the image to a specific revision. Even when syntaxes
 change in between releases on labs channel, the old versions are guaranteed to be backward compatible.
 
+## Examples
+
+### CLI examples
+
+* [`build-using-dockerfile`](./examples/build-using-dockerfile): a BuildKit client with `docker build`-style CLI
+
+### LLB examples
+
+* [`dockerfile2llb`](./examples/dockerfile2llb): convert a Dockerfile to LLB for debugging purposes
+
 ## Syntax
 
 ### Build Mounts `RUN --mount=...`

Diff for: examples/build-using-dockerfile/README.md

@@ -0,0 +1,15 @@
+# `build-using-dockerfile` example
+
+:information_source: [BuildKit has been integrated to `docker build` since Docker 18.06.](https://docs.docker.com/develop/develop-images/build_enhancements/)
+The `build-using-dockerfile` CLI is just provided as an example for writing a BuildKit client application.
+
+For people familiar with `docker build` command, `build-using-dockerfile` is provided as an example for building Dockerfiles with BuildKit using a syntax similar to `docker build`.
+
+```shell
+go install .
+
+build-using-dockerfile -t myimage /path/to/dir
+
+# build-using-dockerfile will automatically load the resulting image to Docker
+docker inspect myimage
+```

Diff for: examples/build-using-dockerfile/go.mod

@@ -0,0 +1,65 @@
+module github.com/docker/dockerfile/examples/build-using-dockerfile
+
+go 1.17
+
+require (
+	github.com/containerd/console v1.0.3
+	github.com/docker/dockerfile v0.0.0-00010101000000-000000000000
+	github.com/moby/buildkit v0.9.1-0.20220107201744-ffe2301031c8
+	github.com/pkg/errors v0.9.1
+	github.com/sirupsen/logrus v1.8.1
+	github.com/urfave/cli v1.22.5
+	golang.org/x/sync v0.0.0-20210220032951-036812b2e83c
+)
+
+require (
+	github.com/Microsoft/go-winio v0.5.1 // indirect
+	github.com/agext/levenshtein v1.2.3 // indirect
+	github.com/containerd/containerd v1.6.0-beta.3 // indirect
+	github.com/containerd/containerd/api v1.6.0-beta.3 // indirect
+	github.com/containerd/continuity v0.2.1 // indirect
+	github.com/containerd/ttrpc v1.1.0 // indirect
+	github.com/containerd/typeurl v1.0.2 // indirect
+	github.com/cpuguy83/go-md2man/v2 v2.0.0 // indirect
+	github.com/docker/distribution v2.7.1+incompatible // indirect
+	github.com/docker/docker v20.10.7+incompatible // indirect
+	github.com/docker/go-connections v0.4.0 // indirect
+	github.com/docker/go-units v0.4.0 // indirect
+	github.com/gofrs/flock v0.7.3 // indirect
+	github.com/gogo/googleapis v1.4.1 // indirect
+	github.com/gogo/protobuf v1.3.2 // indirect
+	github.com/golang/protobuf v1.5.2 // indirect
+	github.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510 // indirect
+	github.com/grpc-ecosystem/go-grpc-middleware v1.3.0 // indirect
+	github.com/grpc-ecosystem/grpc-gateway v1.16.0 // indirect
+	github.com/klauspost/compress v1.13.6 // indirect
+	github.com/moby/locker v1.0.1 // indirect
+	github.com/moby/sys/signal v0.6.0 // indirect
+	github.com/morikuni/aec v1.0.0 // indirect
+	github.com/opencontainers/go-digest v1.0.0 // indirect
+	github.com/opencontainers/image-spec v1.0.2-0.20210819154149-5ad6f50d6283 // indirect
+	github.com/russross/blackfriday/v2 v2.0.1 // indirect
+	github.com/shurcooL/sanitized_anchor_name v1.0.0 // indirect
+	github.com/tonistiigi/fsutil v0.0.0-20211208180946-61a57076b9b0 // indirect
+	github.com/tonistiigi/units v0.0.0-20180711220420-6950e57a87ea // indirect
+	github.com/tonistiigi/vt100 v0.0.0-20210615222946-8066bb97264f // indirect
+	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.27.0 // indirect
+	go.opentelemetry.io/otel v1.2.0 // indirect
+	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.0.1 // indirect
+	go.opentelemetry.io/otel/sdk v1.0.1 // indirect
+	go.opentelemetry.io/otel/trace v1.2.0 // indirect
+	go.opentelemetry.io/proto/otlp v0.9.0 // indirect
+	golang.org/x/crypto v0.0.0-20211202192323-5770296d904e // indirect
+	golang.org/x/net v0.0.0-20211123203042-d83791d6bcd9 // indirect
+	golang.org/x/sys v0.0.0-20211123173158-ef496fb156ab // indirect
+	golang.org/x/text v0.3.7 // indirect
+	golang.org/x/time v0.0.0-20210723032227-1f47c861a9ac // indirect
+	google.golang.org/genproto v0.0.0-20211118181313-81c1377c94b1 // indirect
+	google.golang.org/grpc v1.42.0 // indirect
+	google.golang.org/protobuf v1.27.1 // indirect
+)
+
+replace (
+	github.com/docker/docker => github.com/docker/docker v20.10.3-0.20211208011758-87521affb077+incompatible
+	github.com/docker/dockerfile => ../../
+)