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.
# 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.
輸入
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 或更新 |
工作類別 | 部署 |
要求 | 說明 |
---|---|
管線類型 | YAML、傳統組建、傳統版本 |
執行於 | Agent、DeploymentGroup |
需求 | 沒有 |
功能 | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 此工作會使用下列 命令限制執行: 受限制 |
Settable 變數 | 此工作有權 設定下列變數:已停用設定變數 |
代理程式版本 | 2.182.1 或更新 |
工作類別 | 部署 |
要求 | 說明 |
---|---|
管線類型 | YAML、傳統組建、傳統版本 |
執行於 | Agent、DeploymentGroup |
需求 | 沒有 |
功能 | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 任意 |
Settable 變數 | 任意 |
代理程式版本 | 2.144.0 或更新 |
工作類別 | 部署 |
要求 | 說明 |
---|---|
管線類型 | YAML、傳統組建、傳統版本 |
執行於 | Agent、DeploymentGroup |
需求 | 沒有 |
功能 | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 任意 |
Settable 變數 | 任意 |
代理程式版本 | 2.102.0 或更新 |
工作類別 | 部署 |