Durable Kubernetes changes belong under kubernetes/apps/<namespace>/<app> and must reach Git remote before Flux can apply them.
- Follow an existing application in same namespace.
- Render each touched Kustomization locally.
- Run Flux environment substitution for placeholders such as
${SECRET_DOMAIN}. - Validate manifests and inspect rendered namespaces.
- Test live only after explicit approval and suspend only exact owning Flux Kustomization when required.
- Verify workloads, routes, logs, and application behavior.
- Commit and push only when requested.
- Resume every suspended Kustomization and confirm applied Git revision.
Force Flux to pull current Git state when needed:
just kube reconcileInspect current state:
flux get sources git -A
flux get ks -A
flux get hr -ANever treat a local commit as deployed; Flux can only see pushed revisions.
- Attach public routes to
network/envoy-external. - Attach private routes to
network/envoy-internal. - Internal DNS for
aumer.devmust resolve through configured cluster DNS path. - Cilium provides networking, L7 policy support, and Hubble. Envoy Gateway remains Gateway API controller.
Useful checks:
kubectl -n network get gateway envoy-external envoy-internal
kubectl get httproutes -A
kubectl -n network get deploy envoy-gateway envoy-external envoy-internalAfter Envoy changes, both Gateways must report Accepted=True and Programmed=True. Affected HTTPRoutes must report Accepted=True and ResolvedRefs=True.
Renovate manages dependency updates through .renovaterc.json5. Review generated Flux diffs and rollout impact before merging. After an update reaches Git, verify affected HelmRelease, workloads, and application behavior rather than relying only on CI status.
See maintenance for operational checks and troubleshooting.