Compartilhar via

CopyFiles@2 – Tarefa Copiar arquivos v2

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

Sintaxe

# Copy files v2
# Copy files from a source folder to a target folder using patterns matching file paths (not folder paths).
- task: CopyFiles@2
  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.
    #preserveTimestamp: false # boolean. Preserve Target Timestamp. Default: false.
    #retryCount: '0' # string. Retry count to copy the file. Default: 0.
    #delayBetweenRetries: '1000' # string. Delay between two retries. Default: 1000.
    #ignoreMakeDirErrors: false # boolean. Ignore errors during creation of target folder. Default: false.

# Copy files v2
# Copy files from a source folder to a target folder using patterns matching file paths (not folder paths).
- task: CopyFiles@2
  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.
    #preserveTimestamp: false # boolean. Preserve Target Timestamp. Default: false.

Entradas

da Pasta de Origem do SourceFolder -
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 $(Build.SourcesDirectory) tivesse 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ório 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.

Encapsular caracteres especiais em [] pode ser usado para escapar de caracteres glob literais em um nome de arquivo. Por exemplo, o nome do arquivo literal hello[a-z] pode ser escapado como hello[[]a-z]. Para obter mais informações, consulte Referência de padrões de correspondência de arquivo.

Use o separador de caminho que corresponde ao tipo de agente de build. Por exemplo, / devem ser usados para agentes linux. Mais exemplos são mostrados abaixo.


TargetFolder - pasta de destino
string. Obrigatório

A pasta de destino ou o caminho UNC que conterá os arquivos copiados. Você pode usar variáveis . Exemplo: $(build.artifactstagingdirectory).


CleanTargetFolder - de Pasta de Destino Limpo
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 - pastas de nivelamento
boolean. Valor padrão: false.

Opcional. Nivela a estrutura da pasta e copia todos os arquivos para a pasta de destino especificada.


preserveTimestamp - Preservar carimbo de data/hora de destino
boolean. Valor padrão: false.

Preserva o carimbo de data/hora do arquivo de destino usando o arquivo de origem original.


retryCount - Repetir contagem para copiar o arquivo
string. Valor padrão: 0.

Especifica a contagem de novas tentativas para copiar o arquivo. Essa string é útil para problemas intermitentes, como caminhos de destino UNC em um host remoto.


delayBetweenRetries - Atraso entre duas tentativas.
string. Valor padrão: 1000.

Especifica o atraso entre duas tentativas. Essa string é útil para problemas intermitentes, como caminhos de destino UNC em um host remoto.


ignoreMakeDirErrors - Ignore erros durante a criação da pasta de destino.
boolean. Valor padrão: false.

Ignora erros que ocorrem durante a criação da pasta de destino. Essa cadeia de caracteres é útil para evitar problemas com a execução paralela de tarefas por vários agentes em uma pasta de destino.


Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

Se nenhum arquivo corresponder, a tarefa ainda relatará êxito.

  • Se Overwrite for false e um arquivo correspondente já existir na pasta de destino, a tarefa não relatará falha, mas registrará que o arquivo já existe e o ignorará.
  • Se Overwrite for true e um arquivo correspondente já existir na pasta de destino, o arquivo correspondente será substituído.

Exemplos

Copie o arquivo para o diretório de preparação de artefatos e publique

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Copiar executáveis e um arquivo leiame

Objetivo

Você deseja copiar apenas o leiame e os arquivos necessários para executar este aplicativo de console C#:

`-- ConsoleApplication1
    |-- ConsoleApplication1.sln
    |-- readme.txt
    `-- ClassLibrary1
        |-- ClassLibrary1.csproj
    `-- ClassLibrary2
        |-- ClassLibrary2.csproj
    `-- ConsoleApplication1
        |-- ConsoleApplication1.csproj

Observação

ConsoleApplication1.sln contém uma pasta bin com arquivos .dll e .exe, veja os resultados abaixo para ver o que é movido!

Na guia Variáveis, $(BuildConfiguration) é definido como release.

Exemplo com vários padrões de correspondência:

steps:
- task: CopyFiles@2
  displayName: 'Copy Files to: $(Build.ArtifactStagingDirectory)'
  inputs:
    Contents: |
      ConsoleApplication1\ConsoleApplication1\bin\**\*.exe
      ConsoleApplication1\ConsoleApplication1\bin\**\*.dll
      ConsoleApplication1\readme.txt
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

Exemplo com condição OR:

steps:
- task: CopyFiles@2
  displayName: 'Copy Files to: $(Build.ArtifactStagingDirectory)'
  inputs:
    Contents: |
      ConsoleApplication1\ConsoleApplication1\bin\**\?(*.exe|*.dll)
      ConsoleApplication1\readme.txt
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

Exemplo com condição NOT:

steps:
- task: CopyFiles@2
  displayName: 'Copy Files to: $(Build.ArtifactStagingDirectory)'
  inputs:
    Contents: |
      ConsoleApplication1\**\bin\**\!(*.pdb|*.config)
      !ConsoleApplication1\**\ClassLibrary*\**
      ConsoleApplication1\readme.txt
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

Exemplo com variáveis na seção de conteúdo

- task: CopyFiles@2
  inputs:
    Contents: '$(Build.Repository.LocalPath)/**' 
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

Resultados

Esses arquivos são copiados para o diretório de teste:

`-- ConsoleApplication1
    |-- readme.txt
    `-- ConsoleApplication1
        `-- bin
            `-- Release
                | -- ClassLibrary1.dll
                | -- ClassLibrary2.dll
                | -- ConsoleApplication1.exe

Copie tudo do diretório de origem, exceto a pasta .git

Exemplo com vários padrões de correspondência:

steps:
- task: CopyFiles@2
  displayName: 'Copy Files to: $(Build.ArtifactStagingDirectory)'
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)'
    Contents: |
      **/*
      !.git/**/*
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
Execuções em Agente, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Esta tarefa é executada usando as seguintes restrições de comando : restrito
variáveis settable Essa tarefa tem permissão para definir as seguintes variáveis: a configuração de variáveis está desabilitada
Versão do agente 2.182.1 ou superior
Categoria de tarefa Utilidade
Requisito Descrição
Tipos de pipeline YAML, build clássico
Execuções em Agente, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 1.91.0 ou superior
Categoria de tarefa Utilidade

Consulte também