Document how to "join" controllers when external etcd is used

[twz123]

When using external etcd, k0s refuses to create controller join tokens:

$ k0s token create --role controller
Error: refusing to create token: cannot join controller into current storage 

This is because join tokens aren't needed in this case. Just spin up another controller with the same config and that's it.

This needs to be documented somewhere, and the CLI error message might be more helpful. It might even include a link to the (not yet existing) documentation for this.

[twz123]

As an adjacent observation, k0s allows join tokens for external MySQL or Postgres databases via kine. The situation for those storage types seems to be essentially the same as for external etcd. So I wonder if it would make more sense to simply allow join tokens for external etcd as well, or also refusing to create join tokens for any non-internal-etcd storage.

[jnummelin]

So I wonder if it would make more sense to simply allow join tokens for external etcd as well

IMO this would make sense

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[jnummelin]

This is because join tokens aren't needed in this case

They are needed. Through the k0s join api, authorized via the token, the other controllers get the shared CA etc. files

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[jnummelin]

Through the k0s join api, authorized via the token, the other controllers get the shared CA etc. files

Unless we document that in case of external etcd, one needs to copy over the CA etc files before booting the next controller.

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[alemairebe]

Wow, thanks for reporting the issue, I had the impression I was doing something wrong.

Trying to enable verbose logging wasn't helpful as well.
k0sctl is waiting on the join token which is never being issued as it is not supported !

[github-actions]

The issue is marked as stale since no activity has been recorded in 30 days

[twz123]

k0sctl is waiting on the join token which is never being issued as it is not supported !

@alemairebe Sorry, missed your comment. I've filed a k0sctl issue for that: k0sproject/k0sctl#825