Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/skills/k0s-sysext-ops.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,8 @@ k0s kubectl get pods -A
- **Extension not merged**: Check `systemd-sysext status`. Verify the persistent image is `/var/lib/k0s/k0s.raw`; the boot activation unit copies it into `/run/extensions/k0s.raw`.
- **Manifests not applied**: Check `/var/lib/k0s/manifests/`. Ensure files end in `.yaml` (not `.yml`).
- **Service failed**: Check `journalctl -u k0scontroller -e`.
- **`argocd-server` stuck at `0/1` with `connection refused` on `/healthz`**: it is waiting on a dependency, not the probe. Confirm `argocd-redis`, `argocd-repo-server` and `argocd-application-controller` are `Running`, then check `k0s kubectl -n argocd logs deploy/argocd-server` for RBAC `forbidden` errors — the server only binds `:8080` once its configmap/secret and Application informers have synced.
- **An Argo CD component cannot reach redis**: the `argocd-redis` NetworkPolicy allows ingress on `6379` only from pods labelled `app.kubernetes.io/name in (argocd-server, argocd-repo-server, argocd-application-controller)`. redis carries no `requirepass`, so that policy is the only thing keeping the cache private from the KubeStellar and Postgres workloads sharing this node — widen the label set rather than deleting the policy. If `argocd-redis` itself never goes `Ready`, suspect the kubelet `tcpSocket` probe: it dials from the node, not from a pod, and needs the CNI's local-node exemption. Check enforcement with `k0s kubectl -n argocd describe networkpolicy argocd-redis`.

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/skills/k0s-sysext.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Design choices:
| `files/k0s/sysext/k0scontroller.service` | systemd unit for the k0s single-node controller/worker. Not enabled by default. |
| `files/k0s/sysext/extension-release.k0s` | Static sysext identity (`ID=_any`); `VERSION_ID=`/`ARCHITECTURE=` are appended at build time. |
| `files/k0s/sysext/k0s-manifests.conf` | tmpfiles rule that copies declarative stacks to `/var/lib/k0s/manifests/`. |
| `files/k0s/manifests/argocd/` | Raw YAML manifests for Argo CD. |
| `files/k0s/manifests/argocd/` | Raw YAML manifests for the Argo CD core stack: CRDs, RBAC, redis, repo-server, application controller, and server. All four workloads are required — the server blocks on its informers and never binds `:8080` without them. |
| `files/k0s/manifests/kubestellar/` | Raw YAML manifests for KubeFlex, Postgres, KubeStellar core, and Console. |
| `files/os/sysupdate.k0s.d/70-k0s.transfer` | sysupdate transfer track for the k0s sysext component. |
| `Justfile` | `build-sysext` / `export-sysext` targets. |
Expand Down
Loading
Loading