kubectl debug

概要

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

'debug' 为通过资源和名称标识的集群对象提供常见的调试任务自动化。如果不指定资源，默认使用 Pod。

'debug' 执行的操作取决于所指定的资源。支持的操作包括：

• 工作负载：创建现有 Pod 的副本，并修改某些属性（例如，将镜像标签更改为新版本）。
• 工作负载：向正在运行的 Pod 中添加临时容器（Ephemeral Container），例如在不重启 Pod 的情况下添加调试工具。
• 节点：创建一个在节点主机命名空间中运行的新 Pod，并能够访问该节点的文件系统。

注意：当整个目标 Pod 被配置为非 root 用户运行时，调试配置（debug profile）所授予的某些能力可能无法生效。

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

选项

继承的父选项

参见

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