kubectl debug

Synopsis

使用交互式调试容器调试集群资源。

'debug' 命令为集群对象提供常用调试任务的自动化，通过资源类型和名称进行标识。如果没有指定资源，默认使用 Pod。

'debug' 命令执行的操作因指定资源的不同而异。支持的操作包括：

• 工作负载：创建现有 Pod 的副本，并更改某些属性，例如将镜像标签更改为新版本。
• 工作负载：向已运行的 Pod 添加一个临时容器，例如添加调试工具而不重新启动 Pod。
• 节点：创建一个新的 Pod，该 Pod 在节点的宿主命名空间中运行，并且可以访问节点的根文件系统。

注意：当目标 Pod 配置了非 root 用户时，调试配置文件授予的某些功能可能无法正常工作。

kubectl debug (POD | TYPE[[.VERSION].GROUP]/NAME) [ -- COMMAND [args...] ]

示例

  # Create an interactive debugging session in pod mypod and immediately attach to it.
  kubectl debug mypod -it --image=busybox
  
  # Create an interactive debugging session for the pod in the file pod.yaml and immediately attach to it.
  # (requires the EphemeralContainers feature to be enabled in the cluster)
  kubectl debug -f pod.yaml -it --image=busybox
  
  # Create a debug container named debugger using a custom automated debugging image.
  kubectl debug --image=myproj/debug-tools -c debugger mypod
  
  # Create a copy of mypod adding a debug container and attach to it
  kubectl debug mypod -it --image=busybox --copy-to=my-debugger
  
  # Create a copy of mypod changing the command of mycontainer
  kubectl debug mypod -it --copy-to=my-debugger --container=mycontainer -- sh
  
  # Create a copy of mypod changing all container images to busybox
  kubectl debug mypod --copy-to=my-debugger --set-image=*=busybox
  
  # Create a copy of mypod adding a debug container and changing container images
  kubectl debug mypod -it --copy-to=my-debugger --image=debian --set-image=app=app:debug,sidecar=sidecar:debug
  
  # Create an interactive debugging session on a node and immediately attach to it.
  # The container will run in the host namespaces and the host's filesystem will be mounted at /host
  kubectl debug node/mynode -it --image=busybox

Options

继承的父选项

另请参阅

• kubectl - kubectl 控制 Kubernetes 集群管理器