# Drop

> Kubernetes operator that caches container images on cluster nodes.


## Documentation
- [Installation](https://breee.github.io/drop/docs/install/): Prerequisites Kubernetes 1.28+ Helm 3.12+ cert-manager (optional, for secure metrics) Helm Install …
- [Usage](https://breee.github.io/drop/docs/usage/): Cache a Single Image apiVersion: drop.corewire.io/v1alpha1 kind: CachedImage metadata: name: nginx …
- [Discovery](https://breee.github.io/drop/docs/discovery/): The DiscoveryPolicy CRD enables automatic image discovery from external sources. When referenced by …
- [Monitoring](https://breee.github.io/drop/docs/monitoring/): Prometheus Metrics Metric Type Labels Description drop_images_cached_total Counter image, node Total …
- [For AI Agents](https://breee.github.io/drop/docs/for-ai-agents/): Endpoints URL Content Use case /drop/llms.txt Page index with one-line summaries Discover …

### Reference
- [CRD Reference](https://breee.github.io/drop/docs/reference/_generated_crds/): All resources are cluster-scoped under drop.corewire.io/v1alpha1.
Quick Example apiVersion: …
- [Metrics](https://breee.github.io/drop/docs/reference/_generated_metrics/): The drop operator exposes the following metrics:
Metric Type Description drop_images_cached_total …
- [Architecture](https://breee.github.io/drop/docs/reference/_generated_architecture/): CRD Relationships graph TD CachedImage -->|references| PullPolicy CachedImageSet …

### Developer Guide
- [Architecture](https://breee.github.io/drop/docs/developing/architecture/): Drop is a Kubernetes operator that pre-caches container images on cluster nodes by creating …
- [Local Dev Setup](https://breee.github.io/drop/docs/developing/setup/): Prerequisites Tool Version Purpose Go 1.23+ Build the operator Docker any Build images, run kind …
- [Testing](https://breee.github.io/drop/docs/developing/testing/): Unit Tests (envtest) make test Uses controller-runtime’s envtest — a real API server + etcd, …
- [Debugging](https://breee.github.io/drop/docs/developing/debugging/): Operator Logs kubectl logs -n drop-system deploy/drop-controller-manager -f The operator logs …
- [Extending](https://breee.github.io/drop/docs/developing/extending/): Adding a New CRD 1. Define the types Create api/v1alpha1/<name>_types.go:
package v1alpha1 …
- [Code Conventions](https://breee.github.io/drop/docs/developing/conventions/): Naming CRD kinds: PascalCase (CachedImage, not Cached_Image) API group: drop.corewire.io/v1alpha1 …
- [Releasing](https://breee.github.io/drop/docs/developing/releasing/): How to Release git tag v0.1.0 git push origin v0.1.0 That’s it. The CI pipeline handles the …

## Root Pages
- [](https://breee.github.io/drop/proof-of-operation/): Drop Operator — Proof of OperationThis document shows the expected output from …

---
Generated on 2026-05-26 21:46:04 UTC
Site: https://breee.github.io/drop/