Partilhar via


CopyFiles@1 - Tarefa Copiar Arquivos v1

Use esta 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 aos caminhos de arquivo, não aos caminhos de pasta).

Observação

Existe uma versão mais recente desta tarefa disponível em CopyFiles@2.

Sintaxe

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

Insumos

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á os arquivos da pasta raiz do repositório como se $(Build.SourcesDirectory) tivesse sido especificado.

Se sua compilação produz artefatos fora do diretório de códigos-fonte, especifique $(Agent.BuildDirectory) copiar arquivos do diretório criado para o pipeline.


Contents - Conteúdo
string. Obrigatório. Valor padrão: **.

Os caminhos de arquivo a serem incluídos como parte da cópia. Esta cadeia de caracteres suporta 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 caminhos de arquivo, não caminhos de pasta. Especifique padrões, como **\bin\** em vez de **\bin.

Use o separador de caminho que corresponde ao seu tipo de agente de compilação. Por exemplo, / deve ser usado para agentes Linux. Mais exemplos são mostrados abaixo.


TargetFolder - Pasta de destino
string. Obrigatório.

A pasta de destino ou 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 controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Existe uma versão mais recente desta tarefa disponível em CopyFiles@2.

Se nenhum arquivo corresponder, a tarefa ainda relatará o sucesso. Se já existir um arquivo correspondente na pasta de destino, a tarefa relatará falha, a menos que Overwrite esteja definida como true.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Utilidade

Ver também