Traefik add-on
Traefik-based Kubernetes ingress controller. Catalog version: v3.2.1.
Exact release scope. This page documents the reviewed v0.0.1 source at fcc5871. Check release status before enabling a gated capability.
Catalog contract
| Field | Value |
|---|---|
| Key | traefik |
| Version | v3.2.1 |
| Category | Ingress |
| v0.0.1 posture | Install preview · gated |
| Upgrade / uninstall | Contract stubs; no OperationRun |
Traefik-based Kubernetes ingress controller.
Before planning
- ✓Cluster state is ReadyForAddons and no conflicting lifecycle operation is active
- ✓The add-on artifact and every required image have immutable approved identities
- ✓No catalog-level dependency; still review environment prerequisites
- ✓Conflict: ingress-nginx
- ✓Required SecretRefs exist and values are never copied into plan input
Operator values
The catalog exposes a validated values schema. Unknown or secret-shaped plain values should fail before install.
| Value | Use |
|---|---|
chartRef | Review and set only when required by the selected profile |
healthGatePolicy | Review and set only when required by the selected profile |
releaseName | Review and set only when required by the selected profile |
Plan, preflight and install
- 01
Select the catalog entry
Confirm key, version, source identity, dependencies, conflicts and dashboard capability.
- 02
Create an AddonPlan
Review ordered issues, namespace, values profile, artifacts and images.
- 03
Run preflight
Require cluster readiness, dependency, registry reachability, artifact lock and image lock evidence.
- 04
Install through the OperationRun
Use the compatible lifecycle agent and follow each Helm/apply and health step.
- 05
Accept semantic health
Do not stop at running pods; use the catalog health checks and retained evidence.
Dashboard and access
No curated dashboard in the v0.0.1 catalog.
Failure and recovery
| Failure | Safe response |
|---|---|
| Preflight blocked | Fix dependency, lock, registry, secret reference or cluster readiness; create no install run |
| Install step failed | Use the OperationRun error and evidence; retry only a classified retryable step |
| Health gate failed | Keep dependants and dashboard access blocked; inspect semantic checks |
| Reapply required | Use the saved plan and targeted install/reapply path with a new approved intent |
| Removal required | v0.0.1 uninstall is not implemented; use an environment-approved manual runbook outside the claimed product capability |