Component
core/storage/kubestash
KubeStash, AppsCode's backup operator for Kubernetes, built on restic. It backs up the volumes of a workload into a restic repository in a bucket or on a Kubernetes volume, on the schedules its own resources declare, and restores them. It is installed once per cluster and acts on the KubeStash resources of every namespace. It backs nothing up by itself. A datastore is backed up by attaching core/backup to it in the Release, with the Manifest binding the helm/backup-kubestash FeatureRecipe, which writes a KubeStash BackupConfiguration, its BackupStorage and its RetentionPolicy beside the datastore; the backup runs only where this component is deployed. The Release supplies what KubeStash runs: AppsCode publishes KubeStash under its own terms and runs it only under a licence it issues, so the Release names the chart release in infra.source_version and the catalog names none. The licence reaches the operator by reference to a Secret bound to the required license slot. The compiler validates no licence and contacts no vendor, so a clean build says nothing about one. Realized on Kubernetes by helm/kubestash-chart, AppsCode's own chart, whose chart repository must be reachable from the build; cert-manager must already run in the cluster.
Provenance
- Content digest
- sha256:2a58e01baa918ce576ced12b8a1ed6d62af656238aa63d787868529e3eb9e9bb
- Published
- 2026-11-10T10:14:05Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:c532b95bf5656fa62a1a7cc12aabce30a4a7297876f9fa735dbb3edb99ce1b0c
Reference at this version
oci://hub.aggrega.ai/component/core/storage/kubestash:1.0.0Developer parameters
Values the developer sets in the Aggregate.
No developer parameters declared.
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| source_version | string | — | yes | Version of AppsCode's KubeStash chart the `kubestash-chart` realization pulls, such as v2026.10.12; the chart release decides the operator's image and every backup job's image. There is no default, because access to KubeStash is governed by AppsCode's terms rather than by the catalog, and the catalog therefore names none. A build that omits it halts. The realization's value mapping was read against v2026.10.12, and a release that changes the chart's values may not take it. |
Output contract
Values this component publishes to consumers over the uses topology.
No output values declared.
Uses sockets
The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.
No uses sockets declared.
Attachment slots
Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.
| Slot | Selector | Required | Inject | Sensitive | Description |
|---|---|---|---|---|---|
| license | feature.aggrega.ai/kind=secret | yes | — | yes | The KubeStash licence AppsCode issues for the cluster, held in a Kubernetes Secret this attachment names under the data key key.txt, in the namespace the operator runs in: the operator reads it by reference to that Secret, never as a value written into the Release or the rendered output. Required: the build halts when no attachment binds it, and when the attachment publishes a data key other than key.txt. |
Self-inject allowlist
No self-inject pipes declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
This entity uses nothing in the catalog.
Used by
uses socket «upstream»
uses socket «forward_target»
uses socket «scrape_target»
uses socket «store»
applies to
applies to
applies to
applies to
applies to
applies to
applies to
implements