ExtractFiles@1 - Extrair ficheiros v1

Utilize esta tarefa para extrair uma variedade de ficheiros de arquivo e compressã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 - Arquivar padrões de ficheiro
string. Obrigatório. Valor predefinido: **/*.zip.

Especifica os caminhos de ficheiro ou padrões dos ficheiros de arquivo a extrair. Suporta várias linhas de padrões de minimatch. Saiba mais sobre a tarefa Extrair Ficheiros.

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

• test.zip extrai o ficheiro test.zip na pasta raiz.
• test/*.zip extrai todos os .zip ficheiros na pasta de teste.
• **/*.tar extrai todos os ficheiros .tar na pasta raiz e subpastas.
• **/bin/*.7z extrai todos os ficheiros .7z em qualquer subpasta denominada "bin".
  O padrão é utilizado para corresponder apenas a caminhos de ficheiros de arquivo, não caminhos de pastas e não arquivar conteúdos a extrair. Assim, deve especificar padrões, como **/bin/** em vez de **/bin.

destinationFolder - Pasta de destino
string. Obrigatório.

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

cleanDestinationFolder - Limpar pasta de destino antes de extrair
boolean. Valor predefinido: true.

Especifica a opção para limpar o diretório de destino antes de os conteúdos de arquivo serem extraídos para o mesmo.

overwriteExistingFiles - Substituir ficheiros existentes
boolean. Valor predefinido: false.

Especifica a opção para substituir ficheiros existentes no diretório de destino, caso já existam. Se a opção for false, o script pede nos ficheiros existentes, perguntando se pretende substituí-los.

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

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

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para extrair ficheiros de arquivos para uma pasta de destino com padrões de correspondência. É suportada uma gama 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 ficheiros, veja a referência Padrões de correspondência de ficheiros.

Exemplos

Extrair todos os ficheiros .zip de forma recursiva

Este exemplo irá extrair todos os .zip ficheiros de forma recursiva, incluindo ficheiros de raiz e ficheiros de subpastas.

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

Extrair todos os .zip ficheiros da subpasta

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

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

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Esta tarefa é executada com as seguintes restrições de comandos: restritas
Variáveis de tabelas definidas	Esta tarefa tem permissão para definir as seguintes variáveis: A definição de variáveis está desativada
Versão do agente	2.182.1 ou superior
Categoria da tarefa	Utilitário

Ver também

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