Talm Cluster
@magistr/talm-clusterv2026.05.25.1
01README
Talos cluster lifecycle management via talm — init, configure, template nodes, apply configs, bootstrap, and health checks
02Release Notes
Merge pull request #4 from umag/extensions/magistr-grade-a-workspace
extensions: stage 15 @magistr extensions as Grade A workspace dirs + wire CI
03Models
@magistr/talm-clusterv2026.05.25.1talm_cluster.ts
fn getClusterState()
Check cluster directory state — whether secrets, values, talosconfig, and kubeconfig exist
fn init(name: string, preset: string)
Initialize talm cluster directory with preset
| Argument | Type | Description |
|---|---|---|
| name | string | Cluster name |
| preset | string | Talm preset (default: cozystack) |
fn configure(endpoint: string, floatingIP: string, image: string, podSubnets: string, serviceSubnets: string, advertisedSubnets: string)
Update values.yaml in the cluster directory
| Argument | Type | Description |
|---|---|---|
| endpoint | string | API server endpoint URL (e.g., https://192.0.2.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 |
fn templateNode(nodeIP: string, template: string, outputFile: string, installDisk: string)
Generate 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) |
fn apply(nodeFile: string, insecure: boolean)
Apply 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 |
fn bootstrap(endpoint: string)
Bootstrap the cluster using talosctl (post-apply, nodes on port 50000)
| Argument | Type | Description |
|---|---|---|
| endpoint | string | Node endpoint IP to bootstrap |
fn kubeconfig(endpoint: string, outputFile: string)
Retrieve kubeconfig from a node via talosctl
| Argument | Type | Description |
|---|---|---|
| endpoint | string | Node endpoint IP |
| outputFile | string | Output file name (relative to cluster dir) |
fn health(waitTimeout: string, endpoint: string)
Check 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
04Previous Versions
2026.03.13.1Mar 13, 2026
05Stats
A
100 / 100
Downloads
1
Archive size
8.7 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/umag/swamp-workspace06Platforms
07Labels