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