Release

Releases are a point-in-time snapshot of configuration stored as an OCI image. A Release bundles the Units in a Space that are assigned to the Space's release Target (its ReleaseTargetID), capturing each Unit either at its head Revision or at a specified tagged one.

Each Release carries a ReleaseNum — a sequence number that increments per Space — along with two OCI digests: ManifestDigest for the image manifest and Digest for the compressed bundle layer. Each Release also either creates a Tag or uses the one provided, associating it with the bundled Revisions.

The OCI URL for each Space's Releases can be found via the Space.ReleaseURL, with either the latest OCI tag or a specific digest. latest will always serve the most recently created Release. This URL is used by OCI clients, such as ArgoCD or FluxCD, to consume the image and apply the configuration accordingly.