kubeconfig (v1)

资源类型

配置

Config 包含构建并连接到远程 Kubernetes 集群所需的信息,以给定用户的身份

字段描述
apiVersion
字符串
/v1
kind
字符串
配置
kind
字符串

来自 pkg/api/types.go TypeMeta 的旧字段。 TODO(jlowdermilk): 在消除下游依赖项后删除此项。

apiVersion
字符串

来自 pkg/api/types.go TypeMeta 的旧字段。 TODO(jlowdermilk): 在消除下游依赖项后删除此项。

preferences [必需]
首选项

Preferences 包含用于 CLI 交互的通用信息

clusters [必需]
[]NamedCluster

Clusters 是可引用的名称到集群配置的映射

users [必需]
[]NamedAuthInfo

AuthInfos 是可引用的名称到用户配置的映射

contexts [必需]
[]NamedContext

Contexts 是可引用的名称到上下文配置的映射

current-context [必需]
字符串

CurrentContext 是您希望默认使用的上下文的名称

extensions
[]NamedExtension

Extensions 包含附加信息。这对于扩展器很有用,因此读取和写入不会覆盖未知字段

AuthInfo

出现在

AuthInfo 包含描述身份信息的信息。这是用来告诉 Kubernetes 集群您是谁。

字段描述
client-certificate
字符串

ClientCertificate 是 TLS 客户端证书文件的路径。

client-certificate-data
[]byte

ClientCertificateData 包含来自 TLS 客户端证书文件的 PEM 编码数据。覆盖 ClientCertificate

client-key
字符串

ClientKey 是 TLS 客户端密钥文件的路径。

client-key-data
[]byte

ClientKeyData 包含来自 TLS 客户端密钥文件的 PEM 编码数据。覆盖 ClientKey

token
字符串

Token 是用于身份验证到 Kubernetes 集群的持有者令牌。

tokenFile
字符串

TokenFile 是指向包含持有者令牌(如上所述)的文件的指针。如果 Token 和 TokenFile 都存在,则 Token 优先。

as
字符串

Impersonate 是要模拟的用户名。该名称与标志匹配。

as-uid
字符串

ImpersonateUID 是要模拟的 UID。

as-groups
[]string

ImpersonateGroups 是要模拟的组。

as-user-extra
map[string][]string

ImpersonateUserExtra 包含模拟用户的附加信息。

username
字符串

Username 是用于基本身份验证到 Kubernetes 集群的用户名。

password
字符串

Password 是用于基本身份验证到 Kubernetes 集群的密码。

auth-provider
AuthProviderConfig

AuthProvider 为 Kubernetes 集群指定自定义身份验证插件。

exec
ExecConfig

Exec 为 Kubernetes 集群指定自定义基于 exec 的身份验证插件。

extensions
[]NamedExtension

Extensions 包含附加信息。这对于扩展器很有用,因此读取和写入不会覆盖未知字段

AuthProviderConfig

出现在

AuthProviderConfig 保存指定身份验证提供程序的配置。

字段描述
name [必需]
字符串
未提供描述。
config [必需]
map[string]string
未提供描述。

集群

出现在

Cluster 包含有关如何与 Kubernetes 集群通信的信息

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

Server 是 Kubernetes 集群的地址 (https://hostname:port)。

tls-server-name
字符串

TLSServerName 用于检查服务器证书。如果 TLSServerName 为空,则使用用于联系服务器的主机名。

insecure-skip-tls-verify
布尔值

InsecureSkipTLSVerify 跳过对服务器证书的有效性检查。这将使您的 HTTPS 连接不安全。

certificate-authority
字符串

CertificateAuthority 是证书颁发机构的证书文件的路径。

certificate-authority-data
[]byte

CertificateAuthorityData 包含 PEM 编码的证书颁发机构证书。覆盖 CertificateAuthority

proxy-url
字符串

ProxyURL 是此客户端发出的所有请求要使用的代理的 URL。支持使用“http”、“https”和“socks5”方案的 URL。如果未提供此配置或为空字符串,则客户端会尝试从 http_proxy 和 https_proxy 环境变量构造代理配置。如果未设置这些环境变量,则客户端不会尝试代理请求。

socks5 代理目前不支持 spdy 流端点(exec、attach、端口转发)。

disable-compression
布尔值

DisableCompression 允许客户端选择退出对服务器的所有请求的响应压缩。当客户端-服务器网络带宽充足时,通过节省压缩(服务器端)和解压缩(客户端)的时间来加速请求(特别是列表)非常有用:https://github.com/kubernetes/kubernetes/issues/112296。

extensions
[]NamedExtension

Extensions 包含附加信息。这对于扩展器很有用,因此读取和写入不会覆盖未知字段

上下文

出现在

Context 是对集群(如何与 Kubernetes 集群通信)、用户(如何标识自己)和命名空间(我想使用哪个资源子集)的引用的元组

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

Cluster 是此上下文的集群名称

user [必需]
字符串

AuthInfo 是此上下文的 authInfo 的名称

namespace
字符串

Namespace 是在未指定请求时使用的默认命名空间

extensions
[]NamedExtension

Extensions 包含附加信息。这对于扩展器很有用,因此读取和写入不会覆盖未知字段

ExecConfig

出现在

ExecConfig 指定一个命令来提供客户端凭据。该命令被执行,并输出包含凭据的结构化 stdout。

有关确切的输入和输出格式的规范,请参阅 client.authentication.k8s.io API 组

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

要执行的命令。

args
[]string

在执行命令时传递给命令的参数。

env
[]ExecEnvVar

Env 定义要公开给进程的其他环境变量。这些与主机的环境以及 client-go 用于将参数传递给插件的变量联合在一起。

apiVersion [必需]
字符串

ExecInfo 的首选输入版本。返回的 ExecCredentials 必须使用与输入相同的编码版本。

installHint [必需]
字符串

当可执行文件似乎不存在时,会向用户显示此文本。例如,brew install foo-cli 可能是 Mac OS 系统上 foo-cli 的一个好的 InstallHint。

provideClusterInfo [必需]
布尔值

ProvideClusterInfo 确定是否要将集群信息(可能包含非常大的 CA 数据)作为 KUBERNETES_EXEC_INFO 环境变量的一部分提供给此 exec 插件。默认情况下,它设置为 false。软件包 k8s.io/client-go/tools/auth/exec 提供了用于读取此环境变量的帮助方法。

interactiveMode
ExecInteractiveMode

InteractiveMode 确定此插件与标准输入的关系。有效值是“Never”(此 exec 插件从不使用标准输入)、“IfAvailable”(此 exec 插件希望在可用时使用标准输入)或“Always”(此 exec 插件需要标准输入才能正常工作)。有关更多详细信息,请参阅 ExecInteractiveMode 值。

如果 APIVersion 是 client.authentication.k8s.io/v1alpha1 或 client.authentication.k8s.io/v1beta1,则此字段是可选的,并且在未设置时默认为“IfAvailable”。否则,此字段是必需的。

ExecEnvVar

出现在

ExecEnvVar 用于在执行基于 exec 的凭据插件时设置环境变量。

字段描述
name [必需]
字符串
未提供描述。
value [必需]
字符串
未提供描述。

ExecInteractiveMode

string 的别名)

出现在

ExecInteractiveMode 是一个描述 exec 插件与标准输入的关系的字符串。

NamedAuthInfo

出现在

NamedAuthInfo 将昵称与身份验证信息相关联

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

Name 是此 AuthInfo 的昵称

user [必需]
AuthInfo

AuthInfo 保存身份验证信息

NamedCluster

出现在

NamedCluster 将昵称与集群信息相关联

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

Name 是此 Cluster 的昵称

cluster [必需]
集群

Cluster 保存集群信息

NamedContext

出现在

NamedContext 将昵称与上下文信息相关联

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

Name 是此 Context 的昵称

context [必需]
上下文

Context 保存上下文信息

NamedExtension

出现在

NamedExtension 将昵称与扩展信息相关联

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

Name 是此 Extension 的昵称

extension [必需]
k8s.io/apimachinery/pkg/runtime.RawExtension

Extension 保存扩展信息

首选项

出现在

字段描述
颜色
布尔值
未提供描述。
extensions
[]NamedExtension

Extensions 包含附加信息。这对于扩展器很有用,因此读取和写入不会覆盖未知字段

此页面是自动生成的。

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

上次修改时间为 2023 年 12 月 25 日上午 9:44 PST:代码审查反馈 (a4b705bc4c)