aenix-io / talos-bootstrap

An interactive Talos Linux installer

talos-bootstrap

An interactive script for bootstrapping Kubernetes clusters on Talos OS.

Example: bootstrap full-feature Kubernetes cluster in 5 minutes:

Installation

Install dependencies:

• talosctl (>=1.6.0)
• dialog
• nmap

Install talos-bootstrap:

curl -LO https://github.com/aenix-io/talos-bootstrap/raw/master/talos-bootstrap
chmod +x ./talos-bootstrap
sudo mv ./talos-bootstrap /usr/local/bin/talos-bootstrap

Usage

• Boot your nodes with Talos in maintenance mode.
  (booting from ISO or PXE using matchbox is the best option)
• Create a directory for holding your cluster configuration.
• Run talos-bootstrap command for every node in your cluster.

Options

USAGE:
        talos-bootstrap ACTION [OPTIONS]

ACTIONS:
        help            Show this help message.
        install         Setup a node for a new or existing cluster.
        upgrade         Upgrade a node in an existing cluster.
        reset           Reset and remove a node from an existing cluster.
        reboot          Reboot a node.
        shutdown        Shutdown a node.
        dashboard       Open dashboard for a node.

OPTIONS:
        -n, --node <address>    Node address

Customizations

You can specify your customizations in one of the following files:

• patch.yaml - common settings used for all nodes.
• patch-controlplane.yaml - settings used for controlplane nodes only
• patch-worker.yaml - settings used for worker nodes only

Read the Configuration Patches documentation for more details.

Advanced configuration management

Looking for enhanced, non-interactive version of talos-bootstrap?

Take a look at Talm project.

Copyright

Andrei Kvapil [email protected]
Licensed under Apache 2.0 License

talos-bootstrap's Issues

Issues running on MacOS

Getting the error when running talos-bootstrap install. On MacOS 13.6.6 talosctl version v1.6.7

❯ talos-bootstrap install
/usr/local/bin/talos-bootstrap: line 126: syntax error near unexpected token `;;'
/usr/local/bin/talos-bootstrap: line 126: `        case " ${seen} " in *" ${mac} "*) continue ;; esac # remove duplicated nodes'

Worker.yaml file has wrong type: controlplane

Hello,
I've bootstraped a server in controlplane mode with almost all the default configurations and no patch or config files present, after files generated, I've noticed the worker.yaml file has type: controlplane instead of type: worker inside of it(but it is a correct worker file in other parts).
I think it's a bug, could you take a look at it?

LACP bonding support

Add the option to select multiple interfaces and configure bonding on them

talosctl: This program can only be run on AMD64 processors with v3 microarchitecture support

We should check if user able to run talosctl before the main script logic.
And if not to provide reliable error message with detailed instructions

Please add help flag

Please add -h or --help flags to get automatically generated help text