kubectl debug

概要

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

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

“debug” 采取的操作因指定的资源而异。 支持的操作包括

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

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