Files
git.stella-ops.org/docs/modules/export-center
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
prep docs and service updates
2025-11-21 06:56:36 +00:00
..
2025-11-21 06:56:36 +00:00

StellaOps Export Center

Export Center packages reproducible evidence bundles (JSON, Trivy DB, mirror) with provenance metadata and optional signing for offline or mirrored deployments.

Responsibilities

  • Coordinate export jobs based on profiles and scope selectors.
  • Assemble manifests, provenance documents, and cosign signatures.
  • Stream bundles via HTTP/OCI and stage them for Offline Kit uses.
  • Expose CLI/API surfaces for automation.

Key components

  • StellaOps.ExportCenter.WebService planner.
  • StellaOps.ExportCenter.Worker bundle builder.
  • Adapters in StellaOps.ExportCenter.* for JSON/Trivy/mirror variants.

Profiles at a glance

  • json:raw / json:policy — Evidence bundles with raw ingestion facts or policy overlays.
  • trivy:db / trivy:java-db — Trivy-compatible vulnerability feeds with deterministic manifests.
  • mirror:full / mirror:delta — OCI-style mirrors with provenance, TUF metadata, and optional encryption.
  • devportal:offline — Developer portal static assets, specs, SDKs, and changelogs packaged with manifest.json, checksums.txt, helper scripts, and a DSSE-signed manifest (manifest.dsse.json) for offline verification.

Integrations & dependencies

  • Concelier/Excititor/Policy data stores for evidence.
  • Signer/Attestor for provenance signing.
  • CLI for operator-managed exports.

Operational notes

  • Runbooks in ./operations/ for deployment and monitoring.
  • Mirror bundle instructions and validation notes.
  • Telemetry dashboards for export latency and retry rates.
  • ./operations/runbook.md
  • ./devportal-offline.md (bundle structure, verification workflow, DSSE signature details)
  • ./provenance-and-signing.md (manifest/provenance schema, signing pipeline, verification)

Backlog references

  • DOCS-EXPORT-35-001 … DOCS-EXPORT-37-002 in ../../TASKS.md.
  • EXPORT-ATTEST-75-002 cross-team deliverable.

Epic alignment

  • Epic 10 Export Center: deliver canonical JSON, Trivy DB, and mirror bundle workflows with provenance, signatures, and offline parity.