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

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
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.0

Developer parameters

Values the developer sets in the Aggregate.

No developer parameters declared.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
source_versionstring—yesVersion 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.

SlotSelectorRequiredInjectSensitiveDescription
licensefeature.aggrega.ai/kind=secretyes—yesThe 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

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy