Skip to content
Browse Docs

Deep Dives

AI: Claude and Codex patterns

ConfigHub: Deploy and manage

Docs
Configs
Stacks
Apps
Plugins
Guides

Argo installation recipes and reusable component profiles

A repository document, rendered for the site. You can also view this as a markdown file.

Generated at: 2026-10-06T13:45:42.258Z UTC · source: committed helm-expt evidence for this rendered repository document.

Status: implementation in progress for #2043. Reviewed 30 September 2026.

User result

A person or agent describes where Argo will run, which teams may deploy where, and whether it will read ConfigHub. The tool produces explicit Helm values, AppProjects and unmet prerequisites. Users can inspect and render that result before deciding to install it. Credentials never belong to a reusable base.

The current source is the Catalog chart 10.2.1 / Argo CD v3.4.5, locked by the source receipt. The issue's 9.5.15 snapshot is older. Use the chart as the single rendering source; upstream install.yaml rehearsals do not qualify this chart revision. Do not mark these candidates supported by inheriting default-base evidence.

Delivery sequence

BlockConcrete resultEvidence requiredBoundary
1Four recipe choices with optional delivery settings, validated non-secret input and exact source identityUnit refusals and all eight Helm rendersStatic candidate only
2Safe bootstrap and delivery prerequisites satisfied without hand patchesSerial demo install, gateway sync, argobot refresh/status and plugin handover receiptsNeeds explicit targets and local credentials
3Hardened and hub qualificationAdmin denial, unmapped-user permissions, forbidden resource/repository/destination, sync-window and second-cluster testsNeeds test IdP and two targets
4Published Catalog bases and example reuseRender equivalence, scans, installer/lifecycle gates and publication receipts for exact candidatesUse existing proof generators; no hand-edited receipt digests
5Apply validated patterns to other componentsComponent-specific behavior and authority testsNo support claim from a common schema alone

Block 1 uses bounded lower-cost implementation and review. Planning envelope: roughly 15–30k agent tokens for implementation/audit, plus primary integration and review; actual credits depend on cache and account pricing and are not measured here. Avoid repeated broad gates after unchanged code. Later live blocks need an environment inventory before a defensible cost estimate.

Decisions and safeguards

Keep topology, posture and delivery independently expressed, but flatten their result into explicit objects. Do not require a ConfigHub Space per layer just to inspect a candidate. Sharing layers at authoring time and storing a release as explicit data are compatible. Preserve input and source hashes so a later session can reconstruct what produced it.

The four names are demo-in-cluster, demo-hub, hardened-in-cluster and hardened-hub. Their names describe intent, not production certification. Delivery enabled doubles the render matrix to eight combinations. Unknown input fields must fail instead of silently becoming ignored settings.

Hardened candidates close the default AppProject, scope tenant destinations and resource types, and keep platform privileges separate. Readonly is broad read visibility, not tenant secrecy. Disabling admin before a working IdP is available can lock out operators; offline rendering cannot establish access. An isolated platform project must not grant tenant applications access to the Argo control-plane namespace or cluster administration.

ConfigHub delivery settings alone do not install argobot, provision worker credentials, register clusters or overcome a Git-managed project's self-heal. Modify the authoritative source of each AppProject before handing it over. Enabling Helm inside Kustomize is optional and expands repo-server execution; a named Kustomize binary path requires a verified image/binary prerequisite.

No Secret import/export is implemented by this candidate builder. Future credential handling must reject persisted Secret bytes in both data fields and last-applied annotations, including retained bundles and diagnostic logs. Use external Secret references and validate the actual reader's auth behavior.

Wider applications

ComponentReusable questionComponent-specific proof
FluxTenant identity, destinations and source permissionsCross-namespace denial, service-account impersonation and reconcile authority
SveltosManagement/managed-cluster topology and delegated identityProfile permission boundaries, Secret handling and live status
cert-managerIssuer scope and tenant permissionUnauthorized issuance refused; webhook and renewal behavior
External SecretsWho can read which storeCross-tenant reads refused and refresh/rotation behavior
MonitoringMinimal component needs versus broad default bundleApp discovery and actual scrape success, not only ServiceMonitor rendering
GPU infrastructureOperator ownership, target hardware and app requirementsCompatible target, rollout and recovery evidence; no hardware inference from values

These become useful Catalog facets: topology, posture intent, delivery mode, required facts, exact versions and evidence level. A future Workshop/Pilot consumer can ask for missing facts and propose a candidate through the same CLI/API contract. It must not advertise a runnable platform when credentials, operators or live checks are absent. No Pilot change is needed for this block.

Do not generate every cross-product of every component. First prove one useful recipe, then share only the controls with genuinely common semantics. HA, federated Argo agents, apps-in-any-namespace, self-management, namespaced installs, backup/restore and other Argo charts remain separate qualification work. They are not consequences of an in-cluster/hub label.

Sources

Upstream documentation informs the design; pinned render receipts and live behavior determine what this repository can claim.

Generated from the committed markdown file docs/planning/argo-install-recipes.md. The source file is the authoritative version.