Поделиться через


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 или более поздней версии
Категория задач Внедрять