rib — Rust Image Builder
rib is a rootless OCI image builder written in Rust. Its name references the project that inspired it, Jib. It packages prebuilt artifacts and runtime files without a Docker daemon, privileged containers, or commands executed inside the image being built.
rib creates reproducible COPY layers using file operations and publishes
the result directly to a registry, an OCI archive, or a Docker archive.
When to use rib
Use rib when an application has already been built and you need to:
- package a binary, a frontend, or another set of files as an OCI image;
- build the image without root access or a container runtime;
- integrate image packaging and signing into a CI/CD pipeline.
rib does not process Dockerfiles. If image preparation requires RUN or
other Dockerfile-specific instructions, use a compatible builder such as
BuildKit or
Buildah.
rib can be installed directly in a build-environment image so Docker or
Kubernetes can cache that image normally. Repeated builds do not require a
mandatory full pull of the base image: its root filesystem is not unpacked
unless the selected output requires it.
How to navigate this book
| Goal | Chapter |
|---|---|
Install rib and build the first image | Getting started |
| Understand the project’s scope | Purpose and design principles |
| Learn about manifests, configs, layers, and digests | OCI image model |
| Configure a Rust project | Cargo integration |
| Add image building and signing to GitLab CI | CI/CD, Docker, and Kubernetes |
| Configure caching, logs, timeouts, and concurrency | Operations |
| Review security properties | Reproducibility and security |
| Study rib internals | Architecture |
| Check whether rib fits a particular use case | Limitations |
For a first look, read Purpose and design principles and Getting started. The remaining chapters can be used as reference material when configuring a particular build scenario.