v0.2.0

clusterctl v0.2.0

clusterctl now writes a first configuration for you, and the manual describes the release you install rather than what is on main.

What is new

• clusterctl config init [DIR] writes the least configuration that resolves: a Config with one context, a Site with a login node, a Cluster and an empty NodeInventory, one document to a file, with comments that say what to fill in. --site, --cluster, --domain, --login and --user set the names. Without DIR the files go where configuration is read from: the directory --config or CLUSTERCTL_CONFIG names, or else your own configuration directory, usually ~/.config/clusterctl. It writes only into an empty directory and never overwrites a file, and --dry-run lists the files without writing them. When no configuration is found, the error now points to it. clusterctl mcp does not offer it to an agent.
• A manual for every release. The manual at the root now describes the latest release, not main. Each minor line keeps its own manual under /vX.Y/, main's is under /dev/, and a switcher beside the title moves between them. The JSON Schemas that the $schema line of a configuration file names now describe the latest release too.

Upgrading from v0.1.0

Nothing needs to change. No command, flag, exit code or configuration field was changed or removed, the schema is still clusterctl/v1alpha1, and a configuration written for v0.1.0 loads as before. config init is for starting a new configuration: it refuses a directory that already holds one.

mise offers a release only once it is 24 hours old. To take this one sooner, name it:

$ mise use -g github:GSI-HPC/clusterctl@0.2.0

Download the binary for your platform below, or:

$ go install github.com/GSI-HPC/clusterctl/cmd/clusterctl@v0.2.0

Changelog

Features

• ebed487: feat(config): write a first configuration with config init (@claude)

Documentation

• c41acea: docs(install): make the release download and mise steps work as written (@claude)
• 87891ba: docs(readme): lead with the tagline and a link to the manual (@claude)
• b39bd0d: docs(site): publish a manual for every release, the latest at the root (@claude)
• 2fc5ccb: docs(site): redesign the front page of the manual (@claude)
• fc9d181: docs: name GSI as the copyright holder (@claude)

Other

• 5bcceb4: build(deps): Bump google.golang.org/grpc in the go-modules group (@dependabot[bot])

---

The manual covers every command.
Verify a download against checksums.txt.