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.

Insumos

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 os arquivos a serem adicionados ao arquivo. Para pastas, tudo na pasta nomeada é adicionado ao arquivo.

includeRootFolder - Anexar o nome da pasta raiz aos caminhos de arquivo
boolean. Valor padrão: true.

Precede o nome da pasta raiz para caminhos de arquivo no arquivo. Caso contrário, todos os caminhos de arquivo serão iniciados 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 resultante conterá: classes/com/acme/Main.class. Caso contrário, o arquivo resultante conterá: com/acme/Main.class.

archiveType - Tipo de arquivo
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 este formato para todos os tipos compatíveis com zip, como .zip, .jar, .war, .ear
• 7z - formato 7-Zip, (.7z)
• tar - formato tar, uso para tars comprimidos, incluindo .tar.gz, .tar.bz2, .tar.xz
• wim - formato wim, .wim

Exemplo, para criar um arquivo chamado foo.jar:

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

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

Defina o nível de compressão ou None para criar um ficheiro .7z não comprimido.

tarCompression - de compressão de alcatrão
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 .tar não compactado.

• gz - Formato padrão para compressão gzip (.tar.gz, .tar.tgz, .taz)
• bz2 - compressão bzip2 (.tar.bz2, .tz2, .tbz2)
• xz - Compressão XZ (.tar.xz, .txz)

archiveFile - 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: tar
• Definir compressão de alcatrão: gz

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

Por padrão, substitui um arquivo existente. Caso contrário, quando definido como false, os arquivos tar não compactados são adicionados ao arquivo existente.

Formatos de ficheiro suportados que podem ser adicionados a um arquivo existente:

• zip
• 7z
• tar - Apenas sem compressão
• wim

verbose - Force 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 "silenciosa".

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

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

Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Use esta tarefa para criar um arquivo morto a partir de uma pasta de origem. São suportados formatos de arquivo padrão, incluindo .zip, .jar, .war, .ear, .tar, .7z e muito mais.

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Esta tarefa é executada usando as seguintes restrições de comando : restrito
Variáveis configuráveis	Esta tarefa tem permissão para definir as seguintes variáveis: A configuração de variáveis está desativada
Versão do agente	2.182.1 ou superior
Categoria de tarefa	Utilidade