Frequently Asked Questions (FAQ)

Does ClusterTool include storage

By default ClusterTool ships with a single-node Longhorn setup pre-configured on the system-drive. Its storageClass gets used by any PVC by default

What are the network requirements of ClusterTool

All nodes are expected to be in the same local-area network.
While we technically do support non-/24 subnets, we heavily advice a /24 subnet
We do not support nodes directly on a WAN-IP or kube-span related setups

How do I alter the default config to a multi-node setup?

Add more masternodes to talconfig
Add more MASTER_IPs to ClusterEnv
Alter the Longhorn replicas to 2 or 3

How do I seperate Masters from Slave nodes?

Set allowSchedulingOnControlPlanes: false in talconfig.yaml
On the metallb helmrelease, set ignoreExcludeLB: false

There are Pending pods for Cillium

We ship cillium pre-configured for multi-node, this means that on a single node they inherently keep a few pods pending

What commands do I need to run after updating clustertool?

init, genconfig and, preferably, apply (after checking the configuration changes)

What do I need to do to get automatic updates?

We’ve setup a lot for you already. However, to get updates to propagate we advice the use of FluxCD

Do I need to use FluxCD?

While its not technically required, we HEAVILY advice using FluxCD.

Can I remove helm-charts installed by default?

We HEAVILY adviced against it, the charts in the default stack all get loaded for cluster stability. In some cases, like kubernetes, you can disable the workloads or services in the charts themselves instead.

Can I alter the helmrelease files for default installed charts?

Yes you can! While we advice sticking with the defaults where possible, we fully support altering the included helm-charts to fit your usecase. However, any issues after alterations are not within our scope for support.

I get this error: failed to pull chart cilium: no cached repo found.

You need to remove all http helm repositories from the system you’re using clustertool on. Please check the Helm docs on how to do this.