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

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

Syntax

# 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.
# 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.
    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.
# 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
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #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.
# 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
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #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.

輸入

sshEndpoint - SSH 服務連線
string. 必要。

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

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

sourceFolder - 源資料夾
string.

要複製到遠端電腦之檔案的來源資料夾。 當空白時,會使用存放庫的根目錄, (組建) 或成品目錄 (版本) ,也就是 $(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

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


工作控制選項

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

輸出變數

無。

規格需求

需求 描述
管線類型 YAML、傳統組建、傳統版本
在上執行 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 此工作會使用下列 命令限制執行:受限制
可設定變數 此工作有權 設定下列變數:已停用設定變數
代理程式版本 2.206.1 或更新版本
工作類別 部署
需求 描述
管線類型 YAML、傳統組建、傳統版本
在上執行 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 此工作會使用下列 命令限制執行:受限制
可設定變數 此工作有權 設定下列變數:已停用設定變數
代理程式版本 2.182.1 或更新版本
工作類別 部署
需求 描述
管線類型 YAML、傳統組建、傳統版本
在上執行 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任何
可設定變數 任何
代理程式版本 2.144.0 或更新版本
工作類別 部署
需求 描述
管線類型 YAML、傳統組建、傳統版本
在上執行 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任何
可設定變數 任何
代理程式版本 2.102.0 或更新版本
工作類別 部署