基础命令
K3d Cluster

k3d cluster 命令

管理集群

概述

管理集群

k3d cluster [标志]
选项
-h, --help:显示 cluster 子命令的帮助信息
从父命令继承的选项
--timestamps:启用日志时间戳
--trace:启用超级详细的输出(跟踪日志记录)
--verbose:启用详细输出(调试日志记录)

k3d cluster create 命令

创建一个新的集群

概述

使用容器化节点(在 Docker 中运行的 k3s)创建一个新的 k3s 集群。每个集群将由一个或多个容器组成:

  • 一个或多个服务器节点容器(k3s)
  • (可选)一个负载均衡器容器作为集群的入口点(Nginx)
  • (可选)一个或多个代理节点容器(k3s)
k3d cluster create NAME [标志]

选项

-a, --agents int:指定要创建的代理节点数量。
--agents-memory string:为代理节点设置内存限制(来自 Docker)。
--api-port [HOST:]HOSTPORT:指定在负载均衡器上暴露的 Kubernetes API 服务器端口(格式:[HOST:]HOSTPORT)。
示例:k3d cluster create --servers 3 --api-port 0.0.0.0:6550
-c, --config string:指定要使用的配置文件的路径。
-e, --env KEY[=VALUE][@NODEFILTER[;NODEFILTER...]]:为节点添加环境变量(格式:KEY[=VALUE][@NODEFILTER[;NODEFILTER...]])。
示例:k3d cluster create --agents 2 -e "HTTP_PROXY=my.proxy.com@server:0" -e "SOME_KEY=SOME_VAL@server:0"
--gpus string:为集群节点容器添加 GPU 设备(使用 all 表示传递所有 GPU)(来自 Docker)。
-h, --help:显示 create 子命令的帮助信息。
--host-alias ip:host[,host,...]:添加 ip:host[,host,...] 映射。
--host-pid-mode:启用服务器和代理节点的主机 PID 模式。
-i, --image string:指定用于节点的 k3s 镜像。
--k3s-arg ARG@NODEFILTER[;@NODEFILTER]:传递给 k3s 命令的额外参数(格式:ARG@NODEFILTER[;@NODEFILTER])。
示例:k3d cluster create --k3s-arg "--disable=traefik@server:0"
--k3s-node-label KEY[=VALUE][@NODEFILTER[;NODEFILTER...]]:为 k3s 节点添加标签(格式:KEY[=VALUE][@NODEFILTER[;NODEFILTER...]])。
示例:k3d cluster create --agents 2 --k3s-node-label "my.label@agent:0,1" --k3s-node-label "other.label=somevalue@server:0"
--kubeconfig-switch-context:直接将默认 kubeconfig 文件的当前上下文切换到新集群的上下文(需要 --kubeconfig-update-default)(默认值为 true)。
--kubeconfig-update-default:直接使用新集群的上下文更新默认 kubeconfig 文件(默认值为 true)。
--lb-config-override strings:使用点号分隔的 YAML 路径语法覆盖 Nginx 负载均衡器的设置。
--network string:加入一个现有的网络。
--no-image-volume:禁用用于导入镜像的卷的创建。
--no-lb:禁用在服务器节点前创建负载均衡器。
--no-rollback:如果出现问题,禁用自动回滚操作。
-p, --port [HOST:][HOSTPORT:]CONTAINERPORT[/PROTOCOL][@NODEFILTER]:将节点容器(通过服务器负载均衡器)的端口映射到主机(格式:[HOST:][HOSTPORT:]CONTAINERPORT[/PROTOCOL][@NODEFILTER])。
示例:k3d cluster create --agents 2 -p 8080:80@agent:0 -p 8081@agent:1
--registry-config string:指定额外的 registries.yaml 文件的路径。
--registry-create NAME[:HOST][:HOSTPORT]:创建一个由 k3d 管理的镜像仓库并将其连接到集群(格式:NAME[:HOST][:HOSTPORT])。
示例:k3d cluster create --registry-create mycluster-registry:0.0.0.0:5432
--registry-use stringArray:连接到一个或多个本地运行的由 k3d 管理的镜像仓库。
--runtime-label KEY[=VALUE][@NODEFILTER[;NODEFILTER...]]:为容器运行时添加标签(格式:KEY[=VALUE][@NODEFILTER[;NODEFILTER...]])。
示例:k3d cluster create --agents 2 --runtime-label "my.label@agent:0,1" --runtime-label "other.label=somevalue@server:0"
--runtime-ulimit NAME[=SOFT]:[HARD]:为容器运行时添加 ulimit 限制(格式:NAME[=SOFT]:[HARD])。
示例:k3d cluster create --agents 2 --runtime-ulimit "nofile=1024:1024" --runtime-ulimit "noproc=1024:1024"
-s, --servers int:指定要创建的服务器节点数量。
--servers-memory string:为服务器节点设置内存限制(来自 Docker)。
--subnet 172.28.0.0/16:[实验性:IPAM] 为新创建的容器网络定义一个子网(示例:172.28.0.0/16)。
--timeout duration:如果在指定时间内无法创建集群,则回滚更改。
--token string:指定一个集群令牌。默认情况下,会自动生成一个。
-v, --volume [SOURCE:]DEST[@NODEFILTER[;NODEFILTER...]]:将卷挂载到节点上(格式:[SOURCE:]DEST[@NODEFILTER[;NODEFILTER...]])。
示例:k3d cluster create --agents 2 -v /my/path@agent:0,1 -v /tmp/test:/tmp/other@server:0
--wait:在返回之前等待服务器节点准备就绪。使用 --timeout DURATION 避免无限期等待(默认值为 true)。

从父命令继承的选项

--timestamps:启用日志时间戳。
--trace:启用超级详细的输出(跟踪日志记录)。
--verbose:启用详细输出(调试日志记录)。

k3d cluster delete 命令

删除集群。

概述

删除集群。

k3d cluster delete [NAME [NAME ...] | --all] [标志]

选项

-a, --all:删除所有现有的集群。
-c, --config string:指定要使用的配置文件的路径。
-h, --help:显示 delete 子命令的帮助信息。
从父命令继承的选项
--timestamps:启用日志时间戳。
--trace:启用超级详细的输出(跟踪日志记录)。
--verbose:启用详细输出(调试日志记录)。

k3d cluster edit 命令

[实验性] 编辑集群。

概述

[实验性] 编辑集群。

k3d cluster edit CLUSTER [标志]

选项

-h, --help:显示 edit 子命令的帮助信息。
--port-add [HOST:][HOSTPORT:]CONTAINERPORT[/PROTOCOL][@NODEFILTER]:[实验性] 将节点容器(通过服务器负载均衡器)的端口映射到主机(格式:[HOST:][HOSTPORT:]CONTAINERPORT[/PROTOCOL][@NODEFILTER])。
示例:k3d node edit k3d - mycluster - serverlb --port - add 8080:80
从父命令继承的选项
--timestamps:启用日志时间戳。
--trace:启用超级详细的输出(跟踪日志记录)。
--verbose:启用详细输出(调试日志记录)。

k3d cluster list 命令

列出集群

概述

列出集群。

k3d cluster list [NAME [NAME...]] [标志]

选项

-h, --help:显示 list 子命令的帮助信息。
--no-headers:禁用表头输出。
-o, --output string:输出格式。可选值为:json 或 yaml。
--token:打印 k3s 集群令牌。
从父命令继承的选项
--timestamps:启用日志时间戳。
--trace:启用超级详细的输出(跟踪日志记录)。
--verbose:启用详细输出(调试日志记录)。

k3d cluster start 命令

启动现有的 k3d 集群

概述

启动现有的 k3d 集群

k3d cluster start [NAME [NAME...] | --all] [标志]

选项

-a, --all:启动所有现有的集群。
-h, --help:显示 start 子命令的帮助信息。
--timeout duration:在使用 --wait 选项时,设置在取消操作或返回结果之前的最大等待时间。
--wait:在返回结果之前,等待服务器节点(和负载均衡器)准备就绪。(默认值为 true)
从父命令继承的选项
--timestamps:启用日志时间戳。
--trace:启用超级详细的输出(跟踪日志记录)。
--verbose:启用详细输出(调试日志记录)。

k3d cluster stop 命令

停止现有的 k3d 集群

概述

停止现有的 k3d 集群。

k3d cluster stop [NAME [NAME...] | --all] [标志]

选项

-a, --all:停止所有现有的集群。
-h, --help:显示 stop 子命令的帮助信息。
从父命令继承的选项
--timestamps:启用日志时间戳。
--trace:启用超级详细的输出(跟踪日志记录)。
--verbose:启用详细输出(调试日志记录)。