kubectl debug

概要

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

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

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

• 工作负载：创建现有 Pod 的副本，并更改某些属性，例如将镜像标签更改为新版本。
• 工作负载：向已运行的 Pod 添加一个临时容器，例如添加调试实用程序而无需重新启动 Pod。
• 节点：创建一个新的 Pod，该 Pod 在节点的 host 命名空间中运行，并且可以访问节点的 filesystem。

注意：如果为目标 Pod 配置了非 root 用户，则 debug 配置文件授予的一些权限可能无法正常工作。

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 集群管理器