ExtractFiles@1 – Tarefa Extrair arquivos v1

Use essa tarefa para extrair uma variedade de arquivos e arquivos de compactação, como .7z, .rar, .tar.gz e .zip.

Syntax

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Entradas

archiveFilePatterns - Padrões de arquivo morto
string. Obrigatórios. Valor padrão: **/*.zip.

Especifica os caminhos ou padrões de arquivo dos arquivos a serem extraídos. Dá suporte a várias linhas de padrões de minimatch. Saiba mais sobre a tarefa Extrair Arquivos.

Especifica os padrões para corresponder aos arquivos que você deseja extrair. Por padrão, os padrões começam na pasta raiz do repositório (como se você tivesse especificado $(Build.SourcesDirectory).
Especifica os filtros de padrão, um por linha, que correspondem aos arquivos a serem extraídos. Por exemplo:

• test.zip extrai o arquivo test.zip na pasta raiz.
• test/*.zip extrai todos os arquivos .zip na pasta de teste.
• **/*.tar extrai todos os arquivos .tar na pasta raiz e subpastas.
• **/bin/*.7z extrai todos os arquivos .7z em qualquer subpasta chamada "bin".
  O padrão é usado para corresponder apenas a caminhos de arquivo morto, não a caminhos de pasta e não a conteúdo de arquivo a ser extraído. Portanto, você deve especificar padrões, como **/bin/** em vez de **/bin.

destinationFolder - Pasta de destino
string. Obrigatórios.

Especifica a pasta de destino na qual os arquivos de arquivo morto devem ser extraídos. Use variáveis se os arquivos não estiverem no repositório. Por exemplo: $(agent.builddirectory).

cleanDestinationFolder - Limpar pasta de destino antes de extrair
boolean. Valor padrão: true.

Especifica a opção de limpar o diretório de destino antes que o conteúdo do arquivo seja extraído nele.

overwriteExistingFiles - Substituir arquivos existentes
boolean. Valor padrão: false.

Especifica a opção de substituir arquivos existentes no diretório de destino se eles já existirem. Se a opção for false, o script solicitará arquivos existentes, perguntando se você deseja substituí-los.

pathToSevenZipTool - Caminho para o utilitário de 7z
string.

Especifica o caminho personalizado para o utilitário de 7z. Por exemplo, C:\7z\7z.exe no Windows e /usr/local/bin/7z no MacOS/Ubuntu. Se não for especificado no Windows, a versão padrão do 7zip fornecida com uma tarefa será usada.

Opções de controle de 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

Use essa tarefa para extrair arquivos de arquivos para uma pasta de destino usando padrões de correspondência. Há suporte para uma variedade de formatos de arquivo padrão, incluindo .zip, .jar, .war, .ear, .tar, .7z e muito mais.

Para obter mais informações sobre padrões de correspondência de arquivos, consulte a Referência de padrões de correspondência de arquivo.

Exemplos

Extrair todos os arquivos .zip recursivamente

Este exemplo extrairá todos os arquivos .zip recursivamente, incluindo arquivos raiz e arquivos de subpastas.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Extrair todos os arquivos .zip da subpasta

Este exemplo extrairá test/one.zip e test/two.zip, mas deixará test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Essa tarefa é executada usando as seguintes restrições de comando: restrito
Variáveis configuráveis	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 da tarefa	Utilitário

Confira também

• Referência de padrões de correspondência de arquivos