kubectl cp

概要

將檔案和目錄複製到容器和從容器複製檔案和目錄。

kubectl cp <file-spec-src> <file-spec-dest>

範例

  # !!!Important Note!!!
  # Requires that the 'tar' binary is present in your container
  # image.  If 'tar' is not present, 'kubectl cp' will fail.
  #
  # For advanced use cases, such as symlinks, wildcard expansion or
  # file mode preservation, consider using 'kubectl exec'.
  
  # Copy /tmp/foo local file to /tmp/bar in a remote pod in namespace <some-namespace>
  tar cf - /tmp/foo | kubectl exec -i -n <some-namespace> <some-pod> -- tar xf - -C /tmp/bar
  
  # Copy /tmp/foo from a remote pod to /tmp/bar locally
  kubectl exec -n <some-namespace> <some-pod> -- tar cf - /tmp/foo | tar xf - -C /tmp/bar
  
  # Copy /tmp/foo_dir local directory to /tmp/bar_dir in a remote pod in the default namespace
  kubectl cp /tmp/foo_dir <some-pod>:/tmp/bar_dir
  
  # Copy /tmp/foo local file to /tmp/bar in a remote pod in a specific container
  kubectl cp /tmp/foo <some-pod>:/tmp/bar -c <specific-container>
  
  # Copy /tmp/foo local file to /tmp/bar in a remote pod in namespace <some-namespace>
  kubectl cp /tmp/foo <some-namespace>/<some-pod>:/tmp/bar
  
  # Copy /tmp/foo from a remote pod to /tmp/bar locally
  kubectl cp <some-namespace>/<some-pod>:/tmp/foo /tmp/bar

選項

-c, --container 字串

容器名稱。如果省略,請使用 kubectl.kubernetes.io/default-container 註解來選取要附加的容器,或將選擇 Pod 中的第一個容器

-h, --help

cp 的說明

--no-preserve

複製的檔案/目錄的所有權和權限將不會保留在容器中

--retries 整數

設定從容器完成複製作業的重試次數。指定 0 以停用或任何負值以無限次重試。預設值為 0 (不重試)。

--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

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

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

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

--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 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 權杖

--user string

要使用的 kubeconfig 使用者名稱

--username string

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

--version version[=true]

--version, --version=raw 列印版本資訊並結束;--version=vX.Y.Z... 設定回報的版本

--warnings-as-errors

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

另請參閱

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

此頁面為自動產生。

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

上次修改時間:2024 年 8 月 19 日下午 5:14 PST:Update kubectl reference for v1.31 (59df28c340)