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 | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | Все поддерживаемые версии агента. |
Категория задач | Служебная программа |