kubectl diff

Synopsis

透過檔名或標準輸入指定的檔案,比較當前線上配置與應用後的配置之間的差異。

輸出始終為 YAML 格式。

KUBECTL_EXTERNAL_DIFF 環境變數可用於選擇您自己的 diff 命令。使用者也可以使用帶引數的外部命令,例如:KUBECTL_EXTERNAL_DIFF="colordiff -N -u"

預設情況下,您路徑中可用的 "diff" 命令將以 "-u" (統一 diff) 和 "-N" (將不存在的檔案視為空) 選項執行。

退出狀態:0 未發現差異。1 發現差異。>1 Kubectl 或 diff 因錯誤而失敗。

注意:如果使用 KUBECTL_EXTERNAL_DIFF,它應遵循此約定。

kubectl diff -f FILENAME

示例

  # Diff resources included in pod.json
  kubectl diff -f pod.json
  
  # Diff file read from stdin
  cat service.yaml | kubectl diff -f -

Options

--concurrency int     預設值:1

與即時版本進行 diff 時並行處理的物件數量。數量越大 = 速度越快,但在較短時間內消耗的記憶體、I/O 和 CPU 越多。

--field-manager string     預設值: "kubectl-client-side-apply"

用於跟蹤欄位所有權的管理器名稱。

-f, --filename strings

包含要 diff 的配置的檔名、目錄或 URL

--force-conflicts

如果為 true,則伺服器端應用會將更改強制應用於衝突。

-h, --help

diff 的幫助

-k, --kustomize string

處理 kustomization 目錄。此標誌不能與 -f 或 -R 一起使用。

--prune

包含因修剪而將被刪除的資源。可與 -l 一起使用,預設顯示所有將被修剪的資源

--prune-allowlist strings

使用 <group/version/kind> 覆蓋 --prune 的預設允許列表

-R, --recursive

遞迴處理 -f, --filename 指定的目錄。當您想管理組織在同一目錄下的相關清單時很有用。

-l, --selector string

用於過濾的選擇器(標籤查詢),支援 '=', '==', '!=', 'in', 'notin'。(例如 -l key1=value1,key2=value2,key3 in (value3))。匹配的物件必須滿足所有指定的標籤約束。

--server-side

如果為 true,則 apply 在伺服器端執行,而不是在客戶端執行。

--show-managed-fields

如果為 true,則包含受管欄位進行 diff。

繼承的父選項

--as string

為操作假定的使用者名稱。使用者可以是常規使用者或名稱空間中的服務帳戶。

--as-group strings

為操作假定的組,此標誌可以重複以指定多個組。

--as-uid string

為操作假定的 UID。

--cache-dir string     預設值: "$HOME/.kube/cache"

預設快取目錄

--certificate-authority string

證書頒發機構的證書檔案路徑

--client-certificate string

TLS 的客戶端證書檔案路徑

--client-key string

TLS 的客戶端金鑰檔案路徑

--cluster string

要使用的 kubeconfig 叢集名稱

--context string

要使用的 kubeconfig 上下文名稱

--disable-compression

如果為 true,則選擇退出所有到伺服器的請求的響應壓縮

--insecure-skip-tls-verify

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

--kubeconfig string

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

--kuberc string

用於首選項的 kuberc 檔案路徑。可以透過匯出 KUBECTL_KUBERC=false 功能標誌或關閉 KUBERC=off 功能來停用此功能。

--match-server-version

要求伺服器版本與客戶端版本匹配

-n, --namespace string

如果存在,則為本次 CLI 請求的名稱空間範圍

--password string

API 伺服器基本身份驗證的密碼

--profile string     預設值: "none"

要捕獲的配置檔名稱。選擇之一(none|cpu|heap|goroutine|threadcreate|block|mutex)

--profile-output string     預設值: "profile.pprof"

要將配置檔案寫入的檔案的名稱

--request-timeout string     預設值: "0"

在放棄單個伺服器請求之前等待的時間。非零值應包含相應的時間單位(例如 1s、2m、3h)。零值表示不超時請求。

-s, --server string

Kubernetes API 伺服器的地址和埠

--storage-driver-buffer-duration duration     預設值: 1m0s

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

--storage-driver-db string     預設值: "cadvisor"

資料庫名稱

--storage-driver-host string     預設值: "localhost:8086"

資料庫主機:埠

--storage-driver-password string     預設值: "root"

資料庫密碼

--storage-driver-secure

使用安全的資料庫連線

--storage-driver-table string     預設值: "stats"

表名

--storage-driver-user string     預設值: "root"

資料庫使用者名稱

--tls-server-name string

用於伺服器證書驗證的伺服器名稱。如果未提供,則使用用於聯絡伺服器的主機名。

--token string

API 伺服器身份驗證的 Bearer token

--user string

要使用的 kubeconfig 使用者名稱

--username string

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

--version version[=true]

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

--warnings-as-errors

將從伺服器收到的警告視為錯誤,並以非零退出程式碼退出。

另請參閱

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

本頁面是自動生成的。

如果你打算報告此頁面存在的問題,請在問題描述中提及此頁面是自動生成的。修復可能需要在 Kubernetes 專案的其他地方進行。

最後修改於 2025 年 9 月 4 日下午 3:30 PST: Update kubectl reference for v1.34 (bdc4bba2a5)