UNOFFICIAL/EXPERIMENTAL.
The rule is simple: do not treat a quiet wait as a single mystery. Break the operation into visible stages and record which stage is slow, passed, blocked, or still under watch.
What To Watch
Before upload or apply, note the object shape:
New to cub? Install the cub CLI first. Public catalog packages pull and render anonymously, and you sign in only once a command saves or changes ConfigHub data.
cub unit list --space <space>
kubectl --kubeconfig <kubeconfig> get all -ADuring cub installer upload, check that the ConfigHub Space and Units are appearing:
cub unit list --space <space>
cub unit tree --space <space>During cub unit apply --wait, separate ConfigHub apply progress from cluster and GitOps progress:
cub unit list --space <space>
cub unit livestate <unit> --space <space>
kubectl --kubeconfig <kubeconfig> get applications -n argocd
kubectl --kubeconfig <kubeconfig> get pods -AFor GitOps/OCI, check both the root application and the child resources:
kubectl --kubeconfig <kubeconfig> get applications -n argocd
kubectl --kubeconfig <kubeconfig> describe application <app> -n argocd
KUBECONFIG=<kubeconfig> cub-scout gitops status --jsonHow To Read The Result
Use a funnel:
- Rendered objects exist.
- Units uploaded to ConfigHub.
- OCI/GitOps source exists.
- GitOps controller syncs.
- Target facts and lifecycle prerequisites are present.
- Workloads converge.
- Controller aggregate health is explained.
If stages 1-6 pass but stage 7 remains unclear, the result is watch, not a render-parity failure. Consul currently demonstrates this: the root Argo Application can be Synced/Healthy, workloads can converge, semantic parity can pass, and a child resource such as the UI Ingress can still leave controller health in Progressing.
What To Capture
For large charts, a useful receipt or issue comment should include:
- chart, version, base, target, and delivery path;
- Unit count and main Kubernetes kinds;
- elapsed time for upload, apply, GitOps sync, and workload convergence when available;
- the exact command that was waiting;
- the first resource that stayed pending, blocked, or progressing;
- whether the residue is a parity defect, target prerequisite, controller health watch, or missing product progress signal.
Current Product Gap
The current CLI path does not always show enough progress for large operations. The desired product behavior is a progress stream or receipt fields that show which phase and Unit group are active. Until then, use the commands above to make the funnel visible.
Tracked in issue #714.