ConfigHub Examples

This repo contains runnable examples for ConfigHub.

Safe First Checks

For a read-only first pass:

./scripts/verify.sh
cub context list --json
cub space list --json
cub target list --space "*" --json

If you are not logged in yet, run cub auth login before the cub commands.

Stable Paths

• promotion-demo-data: quickest no-cluster demo data for learning ConfigHub's App-Deployment-Target model and promotion flow.
• gitops-import: canonical Argo CD GitOps import example and docs companion.
• initiatives-demo: 5 compliance initiatives backed by Kyverno CEL policies, with sample Kubernetes units to evaluate.
• custom-workers: worker extension examples, including bridge, function, and policy workers.
• global-app: classic multi-service app example.
• helm-platform-components: platform component example for Helm-managed infrastructure.
• vm-fleet: VM fleet operations example.

Recommended Starting Points

• If you want to explore Initiatives and compliance workflows, start with initiatives-demo.
• If you want the quickest no-cluster path, start with promotion-demo-data.
• If you want to understand Generators as functions on config data, start with spring-platform, then move to cub-gen/examples/springboot-paas for the product path, including the Spring ConfigHub Initiative GUI proof.
• If you want GitOps import, start with gitops-import and the Official GitOps Import docs.
• If you want worker extensibility, start with custom-workers.
• If you want a classic multi-service example, use global-app.

Note on contract standard: EXAMPLE_CONTRACT_STANDARD.md

Companion Material

Some other examples

• Agentic RBAC companion patterns: rbac-manager-for-agents, rbac-manager-over-redis, and redis-platform-with-rbac-guardrails
• Incubator and experimental paths: incubator/README.md
• App mutation and platform flow: spring-platform/springboot-platform-app-centric

cub-scout remains useful as companion material and as a source of comparison fixtures:

• cub-scout examples index
• Apptique microservice examples