Goal
Explain what a Software Pack is, how it integrates with NKP, and what role the NicApp Custom Resource plays. Conceptual level, not a build guide.
Scope
New explanation page(s) under docs/docs/explanations/ covering:
- What a pack is: a curated collection of open-source tools packaged as ArgoCD applications with a
NicApp CRD wrapper.
- Why packs exist: composable alternative to Classic's monolithic bundle; teams install only what they need (Data Science pack, Model Serving pack, etc.).
- The
NicApp CRD: declares a pack to the Nebari Operator so it can auto-wire routing (Envoy Gateway), authentication (Keycloak), TLS (cert-manager), and landing-page registration. No manual wiring required.
- Pack lifecycle: install via GitOps/ArgoCD, operator reconciles
NicApp resources, pack registers itself with the landing page dynamically.
- Distribution channels: official packs (OpenTeams, in central registry), customer packs (internal), community packs (separate listing, not central registry).
- Relationship to the Nebari Operator: operator watches
NicApp resources; without it, packs are just ArgoCD apps.
Out of scope
- Building a pack (pointer lives in catalog sub-issue).
NicApp CRD field-by-field reference (separate reference sub-issue).
- Per-pack documentation (packs own their own docs).
Acceptance criteria
Resources
Most authoritative (code-audited): AGENTS.md in nebari-infrastructure-core (PR #297).
Repos:
Example packs:
Design docs in nebari-infrastructure-core (some claims may be aspirational and not yet shipped; cross-check against AGENTS.md):
Goal
Explain what a Software Pack is, how it integrates with NKP, and what role the
NicAppCustom Resource plays. Conceptual level, not a build guide.Scope
New explanation page(s) under
docs/docs/explanations/covering:NicAppCRD wrapper.NicAppCRD: declares a pack to the Nebari Operator so it can auto-wire routing (Envoy Gateway), authentication (Keycloak), TLS (cert-manager), and landing-page registration. No manual wiring required.NicAppresources, pack registers itself with the landing page dynamically.NicAppresources; without it, packs are just ArgoCD apps.Out of scope
NicAppCRD field-by-field reference (separate reference sub-issue).Acceptance criteria
NicAppCRD's role is clear without requiring CRD schema knowledge.Resources
Most authoritative (code-audited):
AGENTS.mdinnebari-infrastructure-core(PR #297).Repos:
nicCLIExample packs:
Design docs in
nebari-infrastructure-core(some claims may be aspirational and not yet shipped; cross-check againstAGENTS.md):