concurrent, cache-efficient, and Dockerfile-agnostic builder toolkit
 
 
 
Go to file
Tonis Tiigi b36df4738a frontend: add more commands to dockerfile
Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com>
2017-09-15 18:09:28 -07:00
api/services/control frontend: base of dockerfile frontend 2017-08-31 23:27:25 -07:00
cache solver: implement content based cache support 2017-08-04 10:03:26 -07:00
client frontend: add more commands to dockerfile 2017-09-15 18:09:28 -07:00
cmd frontend: base of dockerfile frontend 2017-08-31 23:27:25 -07:00
control vendor containerd d1e11f17ec7b325f89608dd46c128300b8727d50 2017-09-14 19:06:31 +00:00
examples source: fix multi-platform pull 2017-09-15 13:57:40 -07:00
exporter exporter: add local exporter 2017-08-04 17:12:19 -07:00
frontend frontend: add more commands to dockerfile 2017-09-15 18:09:28 -07:00
hack vendor containerd d1e11f17ec7b325f89608dd46c128300b8727d50 2017-09-14 19:06:31 +00:00
identity identity: add pkg for random id generation 2017-06-19 14:32:50 -07:00
session exporter: add local exporter 2017-08-04 17:12:19 -07:00
snapshot exporter: add local exporter 2017-08-04 17:12:19 -07:00
solver fix for read-only mount 2017-09-14 06:42:12 +00:00
source frontend: add more commands to dockerfile 2017-09-15 18:09:28 -07:00
util frontend: add more commands to dockerfile 2017-09-15 18:09:28 -07:00
vendor vendor containerd d1e11f17ec7b325f89608dd46c128300b8727d50 2017-09-14 19:06:31 +00:00
worker vendor containerd v1.0.0-beta.0 2017-09-09 11:13:02 +00:00
.dockerignore .gitignore and .dockerignore: add .buildstate 2017-06-30 06:24:19 +00:00
.gitignore .gitignore and .dockerignore: add .buildstate 2017-06-30 06:24:19 +00:00
.travis.yml .travis.yml: build Windows binaries 2017-08-04 06:09:41 +00:00
LICENSE Add license 2017-06-01 09:58:33 -07:00
Makefile support building on windows (no functional worker yet) 2017-07-12 06:43:30 +00:00
README.md vendor containerd d1e11f17ec7b325f89608dd46c128300b8727d50 2017-09-14 19:06:31 +00:00
gometalinter.json exporter: add image exporter 2017-07-10 23:29:14 -07:00
vendor.conf vendor containerd d1e11f17ec7b325f89608dd46c128300b8727d50 2017-09-14 19:06:31 +00:00

README.md

Important: This repository is in an early development phase and not suitable for practical workloads. It does not compare with docker build features yet.

asciicinema example

BuildKit

GoDoc Build Status Go Report Card

BuildKit is a toolkit for converting source code to build artifacts in an efficient, expressive and repeatable manner.

Key features:

  • Automatic garbage collection
  • Extendable frontend formats
  • Concurrent dependency resolution
  • Efficient instruction caching
  • Build cache import/export
  • Nested build job invocations
  • Distributable workers
  • Multiple output formats
  • Pluggable architecture

Read the proposal from https://github.com/moby/moby/issues/32925

Quick start

BuildKit daemon can be built in two different versions: one that uses containerd for execution and distribution, and a standalone version that doesn't have other dependencies apart from runc. We are open for adding more backends. buildd is a CLI utility for running the gRPC API.

# buildd daemon (choose one)
go build -o buildd-containerd -tags containerd ./cmd/buildd
go build -o buildd-standalone -tags standalone ./cmd/buildd

# buildctl utility
go build -o buildctl ./cmd/buildctl

You can also use make binaries that prepares all binaries into the bin/ directory.

The first thing to test could be to try building BuildKit with BuildKit. BuildKit provides a low-level solver format that could be used by multiple build definitions. Preparation work for making the Dockerfile parser reusable as a frontend is tracked in https://github.com/moby/moby/pull/33492. As no frontends have been integrated yet we currently have to use a client library to generate this low-level definition.

examples/buildkit* directory contains scripts that define how to build different configurations of BuildKit and its dependencies using the client package. Running one of these script generates a protobuf definition of a build graph. Note that the script itself does not execute any steps of the build.

You can use buildctl debug dump-llb to see what data is this definition.

go run examples/buildkit0/buildkit.go | buildctl debug dump-llb | jq .

To start building use buildctl build command. The script accepts --target flag to choose between containerd and standalone configurations. In standalone mode BuildKit binaries are built together with runc. In containerd mode, the containerd binary is built as well from the upstream repo.

go run examples/buildkit0/buildkit.go | buildctl build

buildctl build will show interactive progress bar by default while the build job is running. It will also show you the path to the trace file that contains all information about the timing of the individual steps and logs.

Different versions of the example scripts show different ways of describing the build definition for this project to show the capabilities of the library. New versions have been added when new features have become available.

  • ./examples/buildkit0 - uses only exec operations, defines a full stage per component.
  • ./examples/buildkit1 - cloning git repositories has been separated for extra concurrency.
  • ./examples/buildkit2 - uses git sources directly instead of running git clone, allowing better performance and much safer caching.
  • ./examples/buildkit3 - allows using local source files for separate components eg. ./buildkit3 --runc=local | buildctl build --local runc-src=some/local/path

Supported runc version

During development buildkit is tested with the version of runc that is being used by the containerd repository. Please refer to runc.md for more information.

Contributing

Running tests:

make test

Updating vendored dependencies:

# update vendor.conf
make vendor

Validating your updates before submission:

make validate-all