ArchiveFiles@2 – Arquivar arquivos v2 tarefa

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

Sintaxe

# 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 para arquivar
string. Obrigatório Valor padrão: $(Build.BinariesDirectory).

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

includeRootFolder - nome da pasta raiz prepend para arquivar caminhos
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 inferior.

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

do tipo Arquivo archiveType -
string. Obrigatório 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 de 7 zips (.7z)
• tar - formato tar, uso para piches compactados, incluindo .tar.gz, .tar.bz2, .tar.xz
• wim – formato wim, .wim

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

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

sevenZipCompression - de 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 de .7z não compactado.

de compactação de tar tarCompression -
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 para criar um arquivo de .tar não compactado.

• 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 de arquivo para criar
string. Obrigatório 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 de piche: gz

replaceExistingArchive - Substituir de arquivos existentes
boolean. Valor padrão: true.

Por padrão, substitui um arquivo morto existente. Caso contrário, quando definido como false, 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 de 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 'quiet'.

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

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

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

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
Execuções em	Agent, 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