buildkit-rs

According to the buildkit repo buildkit is:

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

This is a Rust client library for buildkit.

Crates

• buildkit-rs - The meta crate for the buildkit-rs project, it contains all the other crates reexported with no other functionality
• buildkit-rs-llb - The low level buildkit client library
• buildkit-rs-proto - The buildkit protobuf definitions
• buildkit-rs-util - Utilities for building applications that use buildkit

Planned crates

• buildkit-rs-client - A high level client library for buildkit exposing a simmilar API to the Go client
• buildkit-rs-dockerfile - A library for parsing and converting Dockerfiles to LLB (this is mostly for validation and testing, not for production use)

Testing

docker run -d --name buildkitd --privileged moby/buildkit:latest 
export BUILDKIT_HOST=docker-container://buildkitd
cargo run --example test --package buildkit-rs-llb | buildctl b --progress plain --no-cache

QA

What are the goals of this project?

Goals

In order of importance:

• Provide a simple, safe, and fast buildkit client library for Rust
• Make the API idiomatic Rust
• Provide other utilities for building applications that use buildkit in Rust
• Keeping the API simmilar to the buildkit Go client API
• Keeping the code modular as to allow easy opt-in for features
• No unsafe code

Non-goals (non-exhaustive)

• Provide a buildkit daemon implementation
• Provide a CLI for buildkit
• Provide a production ready Dockerfile llb converter

In short, this project is not trying to replace buildkit, but rather provide a Rust client library for buildkit.

What about the rust-buildkit

It is a similar project, we did draw some inspiration from its API, but it is not maintained anymore and it is not compatible with the latest buildkit version. This project is backed by Cicada and which comes first when it comes to priorities.

Why not use the buildkit Go client directly?

The Go client is a great library, but it is not easy to use in Rust. A native Rust client library is much easier to use and it is much faster for our use case. We are all in on Rust but still want to leverage the buildkit ecosystem.

License

All contributions are licensed under either Apache-2.0 OR MIT. If you contribute any code you agree to license it under the same terms as the project.

Any files in crates/proto/vendor under their original license.

Contributing

Any contributions are welcome! If you are interested in contributing, please open an issue or a PR as soon as possible so we can discuss it and ensure it fits the goals of the project + we can avoid duplicate work.

We also are welcome to discuss the project in the Cicada Discord in the #buildkit-rs channel.