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 或更新版本 |
工作類別 | 部署 |