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.
Входные данные
подключения службы SSH sshEndpoint
-
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
.
Неструктурирует структуру папок и копирует все файлы в указанную целевую папку на удаленном компьютере.
concurrentUploads
-
число одновременных отправки при копировании файлов
string
. Значение по умолчанию: 10
.
Количество одновременных отправки при копировании файлов. Значение по умолчанию — 10.
delayBetweenUploads
-
задержка между отправкой очередей (в миллисекундах)
string
. Значение по умолчанию: 50
.
Задержка между отправкой очередей (в миллисекундах). Значение по умолчанию — 50.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Нет |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Эта задача выполняется с помощью следующих ограничений команд : ограничено. |
переменные settable | Эта задача имеет разрешение на задать следующие переменные: параметр переменных отключен |
Версия агента | 2.206.1 или более поздней версии |
Категория задач | Внедрять |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Нет |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Эта задача выполняется с помощью следующих ограничений команд : ограничено. |
переменные settable | Эта задача имеет разрешение на задать следующие переменные: параметр переменных отключен |
Версия агента | 2.182.1 или более поздней версии |
Категория задач | Внедрять |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Нет |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Любое |
переменные settable | Любое |
Версия агента | 2.144.0 или более поздней версии |
Категория задач | Внедрять |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Нет |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Любое |
переменные settable | Любое |
Версия агента | 2.102.0 или более поздней версии |
Категория задач | Внедрять |