Skip to content

chalkctl

chalkctl installs and operates the nodes of a chalkos cluster. It reads the cluster from an inventory, which names each node, its address, its image and its config files: the file --inventory names, else the file $CHALKOSINVENTORY names, else chalkos.yaml in the current directory. It talks to chalkd on each node over mutual TLS, and never builds or signs images.

Commands authenticate with the cluster's secrets file, which holds every CA key and which only --secrets names, or with a client file of the admin, operator or reader role, which chalkctl client new writes. Each command's help says which it needs. A command that accepts both takes --config or --secrets, not both, else the client file $CHALKOSCONFIG names, else ~/.config/chalkos/config.

A command's flags go after its name, anywhere among its arguments, and -- ends them: every argument after it is read as a positional argument.

Examples

# Generate the cluster's secrets, install and bootstrap a control plane, write a kubeconfig.
chalkctl gen secrets --recipient age1...
chalkctl install cp1 --secrets secrets.age \
  --fingerprint 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
chalkctl bootstrap cp1 --secrets secrets.age
chalkctl kubeconfig --secrets secrets.age

See also