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, .ear7z
- Formato 7 Zip, (.7z)tar
- formato tar, utilize para alcatrão comprimido, incluindo .tar.gz, .tar.bz2, .tar.xzwim
- 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
, , maximum
normal
, 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
, , maximum
normal
, 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 descomprimidowim
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 |