CopyFiles@1 – Tarefa Copiar Arquivos v1
Use essa tarefa para copiar arquivos de uma pasta de origem para uma pasta de destino usando padrões de correspondência. (Os padrões de correspondência corresponderão apenas a caminhos de arquivo, não a caminhos de pasta).
Observação
Há uma versão mais recente dessa tarefa disponível em CopyFiles@2.
Syntax
# 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.
Entradas
SourceFolder
- Pasta de Origem
string
.
Opcional. A pasta que contém os arquivos que você deseja copiar. Se a pasta estiver vazia, a tarefa copiará arquivos da pasta raiz do repositório como se tivesse $(Build.SourcesDirectory)
sido especificado.
Se o build produzir artefatos fora do diretório de fontes, especifique $(Agent.BuildDirectory)
para copiar arquivos do diretório criado para o pipeline.
Contents
- Conteúdo
string
. Obrigatórios. Valor padrão: **
.
Os caminhos de arquivo a serem incluídos como parte da cópia. Essa cadeia de caracteres dá suporte a várias linhas de padrões de correspondência.
Por exemplo:
*
copia todos os arquivos na pasta de origem especificada.**
copia todos os arquivos na pasta de origem especificada e todos os arquivos em todas as subpastas.**\bin\**
copia todos os arquivos recursivamente de qualquer pasta bin.
O padrão é usado para corresponder apenas a caminhos de arquivo, não a caminhos de pasta. Especifique padrões, como **\bin\**
em vez de **\bin
.
Use o separador de caminho que corresponde ao tipo de agente de build. Por exemplo, /
deve ser usado para agentes do Linux. Mais exemplos são mostrados abaixo.
TargetFolder
- Pasta de Destino
string
. Obrigatórios.
A pasta de destino ou o caminho UNC que conterá os arquivos copiados. Você pode usar variáveis. Exemplo: $(build.artifactstagingdirectory)
.
CleanTargetFolder
- Limpar Pasta de Destino
boolean
. Valor padrão: false
.
Opcional. Exclui todos os arquivos existentes na pasta de destino antes do processo de cópia.
OverWrite
- Substituir
boolean
. Valor padrão: false
.
Opcional. Substitui os arquivos existentes na pasta de destino.
flattenFolders
- Nivelar Pastas
boolean
. Valor padrão: false
.
Opcional. Nivela a estrutura de pastas e copia todos os arquivos para a pasta de destino especificada.
Opções de controle da tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Comentários
Há uma versão mais recente dessa tarefa disponível em CopyFiles@2.
Se nenhum arquivo corresponder, a tarefa ainda relatará êxito. Se um arquivo correspondente já existir na pasta de destino, a tarefa relatará uma falha, a menos que Overwrite
esteja definida como true.
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | YAML, build clássico |
Executa em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | 1.91.0 ou superior |
Categoria da tarefa | Utilitário |