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

Статья
03/24/2025

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

Эта версия задачи устарела; используйте FtpUpload@2.

Синтаксис

# 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.

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

Метод проверки подлинности 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. При указании ftps:// подключения к серверам, не поддерживающим FTPS.

URL-адрес сервера serverUrl -
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://, даже если он самозаверяющий или не может быть проверен центром сертификации (ЦС).

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

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

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

Нет.

Замечания

Примечание.

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

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

Справочник по шаблонам сопоставления файлов

Требования

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

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Полезность

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