How googlecontainertools/distroless works
Distroless provides minimal Debian-based container images containing an application’s runtime dependencies, without package managers or shells. The user-facing workflow is to select a suitable image, add the application artifact (commonly through a multi-stage build), then run the resulting container. The tree identifies image-family definitions, OCI helpers, package metadata tools, and signing code; the README documents the product’s image families and verification guidance. Several implementation links are therefore shown as unverified rather than inferred from directory names.
Main entry points: defs.bzl OCI definitions · base.bzl Base images · static.bzl Static images · cc.bzl C/C++ images
Components 19
Base images
- Debian 13 inputs
private/repos/deb - Static images
static/static.bzl - Base images
base/base.bzl - C/C++ images
cc/cc.bzl
Language runtimes
- Java images
java/java.bzl - Node.js images
nodejs/nodejs.bzl - Python images
python3/python.bzl - Go image helper
private/oci/go_image.bzl - Rust image helper
private/oci/rust_image.bzl - Java image helper
private/oci/java_image.bzl - C/C++ image helper
private/oci/cc_image.bzl
Image assembly
- OCI definitions
private/oci/defs.bzl - Image signing
private/oci/sign_and_push.bzl
Image metadata
- Debian SPDX
private/pkg/debian_spdx.go - Package SPDX
private/pkg/package_spdx.go - Image SPDX
private/pkg/oci_image_spdx.go
Image use
- Distroless container
Other components
- Image user
- Application artifact
Connections 21
- Image user → Static images: selects image
README.md - Image user → Base images: selects image
README.md - Image user → C/C++ images: selects image
README.md - Image user → Java images: selects image
README.md - Image user → Node.js images: selects image
README.md - Image user → Python images: selects image
README.md - Application artifact → Distroless container: copies into
README.md - Debian 13 inputs → Base images: provides base
- Static images → OCI definitions: assembles image
- Base images → OCI definitions: assembles image
- C/C++ images → C/C++ image helper: uses helper
- Java images → Java image helper: uses helper
- Node.js images → OCI definitions: assembles image
- Python images → OCI definitions: assembles image
- Go image helper → OCI definitions: builds image
- Rust image helper → OCI definitions: builds image
- OCI definitions → Distroless container: produces image
- Image signing → Distroless container: signs image
- Image user → Image signing: verifies image
README.md - Debian SPDX → Package SPDX: records package data
- Image SPDX → Distroless container: describes image