How rapidfort/kimia works
Kimia is a Kubernetes-oriented, rootless OCI image builder. Its main workflow parses build options, prepares a local or Git context, configures registry authentication, invokes BuildKit or Buildah to build an image, and optionally pushes or exports the result. Preflight checks support safe rootless operation; documented capabilities also include caching, reproducible builds, and BuildKit attestations/signing. Several implementation details are unsampled, so those features are represented only where the tree or README supports them.
Main entry points: main.go CLI entry · builder.go Builder execution · validator.go Runtime validation · build Attestation and signing
Components 21
CLI and orchestration
- CLI entry
src/cmd/kimia/main.go - Argument parsing
src/cmd/kimia/args.go - Build options
src/cmd/kimia/config.go - Input validation
src/internal/validation/validation.go
Image build
- Build context
src/internal/build/context.go - Builder execution
src/internal/build/builder.go - Build caching
src/internal/build - Reproducible builds
src/internal/build - Image output
src/internal/build/push.go
Rootless readiness
- Environment checks
src/internal/preflight/check_environment.go - Runtime validation
src/internal/preflight/validator.go - User namespaces
src/internal/preflight/userns.go - Storage checks
src/internal/preflight/storage.go
Registries and supply chain
- Registry authentication
src/internal/auth/docker.go - Cloud registry credentials
src/internal/auth/registry.go - Attestation and signing
src/internal/build
Other components
- Build operator
- Git repository
- BuildKit or Buildah
- OCI registry
- Cosign
Connections 22
- Build operator → CLI entry: runs
- CLI entry → Argument parsing: parses flags
- Argument parsing → Build options: sets options
- CLI entry → Environment checks: checks environment
- Environment checks → Runtime validation: validates runtime
- Runtime validation → User namespaces: checks isolation
- Runtime validation → Storage checks: checks storage
- CLI entry → Input validation: validates inputs
- CLI entry → Build context: prepares context
- Build context → Git repository: fetches source
- CLI entry → Registry authentication: sets up credentials
- Registry authentication → Cloud registry credentials: refreshes cloud credentials
- CLI entry → Builder execution: executes build
- Builder execution → Build context: uses context
- Builder execution → BuildKit or Buildah: invokes builder
- Builder execution → Build caching: uses cache options
- Builder execution → Reproducible builds: applies build settings
- CLI entry → Image output: pushes or exports
- Image output → OCI registry: pushes image
- Builder execution → Attestation and signing: configures attestations
- Attestation and signing → Cosign: signs image
- Attestation and signing → OCI registry: publishes attestations