CopyFiles@1 — задача копирования файлов версии 1
Используйте эту задачу для копирования файлов из исходной папки в целевую папку с помощью шаблонов соответствия. (Шаблоны соответствия будут соответствовать только путям к файлам, но не к папкам).
Примечание
На CopyFiles@2 доступна более новая версия этой задачи.
Синтаксис
# Copy Files v1
# Copy files from source folder to target folder using minimatch patterns (The minimatch patterns will only match file paths, not folder paths).
- task: CopyFiles@1
inputs:
#SourceFolder: # string. Source Folder.
Contents: '**' # string. Required. Contents. Default: **.
TargetFolder: # string. Required. Target Folder.
# Advanced
#CleanTargetFolder: false # boolean. Clean Target Folder. Default: false.
#OverWrite: false # boolean. Overwrite. Default: false.
#flattenFolders: false # boolean. Flatten Folders. Default: false.
Входные данные
SourceFolder
- Исходная папка
string
.
Необязательный элемент. Папка, содержащая файлы, которые нужно скопировать. Если папка пуста, задача копирует файлы из корневой папки репозитория так, как будто $(Build.SourcesDirectory)
она была указана.
Если сборка создает артефакты за пределами исходного каталога, укажите $(Agent.BuildDirectory)
для копирования файлов из каталога, созданного для конвейера.
Contents
- Содержимое
string
. Обязательный. Значение по умолчанию: **
.
Пути к файлам, включаемые в копию. Эта строка поддерживает несколько строк шаблонов соответствия.
Пример:
*
копирует все файлы в указанной исходной папке.**
копирует все файлы в указанной исходной папке и все файлы во всех вложенных папках.**\bin\**
рекурсивно копирует все файлы из любой папки bin.
Шаблон используется для сопоставления только путей к файлам, а не путей к папкам. Укажите шаблоны, например , вместо **\bin\**
**\bin
.
Используйте разделитель пути, соответствующий типу агента сборки. Например, /
должен использоваться для агентов Linux. Ниже приведены дополнительные примеры.
TargetFolder
- Целевая папка
string
. Обязательный.
Целевая папка или UNC-путь, который будет содержать скопированные файлы. Можно использовать переменные. Например, $(build.artifactstagingdirectory)
.
CleanTargetFolder
- Очистка целевой папки
boolean
. Значение по умолчанию: false
.
Необязательный элемент. Удаляет все существующие файлы в целевой папке перед процессом копирования.
OverWrite
- Перезаписать
boolean
. Значение по умолчанию: false
.
Необязательный элемент. Заменяет существующие файлы в целевой папке.
flattenFolders
- Плоские папки
boolean
. Значение по умолчанию: false
.
Необязательный элемент. Преобразует структуру папок в плоскую структуру и копирует все файлы в указанную целевую папку.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.
Выходные переменные
Нет.
Remarks
На CopyFiles@2 доступна более новая версия этой задачи.
Если файлы не совпадают, задача по-прежнему будет сообщать об успешном выполнении. Если соответствующий файл уже существует в целевой папке, задача сообщит о сбое, если Overwrite
для параметра не задано значение true.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
Требования | Нет |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | 1.91.0 или более поздней версии |
Категория задач | Служебная программа |