CopyFilesOverSSH@0 - 透過 SSH v0 工作複製檔案

透過 SSH 將檔案或組建成品複製到遠端電腦。

語法

# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    #sourceFolder: # string. Source folder. 
    contents: '**' # string. Required. Contents. Default: **.
    #targetFolder: # string. Target folder. 
  # Advanced
    #isWindowsOnTarget: false # boolean. Target machine running Windows. Default: false.
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #cleanHiddenFilesInTarget: false # boolean. Optional. Use when cleanTargetFolder = true. Remove hidden files in target folder. Default: false.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
    #overwrite: true # boolean. Overwrite. Default: true.
    #failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
    #flattenFolders: false # boolean. Flatten folders. Default: false.
    #concurrentUploads: '10' # string. Number of concurrent uploads when copying files. Default: 10.
    #delayBetweenUploads: '50' # string. Delay between queueing uploads (in milliseconds). Default: 50.

輸入

sshEndpoint - SSH 服務連線
string。 必須的。

SSH 服務連線的名稱 包含遠端電腦的連線詳細數據。

• 需要遠端電腦的主機名或IP位址、埠號碼和用戶名稱，才能建立SSH服務連線。
• 必須指定私鑰和複雜密碼進行驗證。

sourceFolder - 源資料夾
string。

要複製到遠端電腦的檔案來源資料夾。 當空白時，會使用存放庫根目錄（組建）或成品目錄（release），這是 $(System.DefaultWorkingDirectory)。 如果檔案不在存放庫中，請使用 變數。 範例： $(Agent.BuildDirectory).

contents - 內容
string。 必須的。 預設值：**。

要包含在複本中的檔案路徑。 支援多行 迷你模式。 默認值為 **，其中包含源數據夾下的所有檔案（包括子資料夾）。

• 範例：**/*.*(jar|war) 包含源資料夾下的所有.jar和 .war 檔案（包括子資料夾）。
• 範例："** \n !**/*.xml" 包含源資料夾下的所有檔案（包括子資料夾），但排除 xml 檔案。

targetFolder - 目標資料夾
string。

遠端電腦上的目標資料夾，其中會複製檔案。 範例： /home/user/MySite. 使用磚 (~) 前置詞來指定使用者的主目錄。

isWindowsOnTarget - 執行 Windows 的目標計算機
boolean。 預設值：false。

檢查目標計算機是否正在執行 Windows。

cleanTargetFolder - 清除目標資料夾
boolean。 預設值：false。

先刪除目標資料夾中的所有現有檔案和子資料夾，再複製。

cleanHiddenFilesInTarget - 移除目標資料夾中的隱藏檔案
boolean。 選擇性。 cleanTargetFolder = true時使用 。 預設值：false。

當設定為 true時，會移除目標資料夾中的隱藏檔案。

readyTimeout - SSH 交握逾時
string。 必須的。 預設值：20000。

等候 SSH 交握完成的時間（以毫秒為單位）。

overwrite - 覆寫
boolean。 預設值：true。

取代目標資料夾中和下方的現有檔案。

failOnEmptySource - 找不到任何檔案複製 失敗
boolean。 預設值：false。

如果在源資料夾下找不到要複製的相符檔案，則失敗。

flattenFolders - 扁平化資料夾
boolean。 預設值：false。

壓平資料夾結構，並將所有檔案複製到遠端電腦上的指定目標資料夾。

concurrentUploads - 複製檔案時並行上傳次數
string。 預設值：10。

複製檔案時並行上傳的數目。 預設值為 10。

delayBetweenUploads - 佇列上傳之間的延遲 （以毫秒為單位）
string。 預設值：50。

佇列上傳之間的延遲（以毫秒為單位）。 預設值為 50。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

沒有。

需求

要求	說明
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	此工作會使用下列 命令限制執行： 受限制
Settable 變數	此工作有權 設定下列變數：已停用設定變數
代理程式版本	2.206.1 或更新
工作類別	部署