FtpUpload@1 — задача отправки по FTP версии 1

Используйте эту задачу для отправки файлов на удаленный компьютер с помощью FTP или безопасной передачи файлов с помощью FTPS.

Синтаксис

# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
# FTP Upload v1
# FTP Upload.
- task: FtpUpload@1
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

Входные данные

credentialsOption - Метод проверки подлинности
Входной псевдоним: credsType. string. Обязательный. Допустимые значения: serviceEndpoint (подключение к службе FTP), inputs (введите учетные данные). Значение по умолчанию: serviceEndpoint.

Указывает метод проверки подлинности. Используйте подключение службы FTP или введите учетные данные подключения.


serverEndpoint - Подключение службы FTP
string. Требуется, если credsType = serviceEndpoint.

Указывает подключение службы для FTP-сервера. Чтобы создать его, щелкните ссылку Управление и создайте новое подключение универсальной службы, а затем введите URL-адрес FTP-сервера для URL-адреса сервера, например ftp://server.example.com, и необходимые учетные данные.

Безопасные подключения всегда будут устанавливаться независимо от указанного протокола (ftp:// или ftps://), если целевой сервер поддерживает FTPS. Чтобы разрешить только безопасные подключения, используйте ftps:// протокол, например ftps://server.example.com. Connections к серверам, не поддерживающим FTPS, если ftps:// указан параметр .


serverUrl - URL-адрес сервера
string. Требуется, если credsType = inputs.

Указывает URL-адрес FTP-сервера.


username - Пользователя
string. Требуется, если credsType = inputs.

Указывает имя пользователя для FTP-подключения.


password - Пароль
string. Требуется, если credsType = inputs.

Указывает пароль для FTP-подключения.


rootDirectory - Корневая папка
Входной псевдоним: rootFolder. string. Обязательный.

Указывает исходную папку для отправки файлов.


filePatterns - Шаблоны файлов
string. Обязательный. Значение по умолчанию: **.

Указывает пути к файлам или шаблоны файлов для отправки. Строка поддерживает несколько строк шаблонов мини-сопоставления. Дополнительные сведения о шаблонах сопоставления файлов.


remoteDirectory - Удаленный каталог
Входной псевдоним: remotePath. string. Обязательный. Значение по умолчанию: /upload/$(Build.BuildId)/.

Указывает каталог на удаленном FTP-сервере, куда задача отправляет файлы.


clean - Удаление удаленного каталога
boolean. Значение по умолчанию: false.

Удаляет удаленный каталог, включая его содержимое, перед отправкой.


cleanContents - Очистка содержимого удаленного каталога
boolean. Необязательный элемент. Используйте при clean = false. Значение по умолчанию: false.

Рекурсивно удаляет все содержимое в удаленном каталоге перед отправкой. Существующий каталог не будет удален. Для повышения производительности используйте clean вместо него .


overwrite - Перезаписать
boolean. Значение по умолчанию: true.

Перезаписывает существующие файлы в удаленном каталоге.


preservePaths - Сохранение путей к файлам
boolean. Значение по умолчанию: false.

Если этот параметр выбран, относительная локальная структура каталогов воссоздается в удаленном каталоге, куда отправляются файлы. В противном случае файлы отправляются непосредственно в удаленный каталог без создания дополнительных подкаталогов.

Например, предположим, что исходная папка — /home/user/source/, которая содержит файл foo/bar/foobar.txt, а удаленный каталог — . /uploads/ Если выбран этот логический параметр, файл отправляется в /uploads/foo/bar/foobar.txt. Если этот логический параметр не выбран, файл отправляется в /uploads/foobar.txt.


trustSSL - Сертификат сервера доверия
boolean. Значение по умолчанию: false.

Доверяет SSL-сертификату FTP-сервера с ftps://, даже если он самозаверяющий или не может быть проверен центром сертификации (ЦС).


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Используйте эту задачу для отправки файлов на удаленный компьютер с помощью FTP или безопасной передачи файлов с помощью FTPS.

Примечание

На FtpUpload@2 доступна более новая версия этой задачи.

Где можно узнать больше о шаблонах сопоставления файлов?

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Эта задача выполняется с использованием следующих ограничений команд: restricted
Устанавливаемые переменные Эта задача имеет разрешение на установку следующих переменных: параметр переменных отключен
Версия агента 2.182.1 или более поздней версии
Категория задач Служебная программа
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента Все поддерживаемые версии агента.
Категория задач Служебная программа