mirror of
https://github.com/rancher/k3k.git
synced 2026-08-19 04:16:16 +00:00
39cc69f3e3
* Add HCP (Hosted Control Plane) support Introduce hosted control plane mode for k3k virtual clusters, including API types, controller logic, server endpoint handling, CLI flags, CRD updates, kubeconfig generation, and examples. Co-Authored-By: RuFlo <ruv@ruv.net> * removed hcpRegitration command added HCP conformance tests warning for hcp fix multi-VM HCP conformance test networking Both QEMU workers booted with `-net user` and ended up registering the same InternalIP (10.0.2.15) because each VM gets its own isolated NAT slirp. Flannel propagated this to `public-ip` on both nodes, so VXLAN could not tunnel between workers and any cross-node pod traffic broke (89 failed / 335 passed of 424 conformance specs). Replace user-mode networking with a Linux bridge (k3kbr0, 192.168.100.0/24) and one TAP device per VM, so the two workers share an L2 segment with unique routable IPs. NAT outbound from the bridge keeps internet access working for image pulls. Also set unique hostnames via cloud-init (worker-1/worker-2) and drop the `--node-name` flag from INSTALL_K3S_EXEC, since k3s now picks the correct node name from the OS hostname on its own. Bump hydrophone back to `--parallel 4` to match the single-VM job (parallelism was reduced earlier when the failure was thought to be resource-related). added HCP print command updated crds adding e2e tests Refactor selectNonLoopbackSAN function to accept SANs directly and update related logic in ensureHCPRegistration * Update agent flag validation and enhance ingress host check with a warning log Refactor descriptions for cluster provisioning mode and role in CRDs and documentation Refactor logging in ServerURL function to use controller-runtime logger Rename selectNonLoopbackSAN to findNonLoopbackSAN for clarity and update references Refactor ServerURL function and related code to remove unused parameters and improve clarity Remove unused imports from kubeconfig.go to improve code clarity * suggested changes * fix comment * fix test --------- Co-authored-by: jpgouin <jeanphilippe.gouin@suse.com> Co-authored-by: RuFlo <ruv@ruv.net>
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
## k3kcli cluster create
|
|
|
|
Create a new cluster.
|
|
|
|
```
|
|
k3kcli cluster create [flags]
|
|
```
|
|
|
|
### Examples
|
|
|
|
```
|
|
k3kcli cluster create [command options] NAME
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
--agent-args strings agents extra arguments
|
|
--agent-envs strings agents extra Envs
|
|
--agents int number of agents
|
|
--annotations stringArray Annotations to add to the cluster object (e.g. key=value)
|
|
--cluster-cidr string cluster CIDR
|
|
--custom-certs string The path for custom certificate directory
|
|
-h, --help help for create
|
|
--kubeconfig-server string override the kubeconfig server host
|
|
--labels stringArray Labels to add to the cluster object (e.g. key=value)
|
|
--mirror-host-nodes Mirror Host Cluster Nodes
|
|
--mode string k3k mode type (shared, virtual, hcp) (default "shared")
|
|
-n, --namespace string namespace of the k3k cluster
|
|
--persistence-type string persistence mode for the nodes (dynamic, ephemeral) (default "dynamic")
|
|
--policy string The policy to create the cluster in
|
|
--server-args strings servers extra arguments
|
|
--server-envs strings servers extra Envs
|
|
--servers int number of servers (default 1)
|
|
--service-cidr string service CIDR
|
|
--storage-class-name string storage class name for dynamic persistence type
|
|
--storage-request-size string storage size for dynamic persistence type
|
|
--timeout duration The timeout for waiting for the cluster to become ready (e.g., 10s, 5m, 1h). (default 3m0s)
|
|
--tls-sans strings additional Subject Alternative Names for the cluster server TLS certificate
|
|
--token string token of the cluster
|
|
--version string k3s version
|
|
```
|
|
|
|
### Options inherited from parent commands
|
|
|
|
```
|
|
--debug Turn on debug logs
|
|
--kubeconfig string kubeconfig path ($HOME/.kube/config or $KUBECONFIG if set)
|
|
```
|
|
|
|
### SEE ALSO
|
|
|
|
* [k3kcli cluster](k3kcli_cluster.md) - K3k cluster command.
|
|
|