kubectl drain
Synopsis
準備維護時清空節點。
給定的節點將被標記為不可排程，以防止新 Pod 到達。如果 API 伺服器支援 https://kubernetes.club.tw/docs/concepts/workloads/pods/disruptions/ 驅逐，則 'drain' 會驅逐 Pod。否則，它將使用普通 DELETE 來刪除 Pod。'drain' 會驅逐或刪除除映象 Pod（無法透過 API 伺服器刪除）之外的所有 Pod。如果存在由 DaemonSet 管理的 Pod，則 'drain' 在沒有 --ignore-daemonsets 引數的情況下不會繼續執行，並且無論如何都不會刪除任何由 DaemonSet 管理的 Pod，因為這些 Pod 會被 DaemonSet 控制器立即替換，而 DaemonSet 控制器會忽略不可排程標記。如果存在任何既不是映象 Pod 也非由副本控制器、ReplicaSet、DaemonSet、StatefulSet 或 Job 管理的 Pod，則 'drain' 不會刪除任何 Pod，除非您使用 --force。如果一個或多個 Pod 的管理資源丟失，--force 也會允許刪除繼續進行。
'drain' 會等待 Pod 優雅終止。在命令完成之前，您不應在該機器上進行操作。
當您準備好讓節點重新投入服務時，請使用 kubectl uncordon 命令，這將使節點再次變得可排程。
https://kubernetes.club.tw/images/docs/kubectl_drain.svg 工作流https://kubernetes.club.tw/images/docs/kubectl_drain.svg
kubectl drain NODE
示例
# Drain node "foo", even if there are pods not managed by a replication controller, replica set, job, daemon set, or stateful set on it
kubectl drain foo --force
# As above, but abort if there are pods not managed by a replication controller, replica set, job, daemon set, or stateful set, and use a grace period of 15 minutes
kubectl drain foo --grace-period=900
Options
| --chunk-size int 預設值: 500 | |
將大型列表分塊返回，而不是一次性返回。傳遞 0 以停用。此標誌是 Beta 版，未來可能會更改。 | |
| --delete-emptydir-data | |
即使存在使用 emptyDir 的 Pod（節點被 drain 時會被刪除的本地資料），也繼續執行。 | |
| --disable-eviction | |
強制 drain 使用 delete，即使支援 eviction。這將繞過對 PodDisruptionBudgets 的檢查，請謹慎使用。 | |
| --dry-run string[="unchanged"] 預設值: "none" | |
必須是 "none"、"server" 或 "client"。如果是 client 策略，則僅列印將要傳送的物件，而不傳送它。如果是 server 策略，則提交伺服器端請求而不持久化資源。 | |
| --force | |
即使存在未宣告控制器的 Pod，也繼續執行。 | |
| --grace-period int 預設值: -1 | |
每個 Pod 優雅終止的等待時間（秒）。如果為負數，則使用 Pod 中指定的預設值。 | |
| -h, --help | |
drain 的幫助 | |
| --ignore-daemonsets | |
忽略 DaemonSet 管理的 Pod。 | |
| --pod-selector string | |
用於過濾節點上 Pod 的標籤選擇器 | |
| -l, --selector string | |
用於過濾的選擇器（標籤查詢），支援 '=', '==', '!=', 'in', 'notin'。（例如 -l key1=value1,key2=value2,key3 in (value3)）。匹配的物件必須滿足所有指定的標籤約束。 | |
| --skip-wait-for-delete-timeout int | |
如果 Pod 的 DeletionTimestamp 早於 N 秒，則跳過等待 Pod。秒數必須大於 0 才能跳過。 | |
| --timeout duration | |
放棄前的等待時間，零表示無限 | |
繼承的父選項
| --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 專案的其他地方進行。