chalkctl node revoke¶
Cuts a node off the cluster by name, at once and without a rotation. A control plane lists the node, with the time of its first revocation, in the ConfigMap kube-system/chalkos-revoked-nodes and deletes its Node object. From then on the control planes renew none of its certificates, the API server denies every write by its kubelet, and chalkctl rotate skips it. Its certificates stay valid until they expire, so its kubelet can still read what every kubelet may. See Revoking a node cuts off its writes and renewals.
Revoking a control plane does not cut it off, because its disk holds the node CA's and the Kubernetes CA's keys. The command refuses a node that is still an etcd member, and the control plane --via names: take it out with chalkctl etcd leave, or chalkctl etcd remove-member once it is gone, then rotate os-ca and kubernetes-ca. A cluster without Kubernetes keeps no revoked nodes, and there chalkctl rotate os-ca cuts a node off.
The command first asks every other control plane whether it reads the revoked nodes, and refuses while one does not answer or does not say it read them. --force revokes the node despite either refusal. A control plane revokes the node: --via, or the first other one that answers. The command needs an admin client file or the secrets file.
Flags¶
| Flag | Type | Default | Description |
|---|---|---|---|
--address |
list of [NODE=]ADDR | each node's address in the inventory | Address of a node's chalkd: host or host:port for the node the command names, or NODE=ADDR for any node; may be repeated. |
--config |
string | $CHALKOSCONFIG, else ~/.config/chalkos/config, unless --secrets is given | Client file to authenticate with instead of the secrets file. |
--force |
boolean | false |
Revoke the node although it is a control plane, an etcd member or the one --via names, or although a control plane cannot read the revoked nodes. |
--identity |
list of string | ~/.config/chalkos/age.key, ~/.ssh/id_ed25519, ~/.ssh/id_rsa | File holding an age identity to decrypt the secrets with; may be repeated. |
--inventory |
string | $CHALKOSINVENTORY, else chalkos.yaml in the current directory, when it exists | Inventory naming the cluster's nodes, their addresses and their config files. |
--secrets |
string | — | Cluster secrets path (.age, .enc.*, or plaintext), provider URI, or - for standard input. |
--via |
string | the first other one that answers | Control plane that revokes the node. |
Examples¶
See also¶
- chalkctl node: Manage a node's access, activate its staged image, reboot it and show its diagnostics and routes