Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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

GoalChapter
Install rib and build the first imageGetting started
Understand the project’s scopePurpose and design principles
Learn about manifests, configs, layers, and digestsOCI image model
Configure a Rust projectCargo integration
Add image building and signing to GitLab CICI/CD, Docker, and Kubernetes
Configure caching, logs, timeouts, and concurrencyOperations
Review security propertiesReproducibility and security
Study rib internalsArchitecture
Check whether rib fits a particular use caseLimitations

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.