这是本节的多页打印视图。
点击此处打印.
返回本页常规视图.
kubectl config
简介
使用 "kubectl config set current-context my-context" 等子命令修改 kubeconfig 文件。
加载顺序遵循以下规则:
- 如果设置了 --kubeconfig 标志,则仅加载该文件。该标志只能设置一次,并且不会发生合并。
- 如果设置了 $KUBECONFIG 环境变量,则将其用作路径列表(系统的正常路径分隔规则),这些路径会被合并。
当某个值被修改时,也会在定义这部分内容的文件中修改此值。当某个值被创建时,也会在存在的第一个文件中创建此值。
如果链中不存在文件,则它会创建列表中的最后一个文件。
- 否则,将使用
${HOME}/.kube/config
,并且不会发生合并。
kubectl config SUBCOMMAND
选项
-h, --help |
| 关于 config 的帮助信息。 |
--kubeconfig string |
| 使用特定的 kubeconfig 文件 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
1 - kubectl config current-context
简介
显示当前上下文。
kubectl config current-context [flags]
示例
# 显示当前上下文
kubectl config current-context
选项
-h, --help |
| 关于 current-context 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
2 - kubectl config delete-cluster
简介
从 kubeconfig 中删除指定的集群。
kubectl config delete-cluster NAME
示例
# 删除 minikube 集群
kubectl config delete-cluster minikube
选项
-h, --help |
| 关于 delete-cluster 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
3 - kubectl config delete-context
简介
从 kubeconfig 中删除指定的上下文。
kubectl config delete-context NAME
示例
# 删除 minikube 集群的上下文
kubectl config delete-context minikube
选项
-h, --help |
| 关于 delete-context 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
4 - kubectl config delete-user
简介
从 kubeconfig 中删除指定用户。
kubectl config delete-user NAME
示例
# 删除 minikube 用户
kubectl config delete-user minikube
选项
-h, --help |
| 关于 delete-user 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
5 - kubectl config get-clusters
简介
显示 kubeconfig 中定义的集群。
kubectl config get-clusters [flags]
示例
# 列出 kubectl 所知悉的集群
kubectl config get-clusters
选项
-h, --help |
| 关于 get-clusters 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
6 - kubectl config get-contexts
简介
显示 kubeconfig 文件中的一个或多个上下文。
kubectl config get-contexts [(-o|--output=)name)]
示例
# 列出 kubeconfig 文件中的所有上下文
kubectl config get-contexts
# 描述 kubeconfig 文件中指定上下文的详细信息
kubectl config get-contexts my-context
选项
-h, --help |
| 关于 get-contexts 的帮助信息。 |
--no-headers |
| 当使用默认或自定义列输出格式时,不要打印标题(默认打印标题)。 |
-o, --output string |
| 输出格式。可选值为:name。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
7 - kubectl config get-users
简介
显示 kubeconfig 中定义的用户。
kubectl config get-users [flags]
示例
# 列出 kubectl 知悉的用户
kubectl config get-users
选项
-h, --help |
| 关于 get-users 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
8 - kubectl config rename-context
简介
重命名 kubeconfig 文件中的上下文。
- CONTEXT_NAME 是要更改的上下文名称。
- NEW_NAME 是要设置的新名称。
- 注意:如果重命名的上下文是“当前上下文”,则该字段也将被更新。
kubectl config rename-context CONTEXT_NAME NEW_NAME
示例
# 将 kubeconfig 文件中上下文 "old-name" 重命名为 "new-name"
kubectl config rename-context old-name new-name
选项
-h, --help |
| 关于 rename-context 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
9 - kubectl config set
简介
设置 kubeconfig 文件中的单个值。
- PROPERTY_NAME 是一个以点分隔的名称,其中每个元素代表一个属性名称或一个键名。键名不得包含点。
- PROPERTY_VALUE 是要设置的值。除非使用
--set-raw-bytes
标志,否则二进制字段(例如 certificate-authority-data
)必须为经过 base64 编码的字符串。 - 指定已存在的属性名称将把新字段值与现有值合并。
kubectl config set PROPERTY_NAME PROPERTY_VALUE
示例
# 将 my-cluster 集群的 server 字段设置为 https://1.2.3.4
kubectl config set clusters.my-cluster.server https://1.2.3.4
# 设置 my-cluster 集群的 certificate-authority-data 字段
kubectl config set clusters.my-cluster.certificate-authority-data $(echo "cert_data_here" | base64 -i -)
# 将 my-context 上下文中的 cluster 字段设置为 my-cluster
kubectl config set contexts.my-context.cluster my-cluster
# 使用 --set-raw-bytes 选项设置 cluster-admin 用户中的 client-key-data 字段
kubectl config set users.cluster-admin.client-key-data cert_data_here --set-raw-bytes=true
选项
-h, --help |
| 关于 set 的帮助信息。 |
--set-raw-bytes tristate[=true] |
| 写入 []byte 格式的 PROPERTY_VALUE 时,直接写入给定的字符串,无需 base64 解码。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
10 - kubectl config set-cluster
简介
设置 kubeconfig 中的集群条目。
kubectl config set-cluster NAME [--server=server] [--certificate-authority=path/to/certificate/authority] [--insecure-skip-tls-verify=true] [--tls-server-name=example.com]
示例
# 仅设置 e2e 集群条目上的 server 字段,不触及其他值
kubectl config set-cluster e2e --server=https://1.2.3.4
# 在 e2e 集群条目中嵌入证书颁发机构的数据
kubectl config set-cluster e2e --embed-certs --certificate-authority=~/.kube/e2e/kubernetes.ca.crt
# 禁用 e2e 集群条目中的证书检查
kubectl config set-cluster e2e --insecure-skip-tls-verify=true
# 设置用于验证 e2e 集群条目的自定义 TLS 服务器名称
kubectl config set-cluster e2e --tls-server-name=my-cluster-name
# 设置 e2e 集群条目的代理 URL
kubectl config set-cluster e2e --proxy-url=https://1.2.3.4
选项
--certificate-authority string |
| kubeconfig 中集群条目的证书颁发机构文件的路径。 |
--embed-certs tristate[=true] |
| 在 kubeconfig 中嵌入集群条目的证书。 |
-h, --help |
| 关于 set-cluster 的帮助信息。 |
--insecure-skip-tls-verify tristate[=true] |
| 设置 kubeconfig 中的集群条目的 insecure-skip-tls-verify 字段。 |
--proxy-url string |
| kubeconfig 中集群条目的代理地址。 |
--server string |
| kubeconfig 中集群条目的 server 字段。 |
--tls-server-name string |
| kubeconfig 中的集群条目的 tls-server-name 字段。 |
Parent Options Inherited
--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 上下文的名称。 |
--kubeconfig string |
| 使用特定的 kubeconfig 文件 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--disable-compression |
| 如果为 true,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
11 - kubectl config set-context
简介
在 kubeconfig 中设置上下文条目。
kubectl config set-context [NAME | --current] [--cluster=cluster_nickname] [--user=user_nickname] [--namespace=namespace]
示例
# 在 gce 上下文条目上设置用户字段,而不影响其他值
kubectl config set-context gce --user=cluster-admin
选项
--cluster string |
| kubeconfig 中上下文条目的集群。 |
--current |
| 修改当前上下文。 |
-h, --help |
| 关于 set-context 的帮助信息。 |
--namespace string |
| kubeconfig 中上下文条目的命名空间。 |
--user string |
| kubeconfig 中上下文条目的用户。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
12 - kubectl config set-credentials
简介
在 kubeconfig 中设置用户条目。
- 指定已存在的属性名称将把新字段值与现有值合并。
- 客户端证书标志:--client-certificate=certfile --client-key=keyfile
- 持有者令牌标志:--token=bearer_token
- 基本身份验证标志:--username=basic_user --password=basic_password
- 持有者令牌和基本身份验证是互斥的(不可同时使用)。
kubectl config set-credentials NAME [--client-certificate=path/to/certfile] [--client-key=path/to/keyfile] [--token=bearer_token] [--username=basic_user] [--password=basic_password] [--auth-provider=provider_name] [--auth-provider-arg=key=value] [--exec-command=exec_command] [--exec-api-version=exec_api_version] [--exec-arg=arg] [--exec-env=key=value]
示例
# 仅设置 "cluster-admin" 条目上的 "client-key" 字段,不触及其他值
kubectl config set-credentials cluster-admin --client-key=~/.kube/admin.key
# 为 "cluster-admin" 条目设置基本身份验证
kubectl config set-credentials cluster-admin --username=admin --password=uXFGweU9l35qcif
# 在 "cluster-admin" 条目中嵌入客户端证书数据
kubectl config set-credentials cluster-admin --client-certificate=~/.kube/admin.crt --embed-certs=true
# 为 "cluster-admin" 条目启用 Google Compute Platform 身份认证提供程序
kubectl config set-credentials cluster-admin --auth-provider=gcp
# 使用附加参数为 "cluster-admin" 条目启用 OpenID Connect 身份认证提供程序
kubectl config set-credentials cluster-admin --auth-provider=oidc --auth-provider-arg=client-id=foo --auth-provider-arg=client-secret=bar
# 删除 "cluster-admin" 条目的 OpenID Connect 身份验证提供程序的 "client-secret" 配置值
kubectl config set-credentials cluster-admin --auth-provider=oidc --auth-provider-arg=client-secret-
# 为 "cluster-admin" 条目启用新的 exec 认证插件
kubectl config set-credentials cluster-admin --exec-command=/path/to/the/executable --exec-api-version=client.authentication.k8s.io/v1beta1
# 为 "cluster-admin" 条目启用新的、带交互模式的 exec 认证插件
kubectl config set-credentials cluster-admin --exec-command=/path/to/the/executable --exec-api-version=client.authentication.k8s.io/v1beta1 --exec-interactive-mode=Never
# 为 "cluster-admin" 条目定义新的 exec 认证插件参数
kubectl config set-credentials cluster-admin --exec-arg=arg1 --exec-arg=arg2
# 为 "cluster-admin" 条目创建或更新 exec 认证插件环境变量
kubectl config set-credentials cluster-admin --exec-env=key1=val1 --exec-env=key2=val2
# 删除 "cluster-admin" 条目的 exec 认证插件环境变量
kubectl config set-credentials cluster-admin --exec-env=var-to-remove-
选项
--auth-provider string |
| kubeconfig 中用户条目的身份验证提供程序。 |
--auth-provider-arg strings |
| 身份验证提供程序参数,'key=value' 格式。 |
--client-certificate string |
| kubeconfig 中用户条目的客户端证书文件路径。 |
--client-key string |
| kubeconfig 中用户条目的客户端密钥文件路径。 |
--embed-certs tristate[=true] |
| 在 kubeconfig 中嵌入用户条目的客户端证书/密钥。 |
--exec-api-version string |
| kubeconfig 中用户条目的 exec 凭据插件的 API 版本。 |
--exec-arg strings |
| kubeconfig 中用户条目的 exec 凭据插件命令的新参数。 |
--exec-command string |
| kubeconfig 中用户条目的 exec 凭据插件命令。 |
--exec-env strings |
| exec 凭证插件的环境变量,'key=value' 格式。。 |
--exec-interactive-mode string |
| kubeconfig 中用户条目的 exec 凭据插件的交互模式。 |
--exec-provide-cluster-info tristate[=true] |
| 提供给 kubeconfig 中用户条目所使用的 exec 凭据插件的集群信息。 |
-h, --help |
| 关于 set-credentials 的帮助信息。 |
--password string |
| kubeconfig 中用户条目的密码。 |
--token string |
| kubeconfig 中用户条目的 token。 |
--username string |
| kubeconfig 中用户条目的用户名。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
13 - kubectl config unset
简介
去除 kubeconfig 文件中的某个值的设置。
- PROPERTY_NAME 是一个以点分隔的名称,其中每个元素代表一个属性名称或一个键名。键名不得包含点。
kubectl config unset PROPERTY_NAME
示例
# 去除 current-context 设置
kubectl config unset current-context
# 去掉 foo 上下文中的 namespace 设置
kubectl config unset contexts.foo.namespace
选项
-h, --help |
| 关于 unset 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
14 - kubectl config use-context
简介
在 kubeconfig 文件中设置当前上下文。
kubectl config use-context CONTEXT_NAME
示例
# 使用 minikube 集群的上下文
kubectl config use-context minikube
选项
-h, --help |
| 关于 use-context 的帮助信息。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见
15 - kubectl config view
简介
显示合并的 kubeconfig 配置或指定的 kubeconfig 文件。
- 可以使用
--output jsonpath={...}
通过 jsonpath 表达式提取特定值。
kubectl config view [flags]
示例
# 显示合并的 kubeconfig 设置
kubectl config view
# 显示合并的 kubeconfig 设置、原始证书数据和公开的密钥
kubectl config view --raw
# 获取 e2e 用户的密码
kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}'
选项
--allow-missing-template-keys 默认值:true |
| 如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。
仅适用于 golang 和 jsonpath 输出格式。 |
--flatten |
| 将生成的 kubeconfig 文件扁平化为自包含的输出(对于创建可移植的 kubeconfig 文件很有用)。 |
-h, --help |
| 关于 view 的帮助信息。 |
--merge tristate[=true] 默认值:true |
| 合并 kubeconfig 文件的完整层次结构数据。 |
--minify |
| 从输出中删除当前上下文未使用的所有信息。 |
-o, --output string 默认值:"yaml" |
| 输出格式。可选值为:
json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 |
--raw |
| 显示原始字节数据和敏感数据。 |
--show-managed-fields |
| 如果为 true,则在以 JSON 或 YAML 格式打印对象时保留 managedFields。 |
--template string |
| 当指定 `-o=go-template` 、`-o=go-template-file` 时使用的模板字符串或模板文件路径。
模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 |
Parent Options Inherited
--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,则对服务器所有请求的响应不再压缩。 |
--insecure-skip-tls-verify |
| 如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 |
--kubeconfig string |
| CLI 请求要使用的 kubeconfig 文件的路径。 |
--kuberc string |
| 用于偏好设置的 kuberc 文件的路径。可以通过导出 KUBECTL_KUBERC=false
特性门控或关闭 KUBERC=off 特性门控来禁用此功能。 |
--match-server-version |
| 要求服务器版本与客户端版本匹配。 |
-n, --namespace string |
| 如果存在,则是此 CLI 请求的命名空间范围。 |
--password string |
| 对 API 服务器进行基本身份验证所用的密码。 |
--profile string 默认值:"none" |
| 要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 |
--profile-output string 默认值:"profile.pprof" |
| 性能分析信息要写入的目标文件的名称。 |
--request-timeout string 默认值:"0" |
| 在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。
值为零表示请求不会超时。 |
-s, --server string |
| Kubernetes API 服务器的地址和端口。 |
--storage-driver-buffer-duration duration 默认值:1m0s |
| 对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 |
--storage-driver-db string 默认值:"cadvisor" |
| 数据库名称。 |
--storage-driver-host string 默认值:"localhost:8086" |
| 数据库 host:port。 |
--storage-driver-password string 默认值:"root" |
| 数据库密码。 |
--storage-driver-secure |
| 使用与数据库的安全连接。 |
--storage-driver-table string 默认值:"stats" |
| 表名。 |
--storage-driver-user string 默认值:"root" |
| 数据库用户名。 |
--tls-server-name string |
| 服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 |
--token string |
| 向 API 服务器进行身份验证的持有者令牌。 |
--user string |
| 要使用的 kubeconfig 用户的名称。 |
--username string |
| 对 API 服务器进行基本身份验证时所用的用户名。 |
--version version[=true] |
| --version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 |
--warnings-as-errors |
| 将从服务器收到的警告视为错误,并以非零退出码退出。 |
另请参见