Skip to main content
← back to extensions

Talm Cluster

@magistr/talm-clusterv2026.07.16.2· 11d agoMODELS
01README

Talos cluster lifecycle management via talm — init, configure, template nodes, apply configs, bootstrap, and health checks

02Release Notes

Release 2026.07.16.2 — align model versions with manifests

Maintenance release across the @magistr extensions. For most packages this carries no functional change: the only edit is the model's version: field, brought back in line with its manifest version so the published model type version and the package version no longer drift.

Functional changes in this release are limited to:

  • anime-cron: normalizeTitle now strips a ": subtitle" suffix and a trailing parenthesized year before comparison, fixing dedup false-misses where the torrent title carries a subtitle or year that the AniList romaji does not.

  • arckit: first publish. Standalone ArcKit port — a 12-phase architecture governance state machine with 65 bundled templates, driven by a bundled skill.

Also tracks three extensions (kaiten, observability-agent, music-library) that previously existed only as untracked working-tree directories, recovered from stashes.

03Models1
@magistr/talm-clusterv2026.07.16.2extensions/models/talm_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
ArgumentTypeDescription
namestringCluster name
presetstringTalm preset (default: cozystack)
fn configure(endpoint: string, floatingIP: string, image: string, podSubnets: string, serviceSubnets: string, advertisedSubnets: string)
Update values.yaml in the cluster directory
ArgumentTypeDescription
endpointstringAPI server endpoint URL (e.g., https://192.0.2.17:6443)
floatingIPstringFloating/VIP IP for the cluster
imagestringTalos install image (e.g., ghcr.io/cozystack/cozystack/talos:v1.10.5)
podSubnetsstringPod CIDR
serviceSubnetsstringService CIDR
advertisedSubnetsstringAdvertised 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)
ArgumentTypeDescription
nodeIPstringNode IP address
templatestringTemplate file path (relative to cluster dir)
outputFilestringOutput file path (relative to cluster dir)
installDiskstringInstall 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
ArgumentTypeDescription
nodeFilestringNode config file path (relative to cluster dir)
insecurebooleanUse --insecure flag for maintenance mode
fn bootstrap(endpoint: string)
Bootstrap the cluster using talosctl (post-apply, nodes on port 50000)
ArgumentTypeDescription
endpointstringNode endpoint IP to bootstrap
fn kubeconfig(endpoint: string, outputFile: string)
Retrieve kubeconfig from a node via talosctl
ArgumentTypeDescription
endpointstringNode endpoint IP
outputFilestringOutput file name (relative to cluster dir)
fn health(waitTimeout: string, endpoint: string)
Check cluster health via talosctl using cluster talosconfig
ArgumentTypeDescription
waitTimeoutstringHow long to wait for health (e.g., 30s, 5m, 10m)
endpointstringNode endpoint IP to check

Resources

result(1h)— Command execution output
nodeConfig(infinite)— Generated node configuration file path
04Previous Versions2
2026.05.25.1

Merge pull request #4 from umag/extensions/magistr-grade-a-workspace

extensions: stage 15 @magistr extensions as Grade A workspace dirs + wire CI

2026.03.13.1
05Stats
A
100 / 100
Downloads
2
Archive size
9.0 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/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-workspace
06Platforms
07Labels
#talos#talm#kubernetes#infrastructure#cluster