Files
k3k/docs/cli/cli-docs.md
Hussein Galal 510ab4bb8a Add extra env for servers/agents (#324)
* Add extra env for servers/agents

Signed-off-by: galal-hussein <hussein.galal.ahmed.11@gmail.com>

* wsl

Signed-off-by: galal-hussein <hussein.galal.ahmed.11@gmail.com>

* cli docs

Signed-off-by: galal-hussein <hussein.galal.ahmed.11@gmail.com>

* Fix container env

Signed-off-by: galal-hussein <hussein.galal.ahmed.11@gmail.com>

---------

Signed-off-by: galal-hussein <hussein.galal.ahmed.11@gmail.com>
2025-04-21 12:25:51 +02:00

3.3 KiB

NAME

k3kcli - CLI for K3K

SYNOPSIS

k3kcli

[--debug]
[--kubeconfig]=[value]
[--namespace]=[value]

Usage:

k3kcli [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]

GLOBAL OPTIONS

--debug: Turn on debug logs

--kubeconfig="": kubeconfig path (default: $HOME/.kube/config or $KUBECONFIG if set)

--namespace="": namespace to create the k3k cluster in

COMMANDS

cluster

cluster command

create

Create new cluster

k3kcli cluster create [command options] NAME

--agent-args="": agents extra arguments

--agent-envs="": agents extra Envs

--agents="": number of agents (default: 0)

--cluster-cidr="": cluster CIDR

--clusterset="": The clusterset to create the cluster in

--debug: Turn on debug logs

--kubeconfig="": kubeconfig path (default: $HOME/.kube/config or $KUBECONFIG if set)

--kubeconfig-server="": override the kubeconfig server host

--mode="": k3k mode type (shared, virtual) (default: "shared")

--namespace="": namespace to create the k3k cluster in

--persistence-type="": persistence mode for the nodes (dynamic, ephemeral, static) (default: "dynamic")

--server-args="": servers extra arguments

--server-envs="": servers extra Envs

--servers="": number of servers (default: 1)

--service-cidr="": service CIDR

--storage-class-name="": storage class name for dynamic persistence type

--token="": token of the cluster

--version="": k3s version

delete

Delete an existing cluster

k3kcli cluster delete [command options] NAME

--debug: Turn on debug logs

--keep-data: keeps persistence volumes created for the cluster after deletion

--kubeconfig="": kubeconfig path (default: $HOME/.kube/config or $KUBECONFIG if set)

--namespace="": namespace to create the k3k cluster in

clusterset

clusterset command

create

Create new clusterset

k3kcli clusterset create [command options] NAME

--debug: Turn on debug logs

--display-name="": The display name of the clusterset

--kubeconfig="": kubeconfig path (default: $HOME/.kube/config or $KUBECONFIG if set)

--mode="": The allowed mode type of the clusterset (default: "shared")

--namespace="": namespace to create the k3k cluster in

delete

Delete an existing clusterset

k3kcli clusterset delete [command options] NAME

--debug: Turn on debug logs

--kubeconfig="": kubeconfig path (default: $HOME/.kube/config or $KUBECONFIG if set)

--namespace="": namespace to create the k3k cluster in

kubeconfig

Manage kubeconfig for clusters

generate

Generate kubeconfig for clusters

--altNames="": altNames of the generated certificates for the kubeconfig

--cn="": Common name (CN) of the generated certificates for the kubeconfig (default: "system:admin")

--config-name="": the name of the generated kubeconfig file

--debug: Turn on debug logs

--expiration-days="": Expiration date of the certificates used for the kubeconfig (default: 356)

--kubeconfig="": kubeconfig path (default: $HOME/.kube/config or $KUBECONFIG if set)

--kubeconfig-server="": override the kubeconfig server host

--name="": cluster name

--namespace="": namespace to create the k3k cluster in

--org="": Organization name (ORG) of the generated certificates for the kubeconfig