TAK-OS Keel

Keel applies host operating-system configuration through Kubernetes NodeConfigs. Choose a starting point by role; commands use the supplied tak-os namespace.

Users: write and apply configurations

• User guide — first configuration, node selection, changes, verification and removal.
• NodeConfig reference — API fields, triggers and per-node status.
• Built-in handlers — file and package parameters, behavior and limits.
• Facts and templates — available data, helpers and examples.
• Local CLI — configure a filesystem without Kubernetes.

Administrators: install and operate Keel

• Administrator guide — access control, rollout, upgrades, recovery, backups and removal.
• Deployment — prerequisites, installation and Orbit Deploy.
• Operations — flags, scheduling, metrics, Events and probes.
• Troubleshooting — diagnose admission, node and handler failures.
• Admission — optional validation webhook, TLS and availability.
• Security — host privileges, trust boundaries and resource sizing.
• Kubernetes resources — installed objects, runtime writes and RBAC.

Developers: understand and extend Keel

• Design — reconciliation, facts collection and status persistence.
• Adding a type — implement and register a handler.
• Testing — Go checks and the disposable kind integration suite.