Partilhar via


ArchiveFiles@2 - Arquivar tarefa de ficheiros v2

Arquivar ficheiros com formatos de compressão como .7z, .tar, .gz e .zip.

Arquivar ficheiros com formatos de compressão, como .7z, .rar, .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.
# 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: '5' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: 5.
    #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.
# 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.
    #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.
# Archive Files v2
# Archive files using compression formats such as .7z, .rar, .tar.gz, and .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.
    #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.

Entradas

rootFolderOrFile - Pasta raiz ou ficheiro a arquivar
string. Obrigatório. Valor predefinido: $(Build.BinariesDirectory).

Nome da pasta raiz ou do caminho do ficheiro para os ficheiros a adicionar ao arquivo. Para pastas, tudo na pasta com nome é adicionado ao arquivo.


includeRootFolder - Nome da pasta raiz de pré-final para arquivar caminhos
boolean. Valor predefinido: true.

Prepara o nome da pasta raiz para caminhos de ficheiro no arquivo. Caso contrário, todos os caminhos de ficheiro começarão um nível mais baixo.

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


archiveType - Tipo de arquivo
string. Obrigatório. Valores permitidos: zip, 7z, tar, wim. Valor predefinido: zip.

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

  • zip - Predefiniçã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, utilize para alcatrão comprimido, incluindo .tar.gz, .tar.bz2, .tar.xz
  • wim - formato wim, .wim

Exemplo, para criar um arquivo com o nome foo.jar:

  • Selecionar formato de compressão zip
  • Especifique o nome do ficheiro de arquivo a criar: foo.jar

sevenZipCompression - Compressão de 7z
string. Opcional. Utilize quando archiveType = 7z. Valores permitidos: ultra, , maximumnormal, fast, fastest, none. Valor predefinido: normal.

Defina o nível de compressão ou None crie um ficheiro .7z descomprimido.


sevenZipCompression - Compressão de 7z
string. Opcional. Utilize quando archiveType = 7z. Valores permitidos: ultra, , maximumnormal, fast, fastest, none. Valor predefinido: 5.

Defina um formato de compressão ou None crie um ficheiro .7z descomprimido.


tarCompression - Compressão de alcatrão
string. Opcional. Utilize quando archiveType = tar. Valores permitidos: gz, bz2, xz, none. Valor predefinido: gz.

Defina um formato de compressão ou opte por None criar um ficheiro .tar descomprimido.

  • gz - Formato predefinido 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 - Arquivar ficheiro a criar
string. Obrigatório. Valor predefinido: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Especifique o nome do ficheiro de arquivo a criar. Por exemplo, para criar foo.tgz:

  • Definir tipo de arquivo: tar
  • Definir compressão de alcatrão: gz

replaceExistingArchive - Substituir arquivo existente
boolean. Valor predefinido: true.

Por predefinição, substitui um arquivo existente. Caso contrário, quando definido como false, os ficheiros tar descomprimidos são adicionados ao arquivo existente.

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

  • zip
  • 7z
  • tar - Apenas descomprimido
  • wim

verbose - Forçar saída verbosa
boolean. Valor predefinido: false.

Se estiver definido como verdadeiro, força as ferramentas a utilizar a saída verbosa. Substitui a definição "quiet".


quiet - Forçar saída silenciosa
boolean. Valor predefinido: false.

Se estiver definido como true, força as ferramentas a utilizar a saída silenciosa. A verbose definição (ou equivalente) pode substituir esta definição.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das respetivas 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 criar um ficheiro de arquivo a partir de uma pasta de origem. Os formatos de arquivo padrão são suportados, incluindo .zip, .jar, .war, .ear, .tar, .7z e muito mais.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, 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 comando: restritas
Variáveis de definição 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
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 Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Utilitário