Skip to main content
← back to extensions

Talm Cluster

@magistr/talm-clusterv2026.10.25.10· MIT· 1d agoBEHAVIORS
01README

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

02Release Notes

2026.10.25.10

  • Repo-wide republish; no functional change.
03Behaviors1
@magistr/talm-clusterv2026.10.25.10extensions/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
preset?stringTalm 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)
podSubnets?stringPod CIDR
serviceSubnets?stringService CIDR
advertisedSubnets?stringAdvertised 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
template?stringTemplate file path (relative to cluster dir)
outputFilestringOutput file path (relative to cluster dir)
installDisk?stringInstall 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)
insecure?booleanUse --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
outputFile?stringOutput file name (relative to cluster dir)
fn health(waitTimeout?: string, endpoint: string)
Check cluster health via talosctl using cluster talosconfig
ArgumentTypeDescription
waitTimeout?stringHow 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 Versions15
2026.10.15.9MIT

2026.10.15.9

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.8MIT

2026.10.15.8

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.6MIT

2026.10.15.6

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.5MIT

2026.10.15.5

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.4MIT

2026.10.15.4

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.3MIT

2026.10.15.3

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.2MIT

2026.10.15.2

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.1MIT

2026.10.15.1

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.14.2MIT(was none)

2026.10.14.2

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.09.19.2

2026.09.19.2

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.09.17.1

2026.09.17.1

Changed

  • Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.08.19.1
2026.07.16.2

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.

Added 1, removed 1 behaviors

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
37
Archive size
9.4 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
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
Repository
https://github.com/umag/swamp-workspace
06Platforms
07Labels
#talos#talm#kubernetes#infrastructure#cluster