@magistr/talm-cluster
v2026.03.13.1
Talos cluster lifecycle management via talm — init, configure, template nodes, apply configs, bootstrap, and health checks
Labels
talostalmkubernetesinfrastructurecluster
Contents
Quality score
How well-documented and verifiable this extension is.
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
Install
$ swamp extension pull @magistr/talm-cluster@magistr/talm-clusterv2026.03.13.1talm_cluster.ts
getClusterStateCheck cluster directory state — whether secrets, values, talosconfig, and kubeconfig exist
initInitialize talm cluster directory with preset
| Argument | Type | Description |
|---|---|---|
| name | string | Cluster name |
| preset | string | Talm preset (default: cozystack) |
configureUpdate values.yaml in the cluster directory
| Argument | Type | Description |
|---|---|---|
| endpoint | string | API server endpoint URL (e.g., https://192.168.88.17:6443) |
| floatingIP | string | Floating/VIP IP for the cluster |
| image | string | Talos install image (e.g., ghcr.io/cozystack/cozystack/talos:v1.10.5) |
| podSubnets | string | Pod CIDR |
| serviceSubnets | string | Service CIDR |
| advertisedSubnets | string | Advertised subnet for BGP/routing |
templateNodeGenerate node config from template using talm template (retries on connection errors)
| Argument | Type | Description |
|---|---|---|
| nodeIP | string | Node IP address |
| template | string | Template file path (relative to cluster dir) |
| outputFile | string | Output file path (relative to cluster dir) |
| installDisk | string | Install disk device (talm auto-discovers /dev/sr0 for CD-ROM which is wrong) |
applyApply node config using talm apply
| Argument | Type | Description |
|---|---|---|
| nodeFile | string | Node config file path (relative to cluster dir) |
| insecure | boolean | Use --insecure flag for maintenance mode |
bootstrapBootstrap the cluster using talosctl (post-apply, nodes on port 50000)
| Argument | Type | Description |
|---|---|---|
| endpoint | string | Node endpoint IP to bootstrap |
kubeconfigRetrieve kubeconfig from a node via talosctl
| Argument | Type | Description |
|---|---|---|
| endpoint | string | Node endpoint IP |
| outputFile | string | Output file name (relative to cluster dir) |
healthCheck cluster health via talosctl using cluster talosconfig
| Argument | Type | Description |
|---|---|---|
| waitTimeout | string | How long to wait for health (e.g., 30s, 5m, 10m) |
| endpoint | string | Node endpoint IP to check |
Resources
result(1h)— Command execution output
nodeConfig(infinite)— Generated node configuration file path