kueuectl create clusterqueue

概要

使用给定的名称创建一个 ClusterQueue。

kueuectl create clusterqueue NAME [--cohort=cohortname] [--queuing-strategy=StrictFIFO|BestEffortFIFO] [--namespace-selector=selector] [--reclaim-within-cohort=Never|Any|LowerPriority|LowerOrNewerEqualPriority] [--preemption-within-cluster-queue=Never|Any|LowerPriority|LowerOrNewerEqualPriority] [--nominal-quota=rfname1:resource1=value;resource2=value;resource3=value,rfname2:resource1=value;resource2=value] [--borrowing-limit=rfname1:resource1=value;resource2=value;resource3=value,rfname2:resource1=value;resource2=value] [--lending-limit=rfname1:resource1=value;resource2=value;resource3=value,rfname2:resource1=value;resource2=value] [--dry-run=server|client|none]

示例

  # Create a ClusterQueue 
  kueuectl create clusterqueue my-cluster-queue
  
  # Create a ClusterQueue with cohort, namespace selector and other details
  kueuectl create clusterqueue my-cluster-queue \
  	--cohort=cohortname \
	--queuing-strategy=StrictFIFO \
	--namespace-selector=fooX=barX,fooY=barY \
	--reclaim-within-cohort=Any \
	--preemption-within-cluster-queue=LowerPriority
  
  # Create a ClusterQueue with nominal quota and one resource flavor named alpha
  kueuectl create clusterqueue my-cluster-queue --nominal-quota=alpha:cpu=9;memory=36Gi
  
  # Create a ClusterQueue with multiple resource flavors named alpha and beta
  kueuectl create clusterqueue my-cluster-queue \
  	--nominal-quota=alpha:cpu=9;memory=36Gi;nvidia.com/gpu=10,beta:cpu=18;memory=72Gi;nvidia.com/gpu=20, \
	--borrowing-limit=alpha:cpu=1;memory=1Gi;nvidia.com/gpu=1,beta:cpu=2;memory=2Gi;nvidia.com/gpu=2 \
	--lending-limit=alpha:cpu=1;memory=1Gi;nvidia.com/gpu=1,beta:cpu=2;memory=2Gi;nvidia.com/gpu=2

选项

--allow-missing-template-keys     默认值:true

如果为 true,则在模板中缺少字段或映射键时忽略模板中的任何错误。仅适用于 golang 和 jsonpath 输出格式。

--borrowing-limit 字符串

此 ClusterQueue 允许从同一队列中的其他 ClusterQueue 的未使用配额中借用的 [flavor, resource] 组合的最大配额量。

--cohort 字符串

此 ClusterQueue 所属的队列。

-h, --help

clusterqueue 的帮助

--lending-limit 字符串

此 ClusterQueue 可以借给同一队列中的其他 ClusterQueue 的 [flavor, resource] 组合的最大未使用配额量。

--namespace-selector <逗号分隔的“key=value”对>     默认值:[]

定义哪些命名空间可以向此 clusterQueue 提交工作负载。

--nominal-quota 字符串

此 ClusterQueue 允许的工作负载在某个时间点可用的此资源数量。

-o, --output 字符串

输出格式。其中之一:(json, yaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file)。

--preemption-within-cluster-queue 字符串

确定不符合其 ClusterQueue 的名义配额的待处理工作负载是否可以抢占 ClusterQueue 中的活动工作负载。

--queuing-strategy 字符串

此 ClusterQueue 中队列中工作负载的排队策略。

--reclaim-within-cohort 字符串

确定待处理工作负载是否可以抢占队列中使用超过其名义配额的其他 ClusterQueue 的工作负载。

--show-managed-fields

如果为 true,则在以 JSON 或 YAML 格式打印对象时保留 managedFields。

--template 字符串

模板字符串或模板文件的路径,在使用 -o=go-template、-o=go-template-file 时使用。模板格式为 golang 模板 [https://golang.ac.cn/pkg/text/template/#pkg-overview]。

从父命令继承的选项

--as string

执行操作时要模拟的用户。用户可以是普通用户或命名空间中的服务帐号。

--as-group strings

执行操作时要模拟的组,此标志可以重复使用以指定多个组。

--as-uid string

执行操作时要模拟的 UID。

--cache-dir string     默认值:"$HOME/.kube/cache"

默认缓存目录

--certificate-authority string

证书颁发机构的证书文件的路径

--client-certificate string

TLS 的客户端证书文件的路径

--client-key string

TLS 的客户端密钥文件的路径

--cluster string

要使用的 kubeconfig 集群的名称

--context string

要使用的 kubeconfig 上下文的名称

--disable-compression

如果为 true,则退出对服务器的所有请求的响应压缩

--dry-run string     默认值:"none"

必须为 "none"、"server" 或 "client"。如果为客户端策略,则仅打印要发送的对象,而不发送。如果为服务器策略,则提交服务器端请求,而不保留资源。

--insecure-skip-tls-verify

如果为 true,则不会检查服务器的证书是否有效。这会使你的 HTTPS 连接不安全

--kubeconfig string

用于 CLI 请求的 kubeconfig 文件的路径。

-n, --namespace string

如果存在,则此 CLI 请求的命名空间范围

--request-timeout string     默认值:"0"

放弃单个服务器请求之前等待的时间长度。非零值应包含相应的时间单位(例如 1s、2m、3h)。零值表示不要超时请求。

-s, --server string

Kubernetes API 服务器的地址和端口

--tls-server-name string

用于服务器证书验证的服务器名称。如果未提供,则使用与服务器联系时使用的主机名

--token 字符串

API 服务器身份验证的持有者令牌

--user 字符串

要使用的 kubeconfig 用户的名称

另请参阅



上次修改时间 2024 年 7 月 18 日:添加了 kueuectl-docs 生成器。(#2613)(a3413404)