CopyFiles@1 — kopiowanie plików w wersji 1
To zadanie służy do kopiowania plików z folderu źródłowego do folderu docelowego przy użyciu wzorców dopasowania. (Wzorce dopasowania będą zgodne tylko ze ścieżkami plików, a nie ścieżkami folderów).
Uwaga
W CopyFiles@2 jest dostępna nowsza wersja tego zadania.
Składnia
# 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.
Dane wejściowe
SourceFolder
- Folder źródłowy
string
.
Opcjonalny. Folder zawierający pliki, które chcesz skopiować. Jeśli folder jest pusty, zadanie kopiuje pliki z folderu głównego repozytorium tak, jakby $(Build.SourcesDirectory)
zostało określone.
Jeśli kompilacja tworzy artefakty poza katalogiem źródeł, określ $(Agent.BuildDirectory)
, aby skopiować pliki z katalogu utworzonego dla potoku.
Contents
- Zawartość
string
. Wymagane. Wartość domyślna: **
.
Ścieżki plików do uwzględnienia w ramach kopii. Ten ciąg obsługuje wiele wierszy wzorców dopasowania.
Na przykład:
*
kopiuje wszystkie pliki w określonym folderze źródłowym.**
kopiuje wszystkie pliki w określonym folderze źródłowym i wszystkie pliki we wszystkich podfolderach.**\bin\**
kopiuje wszystkie pliki cyklicznie z dowolnego folderu bin.
Wzorzec służy do dopasowywania tylko ścieżek plików, a nie ścieżek folderów. Określ wzorce, takie jak **\bin\**
zamiast **\bin
.
Użyj separatora ścieżki zgodnego z typem agenta kompilacji. Na przykład /
należy użyć dla agentów systemu Linux. Poniżej przedstawiono więcej przykładów.
TargetFolder
- Folder docelowy
string
. Wymagane.
Folder docelowy lub ścieżka UNC, która będzie zawierać skopiowane pliki. Możesz użyć zmiennych. Przykład: $(build.artifactstagingdirectory)
.
CleanTargetFolder
- Wyczyść folder docelowy
boolean
. Wartość domyślna: false
.
Opcjonalny. Usuwa wszystkie istniejące pliki w folderze docelowym przed procesem kopiowania.
OverWrite
- Zastąpić
boolean
. Wartość domyślna: false
.
Opcjonalny. Zastępuje istniejące pliki w folderze docelowym.
flattenFolders
- Spłaszczać foldery
boolean
. Wartość domyślna: false
.
Opcjonalny. Spłaszcza strukturę folderów i kopiuje wszystkie pliki do określonego folderu docelowego.
Opcje sterowania zadania
Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.
Zmienne wyjściowe
Brak.
Uwagi
W CopyFiles@2 jest dostępna nowsza wersja tego zadania.
Jeśli żadne pliki nie są zgodne, zadanie będzie nadal zgłaszać powodzenie. Jeśli pasowany plik już istnieje w folderze docelowym, zadanie zgłosi niepowodzenie, chyba że Overwrite
ustawiono wartość true.
Wymagania
Wymaganie | Opis |
---|---|
Typy potoków | YAML, kompilacja klasyczna |
Działa na | Agent, DeploymentGroup |
Wymagania | Brak |
Możliwości | To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu. |
Ograniczenia poleceń | Dowolne |
Zmienne w formie tabeli settable | Dowolne |
Wersja agenta | 1.91.0 lub nowszy |
Kategoria zadania | Narzędzie |