kubectl cluster-info dump

概要

傾印叢集資訊以適用於偵錯和診斷叢集問題。預設情況下,將所有內容傾印到 stdout。您可以選擇性地使用 --output-directory 指定目錄。如果您指定目錄,Kubernetes 將在該目錄中建立一組檔案。預設情況下,僅傾印目前命名空間和「kube-system」命名空間中的內容,但您可以使用 --namespaces 旗標切換到不同的命名空間,或指定 --all-namespaces 以傾印所有命名空間。

此命令也會傾印叢集中所有 Pod 的日誌;這些日誌會根據命名空間和 Pod 名稱傾印到不同的目錄中。

kubectl cluster-info dump [flags]

範例

  # Dump current cluster state to stdout
  kubectl cluster-info dump
  
  # Dump current cluster state to /path/to/cluster-state
  kubectl cluster-info dump --output-directory=/path/to/cluster-state
  
  # Dump all namespaces to stdout
  kubectl cluster-info dump --all-namespaces
  
  # Dump a set of namespaces to /path/to/cluster-state
  kubectl cluster-info dump --namespaces default,kube-system --output-directory=/path/to/cluster-state

選項

-A, --all-namespaces

如果為 true,則傾印所有命名空間。如果為 true,則會忽略 --namespaces。

--allow-missing-template-keys     預設值:true

如果為 true,則在範本中缺少欄位或對應鍵時,忽略範本中的任何錯誤。僅適用於 golang 和 jsonpath 輸出格式。

-h, --help

傾印的說明

--namespaces 字串

要傾印的命名空間的逗號分隔清單。

-o, --output 字串     預設值:「json」

輸出格式。選項之一:(json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file)。

--output-directory 字串

要輸出檔案的位置。如果為空或 '-',則使用 stdout,否則在該目錄中建立目錄階層

--pod-running-timeout 持續時間     預設值:20 秒

等待至少一個 Pod 執行的時間長度(例如 5 秒、2 分鐘或 3 小時,大於零)

--show-managed-fields

如果為 true,則在以 JSON 或 YAML 格式列印物件時保留 managedFields。

--template 字串

範本字串或範本檔案的路徑,在 -o=go-template、-o=go-template-file 時使用。範本格式為 golang 範本 [https://go.dev.org.tw/pkg/text/template/#pkg-overview]。

--as 字串

要模擬操作的使用者名稱。使用者可以是命名空間中的一般使用者或服務帳戶。

--as-group 字串

要模擬操作的群組,可以重複此旗標以指定多個群組。

--as-uid 字串

要模擬操作的 UID。

--cache-dir 字串     預設值:「$HOME/.kube/cache」

預設快取目錄

--certificate-authority 字串

憑證授權單位的憑證檔案路徑

--client-certificate 字串

TLS 的用戶端憑證檔案路徑

--client-key 字串

TLS 的用戶端金鑰檔案路徑

--cluster 字串

要使用的 kubeconfig 叢集名稱

--context 字串

要使用的 kubeconfig 環境定義名稱

--default-not-ready-toleration-seconds 整數     預設值:300

表示 tolerationSeconds,用於 notReady:NoExecute 的容忍度,預設會新增至每個尚未具有此容忍度的 Pod。

--default-unreachable-toleration-seconds 整數     預設值:300

表示 tolerationSeconds,用於 unreachable:NoExecute 的容忍度,預設會新增至每個尚未具有此容忍度的 Pod。

--disable-compression

如果為 true,則退出伺服器所有請求的回應壓縮

--insecure-skip-tls-verify

如果為 true,則不會檢查伺服器憑證的有效性。這會使您的 HTTPS 連線不安全

--kubeconfig 字串

用於 CLI 請求的 kubeconfig 檔案路徑。

--match-server-version

要求伺服器版本與用戶端版本相符

-n, --namespace 字串

如果存在,則此 CLI 請求的命名空間範圍

--password 字串

用於對 API 伺服器進行基本身份驗證的密碼

--profile 字串     預設值:「none」

要擷取的設定檔名稱。選項之一(none|cpu|heap|goroutine|threadcreate|block|mutex)

--profile-output 字串     預設值:「profile.pprof」

要將設定檔寫入的檔案名稱

--request-timeout 字串     預設值:「0」

在放棄單一伺服器請求之前要等待的時間長度。非零值應包含對應的時間單位(例如 1 秒、2 分鐘、3 小時)。值為零表示請求不會逾時。

-s, --server 字串

Kubernetes API 伺服器的位址和連接埠

--storage-driver-buffer-duration 持續時間     預設值:1 分鐘 0 秒

儲存驅動程式中的寫入將緩衝此持續時間,並作為單一交易提交到非記憶體後端

--storage-driver-db 字串     預設值:「cadvisor」

資料庫名稱

--storage-driver-host 字串     預設值:「localhost:8086」

資料庫主機:連接埠

--storage-driver-password 字串     預設值:「root」

資料庫密碼

--storage-driver-secure

使用與資料庫的安全連線

--storage-driver-table 字串     預設值:「stats」

資料表名稱

--storage-driver-user 字串     預設值:「root」

資料庫使用者名稱

--tls-server-name 字串

用於伺服器憑證驗證的伺服器名稱。如果未提供,則使用用於連線伺服器的主機名稱

--token 字串

用於對 API 伺服器進行身份驗證的持有者權杖

--user 字串

要使用的 kubeconfig 使用者名稱

--username 字串

用於對 API 伺服器進行基本身份驗證的使用者名稱

--version 版本[=true]

--version、--version=raw 列印版本資訊並退出;--version=vX.Y.Z... 設定回報的版本

--warnings-as-errors

將從伺服器收到的警告視為錯誤,並以非零結束代碼退出

另請參閱

此頁面為自動產生。

如果您計劃回報此頁面的問題,請在您的問題描述中提及此頁面為自動產生。修正可能需要在 Kubernetes 專案的其他地方進行。

上次修改時間為 2024 年 8 月 19 日下午 5:14 PST:更新 v1.31 的 kubectl 參考資料 (59df28c340)