v2.1.0

Container Preflight, as evaluated in Predicting Container Deployment Failures Before Execution by Jointly Analyzing Container Artifacts and Host Environments.

New since v2.0.0

• Kubernetes support. container-preflight k8s checks manifests (files, directories, or helm template / kustomize build output) against a specific cluster, live or from a snapshot. It predicts no matches for kind, ErrImagePull, wrong-architecture images, FailedScheduling with the scheduler's reasons, and Pending volume claims. On minikube, 7 of 8 predictions matched Kubernetes word for word.
• docker run / pull input (preflight --run), rules for Postgres data folders on Windows, the Compose name: key, and Linux Docker Desktop shared folders.
• Corrected precision for the "network not found" category.

Contents

• Tool: preflight, snapshot, learn, k8s.
• bench/: GitHub failure mining with checked precision (32 categories, about 95k issues), plus the labeled development and held-out test samples. Tag eval-frozen marks the rules as of the test draw.
• docs/validation/: field validation on Colima, Docker Desktop and minikube.

v2.0.0

Container Preflight. This is the version evaluated in the paper Predicting Container Deployment Failures Before Execution by Jointly Analyzing Container Artifacts and Host Environments.

Tool

• container-preflight preflight [dir]: predicts Docker and Compose build and start-up failures before execution, using 18 rules. Use --run "docker run …" for commands, and --host snapshot.json to predict for another machine.
• container-preflight snapshot: saves this machine's container capabilities.
• container-preflight learn -- <command>: turns an observed failure into a shareable rule.

Evaluation data

• bench/: GitHub issue mining with checked precision (32 categories, about 95k issues), the labeled development sample (124 issues) and the held-out test sample (121 issues). Tag eval-frozen marks the rules as of the test draw.
• docs/validation/: field validation on Colima and Docker Desktop (Apple silicon).

v1.0.0

Changelog

• 735adaa chore: initialize project and cobra cli
• 70dfc12 ci: add goreleaser and github actions workflow
• dc4a881 feat: add buildx provider
• 4c31839 feat: add docker compose provider
• 95bb96e feat: add docker context check
• 994b684 feat: add docker daemon check
• d1750dc feat: add docker socket check
• 5cfefdf feat: add docker version check
• 602ffe4 feat: add inspect command for static analysis
• 7a668dc feat: add markdown renderer and format flag
• 3e3ffe7 feat: add memory and disk checks using gopsutil
• 2df5b77 feat: add system provider
• b45d11f feat: core engine and domain interfaces
• 97ca191 feat: docker provider and installed check
• b1370f1 feat: executor abstraction
• b4dfff7 feat: output renderers (terminal, json)