ArchiveFiles@2 – Tarefa Arquivar arquivos v2

Arquive arquivos usando formatos de compactação como .7z, .tar, .gz e .zip.

Syntax

# Archive files v2
# Compress files into .7z, .tar.gz, or .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #sevenZipCompression: 'normal' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: normal.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.
    #verbose: false # boolean. Force verbose output. Default: false.
    #quiet: false # boolean. Force quiet output. Default: false.

Entradas

rootFolderOrFile - Pasta raiz ou arquivo a ser arquivado
string. Obrigatórios. Valor padrão: $(Build.BinariesDirectory).

Nome da pasta raiz ou o caminho do arquivo para os arquivos a serem adicionados ao arquivo morto. Para pastas, tudo na pasta nomeada é adicionado ao arquivo morto.

includeRootFolder - Prefixar o nome da pasta raiz para caminhos de arquivo morto
boolean. Valor padrão: true.

Anexa o nome da pasta raiz aos caminhos de arquivo no arquivo morto. Caso contrário, todos os caminhos de arquivo iniciarão um nível mais baixo.

Por exemplo, se a pasta raiz for: /home/user/output/classes/ e o caminho do arquivo: com/acme/Main.class. O arquivo morto resultante conterá: classes/com/acme/Main.class. Caso contrário, o arquivo morto resultante conterá: com/acme/Main.class.

archiveType - Tipo de arquivo morto
string. Obrigatórios. Valores permitidos: zip, 7z, tar, wim. Valor padrão: zip.

Especifica um formato de compactação. Os formatos válidos incluem:

• zip -Padrão. Escolha esse formato para todos os tipos compatíveis com zip, como .zip, .jar, .war, .ear
• 7z - Formato 7-Zip, (.7z)
• tar - formato tar, use para tars compactados, incluindo .tar.gz, .tar.bz2, .tar.xz
• wim – formato wim, .wim

Por exemplo, para criar um arquivo chamado foo.jar:

• Selecionar formato de compactação zip
• Especifique o nome do arquivo morto a ser criado: foo.jar

sevenZipCompression - Compactação de 7z
string. Opcional. Use quando archiveType = 7z. Valores permitidos: ultra, maximum, normal, fast, fastest, none. Valor padrão: normal.

Defina o nível de compactação ou None para criar um arquivo .7z descompactado.

tarCompression - Compactação tar
string. Opcional. Use quando archiveType = tar. Valores permitidos: gz, bz2, xz, none. Valor padrão: gz.

Defina um formato de compactação ou escolha None criar um arquivo .tar descompactado.

• gz – Formato padrão para compactação gzip (.tar.gz, .tar.tgz, .taz)
• bz2 - compactação bzip2 (.tar.bz2, .tz2, .tbz2)
• xz - compactação xz (.tar.xz, .txz)

archiveFile - Arquivo morto a ser criado
string. Obrigatórios. Valor padrão: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Especifique o nome do arquivo morto a ser criado. Por exemplo, para criar foo.tgz:

• Definir tipo de arquivo morto: tar
• Definir compactação tar: gz

replaceExistingArchive - Substituir arquivo morto existente
boolean. Valor padrão: true.

Por padrão, substitui um arquivo morto existente. Caso contrário, quando definido falsecomo , arquivos tar descompactados são adicionados ao arquivo morto existente.

Formatos de arquivo com suporte que podem ser adicionados a um arquivo morto existente:

• zip
• 7z
• tar - Somente descompactado
• wim

verbose - Forçar saída detalhada
boolean. Valor padrão: false.

Se definido como true, força as ferramentas a usar a saída detalhada. Substitui a configuração "silenciosa".

quiet - Forçar saída silenciosa
boolean. Valor padrão: false.

Se definido como true, força as ferramentas a usar a saída silenciosa. A verbose configuração (ou equivalente) pode substituir essa configuração.

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 criar um arquivo morto de uma pasta de origem. Há suporte para formatos de arquivo padrão, incluindo .zip, .jar, .war, .ear, .tar, .7z e muito mais.

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