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

Architecture

One Rust binary (gitimage) with subcommands controller, webhook, node, clone, crdgen, check-config, built on kube-rs, axum, gix and russh. No git or ssh binary, no OpenSSL.

CrateRole
gitimage-apiCRD types, annotation keys, the strict Config
gitimage-gitref resolution, gix fetch and checkout, russh ssh transport with known_hosts checks, host tree APIs
gitimage-ociOCI distribution routes (push endpoint and node server), S3 / registry / memory storage, push tokens
gitimage-controllerreconciler state machine, Job builder, gate releaser, roller, hooks, GC, isolation check, TLS bootstrap, status UI API (ui/, with the web app from the top-level ui/ embedded by build.rs)
gitimage-webhookpure mutate(pod) -> patch, guard, axum handler
gitimage-nodelocalhost-only read-only OCI server
gitimage-tlsCA and certificates, hot-reloading TLS listeners

The design documents (PRD and implementation design) record the decisions and trade-offs.