kuberc (v1alpha1)

资源类型

偏好设置

偏好设置存储 KubeRC 配置文件中的元素

字段描述
apiVersion
字符串
kubectl.config.k8s.io/v1alpha1
kind
字符串
偏好设置
overrides [必需]
[]CommandDefaults

overrides 允许更改命令的默认标志值。当用户不想每次都显式设置标志时,这非常有用。

aliases [必需]
[]AliasOverride

aliases 允许为现有的 kubectl 命令定义命令别名,并带有可选的默认标志值。如果别名名称与内置命令冲突,则内置命令始终优先。在 overrides 部分定义的标志覆盖不适用于相同命令的别名。kubectl [ALIAS NAME] [USER_FLAGS] [USER_EXPLICIT_ARGS] 将扩展为 kubectl [COMMAND] # 内置命令别名指向 [KUBERC_PREPEND_ARGS] [USER_FLAGS] [KUBERC_FLAGS] # 用户未传递的其余标志 [USER_FLAGS] [USER_EXPLICIT_ARGS] [KUBERC_APPEND_ARGS] 例如:

  • name: runx command: run flags
    • name: image default: nginx appendArgs

    • custom-arg1 例如,如果用户调用 "kubectl runx test-pod" 命令,这将扩展为 "kubectl run --image=nginx test-pod -- custom-arg1"
  • name: getn command: get flags
    • name: output default: wide prependArgs
    • node "kubectl getn control-plane-1" 将扩展为 "kubectl get node control-plane-1 --output=wide" "kubectl getn control-plane-1 --output=json" 将扩展为 "kubectl get node --output=json control-plane-1"

AliasOverride

出现于

AliasOverride 存储别名定义。

字段描述
name [必需]
字符串

name 是别名的名称,只能包含字母字符。如果别名名称与内置命令冲突,则使用内置命令。

command [必需]
字符串

command 是要执行的单个或一组命令,例如 "set env" 或 "create"

prependArgs [必需]
[]string

prependArgs 存储诸如资源名称等的参数。这些参数插入在别名名称之后。

appendArgs [必需]
[]string

appendArgs 存储诸如资源名称等的参数。这些参数附加到 USER_ARGS。

flags [必需]
[]CommandOptionDefault

flags 分配用于存储别名的标志定义。flags 仅修改标志的默认值,如果用户显式传递值,则使用显式值。

CommandDefaults

出现于

CommandDefaults 存储命令及其关联选项的默认值。

字段描述
command [必需]
字符串

command 指更改其标志默认值的命令。

flags [必需]
[]CommandOptionDefault

flags 是一个列表,用于存储不同的默认值。

CommandOptionDefault

出现于

CommandOptionDefault 存储选项的名称和指定的默认值。

字段描述
name [必需]
字符串

标志名称(长格式,不带破折号)。

default [必需]
字符串

默认值的字符串格式。kubectl 将其解析为标志兼容的值。

本页面是自动生成的。

如果您打算报告此页面的问题,请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

最后修改时间:2025年9月4日 下午5:02 PST:Config API for v1.34 (3557e3070d)