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


CopyFilesOverSSH@0 — копирование файлов через задачу SSH версии 0

Копирование файлов или артефактов сборки на удаленный компьютер по протоколу 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.
# 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 , содержащее сведения о подключении для удаленного компьютера.

  • Для создания подключения службы SSH требуются имя узла или IP-адрес удаленного компьютера, номер порта и имя пользователя.
  • Для проверки подлинности необходимо указать закрытый ключ и парольную фразу.

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, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Эта задача выполняется с использованием следующих ограничений команд: restricted
Устанавливаемые переменные Эта задача имеет разрешение на установку следующих переменных: параметр переменных отключен
Версия агента 2.206.1 или более поздней версии
Категория задач Развернуть
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Эта задача выполняется с использованием следующих ограничений команд: restricted
Устанавливаемые переменные Эта задача имеет разрешение на установку следующих переменных: параметр переменных отключен
Версия агента 2.182.1 или более поздней версии
Категория задач Развернуть
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.144.0 или более поздней версии
Категория задач Развернуть
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.102.0 или более поздней версии
Категория задач Развертывание