kubectl auth can-i

概要

检查某个动作是否被允许。

VERB 是一个逻辑上的 Kubernetes API 动词,例如 'get'、'list'、'watch'、'delete' 等。TYPE 是一个 Kubernetes 资源。快捷方式和组会被解析。NONRESOURCEURL 是以 "/" 开头的部分 URL。NAME 是特定 Kubernetes 资源的名称。此命令与模拟用户功能很好地配合使用。参见 --as 全局标志。

kubectl auth can-i VERB [TYPE | TYPE/NAME | NONRESOURCEURL]

示例

  # Check to see if I can create pods in any namespace
  kubectl auth can-i create pods --all-namespaces
  
  # Check to see if I can list deployments in my current namespace
  kubectl auth can-i list deployments.apps
  
  # Check to see if service account "foo" of namespace "dev" can list pods in the namespace "prod"
  # You must be allowed to use impersonation for the global option "--as"
  kubectl auth can-i list pods --as=system:serviceaccount:dev:foo -n prod
  
  # Check to see if I can do everything in my current namespace ("*" means all)
  kubectl auth can-i '*' '*'
  
  # Check to see if I can get the job named "bar" in namespace "foo"
  kubectl auth can-i list jobs.batch/bar -n foo
  
  # Check to see if I can read pod logs
  kubectl auth can-i get pods --subresource=log
  
  # Check to see if I can access the URL /logs/
  kubectl auth can-i get /logs/
  
  # Check to see if I can approve certificates.k8s.io
  kubectl auth can-i approve certificates.k8s.io
  
  # List all allowed actions in namespace "foo"
  kubectl auth can-i --list --namespace=foo

选项

-A, --all-namespaces

如果为 true,则检查所有命名空间中的指定动作。

-h, --help

can-i 的帮助

--list

如果为 true,则打印所有允许的动作。

--no-headers

如果为 true,则打印允许的动作,但不带头部信息

-q, --quiet

如果为 true,则抑制输出并仅返回退出码。

--subresource string

子资源,例如 pod/log 或 deployment/scale

继承的父选项

--as string

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

--as-group strings

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

--as-uid string

执行操作时模拟的 UID。

--cache-dir string     Default: "$HOME/.kube/cache"

默认缓存目录

--certificate-authority string

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

--client-certificate string

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

--client-key string

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

--cluster string

要使用的 kubeconfig 集群名称

--context string

要使用的 kubeconfig 上下文名称

--default-not-ready-toleration-seconds int     Default: 300

表示默认添加到每个尚未具有此类容忍度的 Pod 的针对 notReady:NoExecute 的容忍度的容忍秒数。

--default-unreachable-toleration-seconds int     Default: 300

表示默认添加到每个尚未具有此类容忍度的 Pod 的针对 unreachable:NoExecute 的容忍度的容忍秒数。

--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     Default: "none"

要捕获的 profile 名称。可选值包括 (none|cpu|heap|goroutine|threadcreate|block|mutex)

--profile-output string     Default: "profile.pprof"

写入 profile 的文件名

--request-timeout string     Default: "0"

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

-s, --server string

Kubernetes API 服务器的地址和端口

--storage-driver-buffer-duration duration     Default: 1m0s

存储驱动程序中的写操作将在此持续时间内被缓冲,并作为单个事务提交到非内存后端

--storage-driver-db string     Default: "cadvisor"

数据库名称

--storage-driver-host string     Default: "localhost:8086"

数据库主机:端口

--storage-driver-password string     Default: "root"

数据库密码

--storage-driver-secure

使用安全连接连接数据库

--storage-driver-table string     Default: "stats"

表名称

--storage-driver-user string     Default: "root"

数据库用户名

--tls-server-name string

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

--token string

用于对 API 服务器进行认证的 Bearer Token

--user string

要使用的 kubeconfig 用户名

--username string

用于对 API 服务器进行基本认证的用户名

--version version[=true]

--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本

--warnings-as-errors

将从服务器收到的警告视为错误并以非零退出码退出

另请参阅

本页面是自动生成的。

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

最后修改于 2024 年 8 月 19 日太平洋标准时间下午 5:14:更新 v1.31 的 kubectl 参考 (59df28c340)